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