wiki/tasks/claude-code-integration/PROJECT.md

Проект: Claude Code Integration с Dev-агентом

Дата создания: 17 апреля 2026 Заказчик: Слава Исполнитель: Стрим (планирование) + Dev-агент (реализация)

---

🎯 Цель

Интегрировать Claude Code CLI (Pro аккаунт) с Dev-агентом OpenClaw для использования Claude Sonnet 4.6 без оплаты за токены (в рамках Pro подписки).

Проблема: Текущий Dev-агент использует:

• nekocode/gpt-5.4 (OpenRouter) — платно по токенам
• anthropic/claude-sonnet-4-6 (Anthropic API) — $3/1M input, $15/1M output

Решение: Использовать Claude Code CLI, который подключается к Pro аккаунту Славы и даёт доступ к Sonnet без почасовой оплаты.

---

📋 Варианты интеграции

Вариант 1: Claude Code CLI + ручной вызов (рекомендуемый для старта)

• Dev-агент вызывает claude CLI через exec для тяжёлых задач
• Минимум настроек, работает сразу
• Требует явного вызова в ТЗ

Вариант 2: ACP harness (если Claude Code поддерживает ACP)

• Запуск как sessions_spawn(runtime="acp", agentId="claude-code")
• Полная интеграция с OpenClaw
• Требует проверки ACP-поддержки

Вариант 3: Прокси-сервер (OpenAI-compatible API)

• Node.js/Python прокси на localhost:8080
• Принимает OpenAI-format → перенаправляет в claude CLI
• Можно использовать как model в конфиге OpenClaw
• Требует разработки и поддержки

Вариант 4: Кастомный AgentSkill

• Skill claude-code с командами для вызова CLI
• Интеграция через tools в промпте агента
• Средний уровень сложности

---

🔧 Технические детали

Claude Code CLI

• Установка: npm install -g @anthropic/claude-code или npx -y @anthropic/claude-code
• Авторизация: claude auth login → OAuth через браузер
• Команда: claude "запрос" или claude --file path/to/file "запрос"
• Модель: Sonnet 4.6 (по умолчанию в Pro)
• Лимиты: Fair use Pro аккаунта (нет жёстких ограничений по токенам)

Текущий Dev-агент

• ID: dev
• Runtime: subagent
• Model: nekocode/gpt-5.4 (по умолчанию)
• Workspace: ~/.openclaw/workspace-dev
• CWD: /home/node/.openclaw/workspace-dev (критично!)

---

📝 План действий

Фаза 1: Установка и тест (Стрим)

1. Установить Claude Code CLI на хосте (mva154)
2. Авторизоваться через claude auth login
3. Протестировать: claude "напиши hello world на Python"
4. Проверить, что ответ приходит от Sonnet и не списываются токены

Фаза 2: Базовая интеграция (Dev-агент)

1. Создать скрипт-обёртку ~/.openclaw/scripts/claude_call.sh:

   #!/bin/bash
   # Вызов Claude Code CLI с сохранением результата
   QUERY="$1"
   OUTPUT_FILE="${2:-/tmp/claude_output.md}"
   claude "$QUERY" > "$OUTPUT_FILE" 2>&1
   echo "$OUTPUT_FILE"
   

2. Добавить в ТЗ для Dev-агента инструкцию по использованию
3. Протестировать вызов из субагента

Фаза 3: Продвинутая интеграция (опционально)

• Вариант А: Прокси-сервер (Вариант 3)
• Вариант Б: ACP harness (Вариант 2)
• Вариант В: AgentSkill (Вариант 4)

---

✅ Критерии успеха

1. Claude Code CLI установлен и авторизован
2. Dev-агент может вызывать claude CLI через exec
3. Тяжёлые задачи (рефакторинг, анализ кода) делегируются в Claude Code
4. Нет списаний токенов за использование Sonnet (проверить в dashboard Anthropic)

---

📊 Метрики экономии

Текущие расходы (оценка):

• Dev-агент: ~$X/X月在 OpenRouter + Anthropic API
• Цель: снизить до $0 за Claude запросы (только Pro подписка)

---

🚧 Риски

1. ACP не поддерживается →只能用 Вариант 1 или 3
2. Fair use лимиты Pro → могут быть ограничения на количество запросов/день
3. Скорость CLI → может быть медленнее прямого API
4. Конкурентный доступ → если несколько сессий вызывают claude одновременно

---

📎 Ссылки

• Claude Code Docs
• Anthropic Pro Pricing
• OpenClaw ACP docs: /app/docs/acp.md

---

🔄 Статус

• Фаза 1: Установка и тест
• Фаза 2: Базовая интеграция
• Фаза 3: Продвинутая интеграция
• Документация обновлена
• Экономия подтверждена