133 lines
5.7 KiB
Markdown
133 lines
5.7 KiB
Markdown
# Проект: 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: Продвинутая интеграция
|
||
- [ ] Документация обновлена
|
||
- [ ] Экономия подтверждена
|