← Настройка агентов / agent-setup
Claude Code + Cloudflare
Терминальный агент для написания кода, который понимает вашу кодовую базу, выполняет команды, редактирует файлы и управляет git. Разработан компанией Anthropic.
быстрый старт
-
Установите Claude Code
Установите Claude Code CLI. Варианты для Windows, Homebrew, WinGet или npm см. в разделе Руководство по настройке Claude Code ↗.
curl -fsSL https://claude.ai/install.sh | bash -
Запустите Claude Code в своём проекте
Запустите Claude Code из корня своего проекта, где
wrangler.jsoncнаходится (если он уже существует).claude -
Установите плагин Cloudflare
В Claude Code выполните эти две слэш-команды. Это установит Cloudflare Skills и зарегистрирует MCP-серверы Cloudflare.
/plugin marketplace add cloudflare/skills /plugin install cloudflare@cloudflare -
Попробовать промпт
Например:
Set up AI Gateway to route requests across OpenAI and Workers AI with automatic fallback and cost tracking.
Доступ к платформе Cloudflare
Разверните любой раздел, чтобы узнать больше.
Cloudflare Skills
Постоянный контекст платформы, который объясняет агенту, как работает Cloudflare.
Skills: инструкции, которые агент загружает по требованию. См. cloudflare/skills пакет охватывает все уровни платформы, поэтому агент знает ваши соглашения и вам не нужно объяснять их заново.
- agents-sdkСоздавайте ИИ-агентов на Cloudflare Workers с помощью Agents SDK. Загружайте этот навык при создании агентов с состоянием, устойчивых Workflows, приложений на WebSocket в реальном времени, отложенных задач, MCP-серверов, чат-приложений, голосовых агентов или автоматизации браузера. Охватывает класс Agent, управление состоянием, вызываемый RPC, Workflows, устойчивое выполнение, очереди, повторные попытки, observability и React hooks. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
- cloudflareКомплексный навык по платформе Cloudflare, охватывающий Workers, Pages, хранилища (KV, D1, R2), ИИ (Workers AI, Vectorize, Agents SDK), функциональные флаги (Flagship), сети (Tunnel, Spectrum), безопасность (WAF, DDoS) и инфраструктуру как код (Terraform, Pulumi). Используйте для любых задач разработки на Cloudflare. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
- cloudflare-email-serviceОтправка и получение транзакционных писем через Cloudflare Email Service (Email Sending + Email Routing). Используйте при реализации отправки почты (binding Workers или REST API), маршрутизации почты, обработки почты в Agents SDK либо интеграции почты в любое приложение: Workers, Node.js, Python, Go и т. д. Также используйте для вопросов доставляемости почты, SPF/DKIM/DMARC, настройки wrangler для почты, MCP инструментов для почты или когда агенту для написания кода нужно отправить письмо. Даже для простых запросов вроде «добавь почту в мой Worker» этот skill содержит важные детали настройки.
- cloudflare-one"Помогает в работе с Cloudflare One Zero Trust и SASE в Access, Gateway, WARP, Tunnel, Cloudflare WAN, DLP, CASB, device posture и identity. Используйте при проектировании, настройке, устранении неполадок или проверке развёртываний Cloudflare One. Приоритет на актуальные данные: используйте текущую документацию Cloudflare и схемы API вместо встроенной документации по продуктам."
- cloudflare-one-migrationsПланирует миграцию с Zscaler ZIA/ZPA, Palo Alto, устаревших VPN, SWG или SASE стеков на Cloudflare One. Используется для оценки миграции, сопоставления политик, планов развёртывания и анализа соответствия функциональности.
- durable-objectsСоздание и проверка Cloudflare Durable Objects. Используйте при разработке систем с сохранением состояния (чаты, многопользовательские игры, системы бронирования), реализации RPC-методов, хранилища SQLite, будильников (alarms), WebSockets, а также при проверке кода DO на соответствие лучшим практикам. Охватывает интеграцию с Workers, конфигурацию wrangler и тестирование с помощью Vitest. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении.
- sandbox-migrate-to-nextИспользуется при переносе приложения Cloudflare Sandbox со стабильной версии @cloudflare/sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0), а также когда пользователь просит выполнить миграцию или обновление до Sandbox 1.0 или @next. Не подходит для повседневной работы со стабильной версией (sandbox-stable) или новых приложений на @next (sandbox-next).
- sandbox-nextИспользуется при создании или изменении приложений Cloudflare Sandbox на @cloudflare/sandbox@next (превью Sandbox SDK 1.0): выполнение кода, ИИ-раннеры, интерпретаторы, задачи в духе CI, терминалы, файлы, точки монтирования, туннели, preview URL, жизненный цикл или ошибки. Не подходит для стабильного пакета по умолчанию (используйте sandbox-stable) и для переноса со стабильной версии на @next (используйте sandbox-migrate-to-next).
- sandbox-stableИспользуется при создании или изменении приложений Cloudflare Sandbox на текущем стабильном пакете @cloudflare/sandbox (тег npm по умолчанию): команды, сессии, файлы, порты, туннели, терминалы, bridge, продакшен или очистка устаревшего API при сохранении стабильной версии. Не подходит для @cloudflare/sandbox@next (используйте sandbox-next) и для переноса на версию 1.0 (используйте sandbox-migrate-to-next).
- turnstile-spinНастраивает Cloudflare Turnstile в проекте от начала до конца. Сканирует кодовую базу, создаёт виджет через Cloudflare API, встраивает его там, где запросам пользователя нужна проверка на бота (отправка форм, действия в SPA, API endpoints, ссылки для скачивания, отправка комментариев или голосов и т. д.), подключает каноническую серверную проверку siteverify в существующем бэкенде клиента, выполняет валидацию и сохраняет skill. Загружайте, когда пользователь просит добавить Turnstile, настроить CAPTCHA, защитить форму или endpoint от ботов либо исправить интеграцию Turnstile. Отражает developers.cloudflare.com/turnstile/spin.
- web-perfАнализирует производительность веб-страниц с помощью Chrome DevTools MCP. Измеряет Core Web Vitals (LCP, INP, CLS) и дополнительные метрики (FCP, TBT, Speed Index), выявляет ресурсы, блокирующие рендеринг, цепочки сетевых зависимостей, сдвиги макета, проблемы кеширования и пробелы в доступности. Используйте этот навык, когда нужно провести аудит, профилирование, отладку или оптимизацию скорости загрузки страницы, показателей Lighthouse или скорости сайта. Отдаёт приоритет данным из актуальной документации, а не знаниям, полученным при обучении модели.
- workers-best-practicesПроверяет и пишет код Cloudflare Workers в соответствии с лучшими практиками для продакшена. Загружайте при написании новых Workers, проверке кода Worker, настройке wrangler.jsonc или поиске типичных антипаттернов Workers (streaming, floating promises, global state, secrets, bindings, observability). Отдаёт приоритет данным из документации Cloudflare, а не предобученным знаниям.
- wranglerCLI для Cloudflare Workers: развёртывание, разработка и управление Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines и Secrets Store. Загружайте этот навык перед выполнением команд wrangler, чтобы обеспечить правильный синтаксис и соблюдение лучших практик. Отдаёт приоритет данным из документации Cloudflare, а не знаниям, полученным при обучении модели.
MCP-серверы
Прямой доступ к Cloudflare API, документации и инструментам наблюдаемости.
MCP серверы предоставляют типизированные инструменты для обращения к Cloudflare во время выполнения. Есть два варианта: Code Mode то есть единый сервер, который охватывает весь Cloudflare API (более 2 500 эндпоинтов примерно в 1000 токенов), либо набор узкоспециализированных серверов для конкретных продуктов, размещённых в cloudflare/mcp-server-cloudflare репозитории. Полный каталог также доступен в MCP серверы для Cloudflare документации.
- Code mode APIcode modeШирокий доступ ко всему API Cloudflare через выполнение кода с минимальным расходом токеновhttps://mcp.cloudflare.com/mcp
- Сервер AI GatewayВыполняйте поиск по своим логам, получайте подробности о промптах и ответахhttps://ai-gateway.mcp.cloudflare.com/mcp
- Сервер Audit LogsВыполняйте запросы к журналам аудита и формируйте отчёты для проверкиhttps://auditlogs.mcp.cloudflare.com/mcp
- Сервер AutoRAGПоиск и запросы к экземплярам AutoRAG аккаунтаhttps://autorag.mcp.cloudflare.com/mcp
- Сервер Browser RunЗагружайте веб-страницы, преобразуйте их в markdown и делайте снимки экранаhttps://browser.mcp.cloudflare.com/mcp
- Сервер Cloudflare BlogПоиск и чтение публикаций в Cloudflare Bloghttps://blog.mcp.cloudflare.com/mcp
- Cloudflare One CASB serverБыстро выявляйте неправильные конфигурации безопасности SaaS-приложений для защиты пользователей и данныхhttps://casb.mcp.cloudflare.com/mcp
- Сервер контейнеровРазверните среду разработки sandboxhttps://containers.mcp.cloudflare.com/mcp
- сервер Demo DayДемонстрация минимального MCP-сервера Cloudflarehttps://demo-day.mcp.cloudflare.com/mcp
- Сервер Digital Experience MonitoringПолучить быстрый обзор критически важных приложений в вашей организацииhttps://dex.mcp.cloudflare.com/mcp
- Сервер DNS AnalyticsОптимизируйте производительность DNS и отлаживайте проблемы с учётом текущей настройкиhttps://dns-analytics.mcp.cloudflare.com/mcp
- Сервер документацииПолучайте актуальную справочную информацию о Cloudflarehttps://docs.mcp.cloudflare.com/mcp
- Logpush-серверПолучить краткие сводки о состоянии задач Logpushhttps://logs.mcp.cloudflare.com/mcp
- Сервер наблюдаемостиОтлаживайте приложение и анализируйте его журналы и аналитикуhttps://observability.mcp.cloudflare.com/mcp
- Сервер RadarИзучите данные Cloudflare Radar о состоянии интернетаhttps://radar.mcp.cloudflare.com/mcp
- Сервер Workers BindingsСоздавайте приложения Workers с примитивами хранения, ИИ и вычисленийhttps://bindings.mcp.cloudflare.com/mcp
- Сервер Workers BuildsПолучить аналитику и управлять Cloudflare Workers Buildshttps://builds.mcp.cloudflare.com/mcp
Wrangler CLI
Локальная разработка, деплой и команды, специфичные для Workers.
Используйте Wrangler для локальной разработки, развёртывания и команд для конкретных продуктов, например wrangler d1 migrations apply или wrangler tail. Встроенный wrangler Skill учит агента, когда к нему обращаться.
Документация, удобная для агентов
Экономичные по токенам справочные материалы, оптимизированные для агентов.
Добавьте в конец /index.md к любому URL-адресу документации Cloudflare, чтобы получить чистую версию в markdown. У каждого раздела продукта верхнего уровня также есть собственный llms.txt то есть индекс страниц, рассчитанный на одно контекстное окно. Несколько полезных примеров:
- developers.cloudflare.com/llms.txt то есть каталог всех продуктов Cloudflare.
- developers.cloudflare.com/workers/llms.txt
- developers.cloudflare.com/agents/llms.txt
- developers.cloudflare.com/r2/llms.txt
- developers.cloudflare.com/d1/llms.txt
Чтобы получить полное представление о том, как эта документация структурирована для агентов, см. руководство «Docs for Agents».
Примеры запросов
Set up rate limiting and WAF rules to block abuse on my public API.Check my Workers deployment logs for errors and suggest fixes.Add a D1 database to my Worker and create a users table with full CRUD endpoints.Build an AI chat agent using the Cloudflare Agents SDK with persistent conversation history stored in D1.Create a RAG pipeline using Vectorize and Workers AI to answer questions over my documentation.Советы
- Плагин Skills включает Skill wrangler: Claude знает, когда обращаться к
npx wrangler deploy,wrangler d1 migrations apply, и другие команды CLI автоматически. - Попробуйте
/cloudflare:build-agentслэш-команду, чтобы создать каркас полноценного проекта Agents SDK, либо/cloudflare:build-mcpдля удалённого MCP сервера. - MCP сервер Cloudflare API использует Code Mode: Claude пишет JavaScript для TypeScript API, чтобы обратиться к любому из более чем 2,500+ конечных точек, потратив ~1,000 токенов.
- Claude Code работает лучше всего из корня проекта Workers, где
wrangler.jsoncнаходится. Именно по нему агент определяет ваши привязки. - Используйте
claude mcp listчтобы убедиться, что серверы Cloudflare подключены. Для CI/CD можно пропустить OAuth, передав вместо него токен Cloudflare API как bearer-токен.
Часто задаваемые вопросы
Что использовать: Skills, MCP сервер, Wrangler CLI или всё сразу?
Все три инструмента настраиваются вместе через плагин Skills. Skills дают
Claude постоянные знания о Cloudflare (когда использовать Durable Objects, а когда KV,
как должна выглядеть структура проекта на Workers). MCP-сервер Cloudflare API
отвечает за операции платформы (DNS, WAF, бакеты R2, Zero Trust).
Wrangler выполняет локальную разработку и команды, специфичные для Workers. wrangler Skill
учит Claude, когда какой из них использовать.
Как предоставить Claude Code доступ к моему аккаунту Cloudflare?
При первом обращении Claude к инструменту Cloudflare вас перенаправят для авторизации через OAuth и выбора предоставляемых прав доступа.
Может ли Claude Code развернуть существующие проекты Workers?
Да. Запустите Claude Code из существующего каталога проекта, где
wrangler.jsonc находится, и он поймёт конфигурацию вашего проекта
и выполнит развёртывание соответствующим образом.
Что означает Code Mode для MCP?
Благодаря Code Mode MCP-сервер Cloudflare API умещает все 2,500+ конечных точек API
в ~1,000 токенов. Вместо того чтобы представлять каждую конечную точку отдельным инструментом,
он предоставляет только два: search() и execute() и Claude пишет JavaScript,
чтобы их вызывать. Подробнее о Code Mode ↗.
Устранение неполадок
Не удаётся подключиться к MCP серверу или истекает время ожидания
Запустите claude mcp list и убедитесь, что сервер зарегистрирован. Попробуйте удалить его и
добавить заново: claude mcp remove cloudflare а затем добавьте его заново. Убедитесь, что у вас есть
npx и mcp-remote доступно.
Claude не может пройти аутентификацию в Cloudflare
Сервер MCP использует OAuth. Когда появится запрос, завершите процесс авторизации в браузере. Для CI/CD создайте Cloudflare API токен и передавайте его в качестве bearer-токена.
Получение устаревшей информации о продуктах Cloudflare
Включить MCP-сервер документации Cloudflare чтобы агент мог загружать
актуальную документацию во время выполнения. Если вы не хотите использовать MCP сервер, укажите
агенту напрямую на developers.cloudflare.com/llms.txt для
каталога всех продуктов, либо developers.cloudflare.com/<product>/llms.txt
для индекса конкретного продукта.
Создание агентов на Cloudflare
Cloudflare не просто площадка для развёртывания агентов, а полноценный стек для создания собственных агентов.
Stateful AI агенты с состоянием, планированием, RPC, почтой, потоковым чатом, а также Code Mode SDK для экономичного по токенам использования инструментов.
ПодробнееРазверните удалённый MCP сервер на Workers с OAuth, устойчивым состоянием и потоковым HTTP транспортом.
ПодробнееЗапускайте LLM, embedding модели и модели для работы с изображениями с открытым исходным кодом на edge. Используйте как провайдера моделей для своего агента.
ПодробнееЗагружает пользовательский код в изолированные Workers по требованию. Безопасная песочница, лежащая в основе Code Mode.
ПодробнееДругие агенты
Codex
Агент для написания кода от OpenAI, доступен как терминальный CLI и десктопное приложение. Читает и записывает файлы, выполняет команды и работает с вебом в песочнице.
Просмотреть руководствоCursor
IDE с приоритетом на ИИ на основе VS Code: правки в нескольких файлах через Composer и фоновые агенты. Разработчик: Cursor.
Просмотреть руководствоGitHub Copilot
Расширение для редактора и инструмент командной строки с режимом агента, контекстом рабочей области и встроенной интеграцией с PR. Разработано GitHub.
Просмотреть руководствоOpenCode
Терминальный агент с открытым исходным кодом и продвинутым TUI, работает с более чем 75 LLM. Разработан компанией Anomaly.
Просмотреть руководствоWindsurf
Агентная IDE с контекстом Cascade и Flows для многошаговых задач. Разработчик: Cognition.
Просмотреть руководствоVisual Studio Code
Бесплатный редактор кода с открытым исходным кодом, со встроенной поддержкой клиента Model Context Protocol (MCP) и интеграцией с Copilot Chat. Разработан Microsoft.
Просмотреть руководствоBionic
Мощный агент для написания кода и работы. Изначально локальный, с открытыми моделями в облаке. От LM Studio.
Просмотреть руководство