auto-sync: 2026-04-17 13:00:01
This commit is contained in:
132
tasks/claude-code-integration/PROJECT.md
Normal file
132
tasks/claude-code-integration/PROJECT.md
Normal file
@@ -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: Продвинутая интеграция
|
||||
- [ ] Документация обновлена
|
||||
- [ ] Экономия подтверждена
|
||||
Reference in New Issue
Block a user