← Sandbox SDK / sandbox / tutorials
Запуск Claude Code в песочнице
Создайте Worker, который принимает URL репозитория и описание задачи, а затем использует Sandbox SDK для запуска Claude Code, чтобы выполнить эту задачу.
Время выполнения: 5 минут
Предварительные требования
- Зарегистрируйтесь для получения Аккаунт Cloudflare ↗.
- Установка
Node.js↗.
менеджер версий Node.js
Используйте менеджер версий Node, например Volta ↗ или nvm ↗ чтобы избежать проблем с правами доступа и переключать версии Node.js. Wrangler, о котором пойдёт речь далее в этом руководстве, требует версию Node 16.17.0 или более поздней версии.
Также потребуется:
- Одна Ключ API Anthropic ↗ для Claude Code
- Docker ↗ локальный запуск
1. Создайте проект
Создайте новый проект Sandbox SDK:
npm create cloudflare@latest -- claude-code-sandbox --template=cloudflare/sandbox-sdk/examples/claude-codecd claude-code-sandbox2. Настройте локальные переменные окружения
Создайте .dev.vars файл в корне вашего проекта для локальной разработки:
echo "ANTHROPIC_API_KEY=your_api_key_here" > .dev.varsЗамените your_api_key_here на ваш действующий API-ключ из Anthropic Console ↗.
3. Протестируйте локально
Запустите сервер разработки:
npm run devТестирование с помощью curl:
curl -X POST http://localhost:8787/ \
-d '{
"repo": "https://github.com/cloudflare/agents",
"task": "remove the emojis from the readme"
}'Ответ:
{
"logs": "Done! I've removed the brain emoji from the README title. The heading now reads \"# Cloudflare Agents\" instead of \"# 🧠 Cloudflare Agents\".",
"diff": "diff --git a/README.md b/README.md\nindex 9296ac9..027c218 100644\n--- a/README.md\n+++ b/README.md\n@@ -1,4 +1,4 @@\n-# 🧠 Cloudflare Agents\n+# Cloudflare Agents\n \n \n "
}4. Разверните
Разверните ваш Worker:
npx wrangler deployЗатем задайте ключ API Anthropic в качестве секрета для продакшена:
npx wrangler secret put ANTHROPIC_API_KEYВставьте свой API-ключ из Anthropic Console ↗ при появлении запроса.
Что вы создали
Вы создали API, который:
- Принимает URL репозитория и описания задач на естественном языке
- Создаёт Sandbox и клонирует в него репозиторий
- Запускает Claude Code для реализации заданной задачи
- Возвращает вывод и изменения Claude
Следующие шаги
- Анализ данных с помощью ИИ - Добавьте pandas и matplotlib для анализа данных
- Code Interpreter API - Используйте встроенный интерпретатор кода вместо exec
- Потоковый вывод - Отображение прогресса выполнения в реальном времени
- Справочник по API - Ознакомьтесь со всеми доступными методами
Дополнительные материалы
- Документация Anthropic Claude ↗
- Workers AI - Используйте встроенные модели Cloudflare