✕

ИИ-агенты для кода (ACP)

Запускайте Claude Code, OpenAI Codex или Gemini CLI прямо со своего телефона через AI Chat в Spck Editor. Spck CLI соединяет ваш редактор с локально установленными CLI-агентами через открытый Agent Client Protocol (ACP), так что модель работает на вашей машине, с вашей подпиской, против ваших реальных файлов — пока вы наблюдаете за ней с мобильного устройства.

Режим локального ИИ ACP в AI Chat в Spck Editor, управляющий Claude Code на десктопе с телефона

Что такое ACP и зачем его использовать?

Agent Client Protocol (ACP) — это открытый стандарт от Zed Industries для коммуникации редактор ↔ ИИ-агент, в том же духе, что и Language Server Protocol (LSP). Spck CLI 0.6.0+ реализует ACP и выступает в роли транспорта между AI Chat в Spck Editor (клиентом) и любым ACP-совместимым двоичным агентом, который у вас установлен (агентом).

По сравнению со встроенным AI Chat с маршрутизацией через сервер, локальный путь ACP даёт вам:

  • Вашу собственную подписку — вызовы агента списываются с вашей учётной записи Claude Code / ChatGPT / Gemini, а не с квоты ИИ Spck Editor.
  • Реальный доступ к файловой системе — агенты читают и пишут реальные файлы на диске через CLI, а не копии в памяти редактора.
  • Нативные инструменты — наблюдатели за файлами, языковые серверы и shell-команды работают на вашей реальной машине.
  • Непрерывность с десктопом — тот же логин claude / gemini / codex, который вы используете за рабочим столом, движет мобильным чатом.

Поддерживаемые ИИ-агенты

Установите тех агентов, которые хотите иметь в наличии. Spck CLI обнаружит их автоматически при запуске.

Агент Установка
Claude Code claude
OpenAI Codex npm install -g @agentclientprotocol/codex-acp
Gemini CLI gemini

Установка и настройка

1. Установите Spck CLI

Если у вас его ещё нет:

npm install -g spck
# или запустите без установки
npx spck

См. Начало работы со Spck CLI, чтобы пройти полный мастер первого запуска.

2. Установите один или несколько CLI агентов

Выберите тех агентов, которых хотите иметь в наличии. Можно установить несколько — AI Chat позволит выбирать между ними посессионно. См. таблицу Поддерживаемые ИИ-агенты выше для команд установки.

3. Аутентифицируйте каждого агента один раз

CLI агентов управляют своим логином вне Spck Editor:

claude            # Поток входа Anthropic Claude Code
codex login       # Поток входа OpenAI Codex (используется codex-acp)
gemini            # Поток входа Google Gemini

Если вы пропустите этот шаг, Spck Editor покажет ошибку вроде ACP agent requires authentication; run <binary> login and retry при первом запуске чата.

4. Запустите Spck CLI

cd /path/to/your/project
spck

При запуске CLI печатает отчёт обнаружения по агентам, перечисляющий, какие агенты доступны, а затем однострочную сводку вроде ✅ ACP agents: Claude Code, Gemini CLI в основном блоке возможностей. Если ничего не доступно, происходит откат на AI Chat с маршрутизацией через сервер.

5. Подключите Spck Editor

Отсканируйте QR-код или используйте ручной ввод. После подключения откройте AI Chat в Spck Editor — переключатель транспорта покажет локальных агентов рядом с облачным вариантом.

Аутентификация

Каждый агент управляет своими учётными данными на машине, где запущен Spck CLI. Выполните поток входа один раз для каждого агента:

# Claude Code
claude

# Codex (codex-acp оборачивает собственный логин Codex CLI)
codex login

# Gemini CLI
gemini

Если вы переустанавливаете или меняете машину, повторите вход на новом хосте. Аутентификация на хост, на агента — сам Spck Editor никогда не хранит эти учётные данные.

Тарификация и лимиты

Поскольку ACP запускает агента на вашей машине с вашими учётными данными, всё использование выставляется вашему счёту у соответствующего поставщика — а не вашей подписке Spck Editor. Spck Editor и серверы-ретрансляторы Spck выступают как чистый транспорт в этом режиме и не расходуют квоту ИИ в приложении на ACP-трафик.

Тарификация Claude Code

⚠️ Важно — Claude Code применяет отдельный лимит-бакет, когда им управляют сторонние инструменты.

Когда Claude Code вызывается из стороннего клиента через ACP, Anthropic учитывает этот трафик в другом лимит-бакете, чем ваши интерактивные сессии CLI claude на подписке Pro / Max. Практическое следствие: вы можете исчерпать сторонний бакет, имея ещё запас интерактивного Claude Code (или наоборот), и объединить их невозможно.

Проверьте /usage внутри claude и Anthropic Console, чтобы увидеть текущий расход, и просмотрите документацию о стоимости и лимитах Claude Code для цифр, применимых к вашему тарифу.

Тарификация Codex (codex-acp)

Выставляется через собственную аутентификацию OpenAI Codex CLI — ваш ключ API OpenAI или логин ChatGPT. Использование учитывается по тарифу, которым обладает данная учётная запись. Цены и квоты те же, что для интерактивного использования codex; см. openai.com/codex и панель OpenAI для текущих цифр.

Тарификация Gemini CLI

Выставляется через вашу учётную запись Google или ключ API Gemini. Использование учитывается по тарифу Gemini или API-квоте, привязанной к данному логину. Подробности о лимитах см. на ai.google.dev.

Конфигурация

ACP включён по умолчанию и настраивается через spck-cli.config.json проекта:

{
  "acp": {
    "enabled": true
  }
}

См. Конфигурация → Настройки ACP для полной схемы.

Отключить ACP в рамках проекта

Если вы не хотите, чтобы Spck Editor мог управлять локальным агентом на этом хосте:

{
  "acp": {
    "enabled": false
  }
}

При отключении переключатель транспорта редактора скрывает вариант локального агента, и любой acp.* RPC отклоняется с FEATURE_DISABLED. Мастер настройки задаёт этот вопрос при первом запуске (по умолчанию Y); конфигурации, предшествующие этой опции, загружаются с автоматически добавленным acp.enabled: true и пересохраняются.

Отключить отдельного агента

Чтобы конкретный агент не предлагался, оставив ACP включённым для остальных, удалите его двоичный файл. Обнаружение выполняется при каждом запуске CLI, так что переключатель транспорта редактора уберёт его из списка.

Локальный ACP vs. AI Chat с маршрутизацией через сервер

Возможность С маршрутизацией через сервер (по умолчанию, без CLI) Локально (ACP, CLI подключён)
Где работает модель Облако Spck Ваша машина
Учётные данные Ваша учётная запись Spck Editor Собственный логин / ключ API агента
Доступ к файлам Файловая система редактора в памяти Реальные файлы на диске через root CLI
Учитывается ли в квоте ИИ Spck Editor Да Нет — выставляется поставщику агента
Работает без запущенного CLI Да Нет (требует CLI + WebSocket)
Доступные агенты Модели, размещённые Spck Claude Code, Codex, Gemini CLI
Запросы разрешения на использование инструментов на телефоне Где применимо Да, пересылаются через ACP
Потоковая передача токенов Да Да
Мультираундный чат Да Да

Можно переключать транспорт прямо в проекте — AI Chat показывает те пути, что в данный момент доступны, исходя из состояния подключения CLI и обнаруженных агентов.

Связка с Tmux для долгоиграющих сессий

ACP-сессии остаются живыми при переподключениях редактора, но сам процесс Spck CLI завершается при закрытии его терминала. Для длительной работы агента — больших рефакторингов, многочасовых сессий планирования — запускайте CLI внутри сессии tmux, чтобы пережить разрывы SSH, закрытия терминала и спящий режим ноутбука:

tmux new -s spck
spck
# Ctrl+B затем D для отсоединения

С телефона также можно переподключиться через терминал Spck CLI и tmux attach -t spck, чтобы наблюдать за агентом в реальном времени. См. Использование Tmux для полного шаблона, включая запуск CLI как постоянного фонового сервиса.

Для хостов Linux страница Claude Skill: Linux Service предлагает однокомандную настройку для запуска Spck CLI как сервиса systemd, так что WebSocket — и любые ACP-сессии поверх него — стартуют автоматически при загрузке.

Часто задаваемые вопросы

Могу ли я использовать Claude Code на телефоне?

Да. Установите Claude Code на десктопе, аутентифицируйтесь через claude, затем запустите spck в вашем проекте. Подключите Spck Editor с телефона и выберите Claude Code в переключателе транспорта AI Chat. Модель работает на десктопе с вашей подпиской; вы управляете ею с телефона.

Видит ли Spck Editor мой ключ API Claude / OpenAI / Gemini?

Нет. Каждый CLI агента управляет своими учётными данными на машине, где работает Spck CLI. Сообщения ACP туннелируются через зашифрованный WebSocket между телефоном и CLI, но собственные токены аутентификации агента никогда не покидают ваш хост.

Есть ли дополнительная плата за использование Claude Code через Spck Editor?

Никаких дополнительных взиманий Spck Editor. Использование агента учитывается по вашему тарифу Anthropic / OpenAI / Google ровно так же, как если бы вы запускали агента интерактивно за столом — за исключением того, что Anthropic применяет отдельный лимит-бакет для сторонних клиентов; см. Тарификация и лимиты выше.

Нужна ли мне платная подписка Spck Editor для использования ACP?

Нет. Бесплатного уровня (30 мин/день подключения CLI) достаточно, чтобы управлять любым ACP-агентом. Только встроенный AI Chat с маршрутизацией через сервер расходует квоту ИИ Spck Editor.

Что произойдёт, если я потеряю Wi-Fi посреди чата?

Процесс агента остаётся живым на хосте CLI. Когда редактор переподключается, сессия возобновляется с полной историей чата. Потоковый вывод, поступивший пока вы были офлайн, воспроизводится при переподключении.

Можно ли запускать агентов на удалённом сервере, а не на ноутбуке?

Да. Запустите Spck CLI на любом доступном хосте Linux/macOS — dev-VM, домашнем сервере, рабочей станции — и подключитесь к нему через сервер-ретранслятор. Сочетайте с tmux или systemd-скилом, чтобы CLI оставался живым между подключениями.

Работает ли ACP со Spck Editor Lite?

Да. Трафик ACP использует тот же WebSocket-транспорт, что и файловая система и git, который поддерживается Spck Editor Lite. Убедитесь, что security.userAuthenticationEnabled установлен в false в вашей конфигурации CLI — аутентификация Firebase не поддерживается в Lite. См. Конфигурация → Аутентификация пользователя.

Почему мой агент не появляется в AI Chat?

Проверьте лог запуска CLI на строку по агенту:

  • Агент не обнаружен — установите его (см. Поддерживаемые ИИ-агенты).
  • Обнаружен, но отсутствует в редакторе — убедитесь, что вы завершили собственный поток входа агента (claude, codex login, gemini).
  • ACP отключён — проверьте acp.enabled в .spck-editor/config/spck-cli.config.json. См. Конфигурация.

Устранение неполадок

Агент обнаружен, но сессия не стартует

Чаще всего это значит, что агент не аутентифицирован. Запустите поток входа агента на хосте CLI:

claude              # затем завершите аутентификацию в браузере
codex login
gemini

Если проблема не уходит, проверьте логи CLI в .spck-editor/logs/ на stderr-вывод агента — обычно он указывает на сбой аутентификации или двоичного файла.

Ошибки лимита использования во время чата

Для Claude Code редактор передаёт 429 от Anthropic дословно. Проверьте страницу использования Anthropic Console и документацию о стоимости Claude Code — помните, что сторонний лимит-бакет отделён от вашей интерактивной квоты claude.

Для Codex и Gemini редактор передаёт собственную ошибку квоты поставщика. Разрешайте через консоль поставщика.

CLI падает при старте ACP-сессии

Spck CLI логирует ACP-трафик в .spck-editor/logs/. Отслеживайте новейший лог-файл, воспроизводя проблему:

tail -f .spck-editor/logs/spck-*.log

Заведите баг на github.com/spck-editor, приложив соответствующий фрагмент.

Агент вносит изменения вне корня проекта

ACP-агенты ограничены настроенным каталогом root в CLI. Если вы видите запись вне него, заведите issue — этого происходить не должно. В качестве обходного решения запустите spck --root /path/to/specific/project, чтобы ещё сильнее сузить область.

См. также