cloudflare-tunnel — скилл для Claude Code: доступ к закрытым сервисам
Скилл показывает агенту, как ходить в сервисы за Cloudflare Access через service token: заголовки, curl-запросы, разбор ошибок 403 и 401.
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a claude-codeЧто делает cloudflare-tunnel
Скилл нужен, когда сервис закрыт политикой Cloudflare Access, а обратиться к нему надо из терминала. Агент получает готовые шаблоны curl с двумя заголовками: CF-Access-Client-Id и CF-Access-Client-Secret. Значение Client ID заканчивается на .access.
Внутри — рецепты под частые случаи: GET, POST с JSON-телом из /tmp/request.json, скачивание файла в /tmp/output.file, базовая авторизация через -u и дополнительный Authorization: Bearer. Отдельный раздел разбирает ошибки: 403 при неверных заголовках или токене вне Access-политики, 401 от собственной авторизации сервиса, connection refused при незапущенном cloudflared.
Нужны service token из Zero Trust и сам cloudflared на машине. Флаг -k отключает проверку сертификата — годится для self-signed, но с ним любой посредник в канале останется незамеченным, так что в бою лучше починить сертификат.
Какие задачи решает
- обратиться к API за Cloudflare Access из
curl - собрать POST-запрос с JSON-телом к защищённому сервису
- скачать файл с домена, закрытого Access-политикой
- совместить service token Cloudflare с Bearer-токеном сервиса
- понять, почему приходит 403 или 401
Примеры запросов агенту
- Сходи к
https://your-protected-service.example.com/api/endpointчерез Cloudflare Access и покажи ответ - Сделай POST с телом из
/tmp/request.jsonна защищённый эндпоинт - Приходит 403 при запросе к сервису за Cloudflare — разбери причину
Как установить cloudflare-tunnel
1Через Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a claude-code2Вручную: положить файлы
~/.claude/skills/cloudflare-tunnel/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cloudflare-tunnel/
1Через Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a codex2Вручную: положить файлы
.agents/skills/cloudflare-tunnel/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a cursor2Вручную: положить файлы
.cursor/skills/cloudflare-tunnel/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install okou-ai/okou-skills cloudflare-tunnel2Вручную: положить файлы
.github/skills/cloudflare-tunnel/SKILL.md1Через Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a gemini-cli2Командой платформы
gemini skills install https://github.com/okou-ai/okou-skills --path cloudflare-tunnelВручную: положить файлы
.devin/skills/cloudflare-tunnel/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cloudflare-tunnel
Как установить cloudflare-tunnel в Claude Code?
Выполните npx skills add okou-ai/okou-skills --skill cloudflare-tunnel -a claude-code. Скилл окажется в ~/.claude/skills/cloudflare-tunnel/SKILL.md.
Что делает cloudflare-tunnel?
Даёт агенту шаблоны запросов к сервисам, закрытым Cloudflare Access, и таблицу типовых ошибок с причинами.
Что нужно, чтобы скилл сработал?
Service token Cloudflare (Client ID и Secret) и запущенный cloudflared — без него туннель не поднимется и запрос упрётся в connection refused.
