diff --git a/tasks/claude-code-integration/PROJECT.md b/tasks/claude-code-integration/PROJECT.md new file mode 100644 index 0000000..e14b216 --- /dev/null +++ b/tasks/claude-code-integration/PROJECT.md @@ -0,0 +1,132 @@ +# Проект: 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`: + ```bash + #!/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](https://docs.anthropic.com/en/docs/claude-code) +- [Anthropic Pro Pricing](https://www.anthropic.com/pricing) +- OpenClaw ACP docs: `/app/docs/acp.md` + +--- + +## 🔄 Статус + +- [ ] Фаза 1: Установка и тест +- [ ] Фаза 2: Базовая интеграция +- [ ] Фаза 3: Продвинутая интеграция +- [ ] Документация обновлена +- [ ] Экономия подтверждена