auto-sync: 2026-04-17 13:00:01

This commit is contained in:
Stream
2026-04-17 13:00:02 +03:00
parent 9aef12c774
commit 34e41fc677

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