Инструменты командной строки и агенты
Выберите подходящие инструменты разработки для AGTCloud с учётом сценария использования, протокола и разрешений.
AGTCloud можно подключить к агентам командной строки, расширениям IDE, настольным клиентам и средствам управления настройками. При выборе сначала определите рабочий процесс и протокол, затем оцените доступ инструмента к файлам, командам и внешним сервисам.
Эта страница помогает быстро выбрать руководство и не повторяет инструкции по установке и настройке каждого инструмента. В выбранном руководстве соблюдайте требования к Base URL, аутентификации и модели.
Агенты могут выполнять локальные операции
Некоторые инструменты могут читать и изменять файлы, запускать команды Shell или обращаться к сети. Для первого подключения используйте тестовый каталог без конфиденциальных данных, отключите автоматическое одобрение и начните проверку с задач только на чтение.
Выбор по инструменту
| Инструмент | Формат использования | Протокол подключения к AGTCloud | Лучше подходит для |
|---|---|---|---|
| Claude Code | Агент программирования в терминале | Anthropic Messages | Существующего процесса работы в Claude Code с сохранением структуры Messages и Content Blocks |
| Codex | CLI и настольное App | OpenAI Responses | Responses, Typed Items или проектного процесса работы Codex |
| Gemini CLI | Терминальный агент | Gemini Generate Content | Проектов, уже использующих структуру Gemini Contents и Parts |
| Cline | Расширение IDE | OpenAI Chat Completions | Проверки операций агента в редакторах, совместимых с VS Code, или в JetBrains |
| Cherry Studio | Настольный клиент чата | OpenAI Chat Completions | Чата с несколькими моделями в графическом интерфейсе и базовой проверки подключения |
| OpenClaw | Самостоятельно размещаемый Gateway, TUI и Control UI | OpenAI Chat Completions | Локального Gateway и расширяемой среды выполнения персонального агента |
| CC-Switch | Локальное управление настройками | Anthropic Messages, OpenAI Responses | Сохранения и переключения настроек Provider для Claude Code и Codex |
| Hermes Agent | Терминальный агент | OpenAI Chat Completions | Custom Endpoint, терминальных сеансов и работы с вызовами инструментов |
Название протокола не определяет поставщика модели. Одна модель может предоставлять несколько протокольных интерфейсов, но вызовы инструментов, мультимодальность, рассуждения и возможности контекста зависят от фактической поддержки конкретной модели.
Выбор по задаче
| Цель | Что посмотреть в первую очередь | Причина выбора |
|---|---|---|
| Анализ и изменение кода в терминале | Claude Code, Codex, Gemini CLI | Все три поддерживают полноценный терминальный процесс, но используют разные структуры протоколов |
| Пошаговая проверка операций с файлами и командами в IDE | Cline | План операций, изменения файлов и предоставление разрешений сосредоточены в редакторе |
| Обычный диалог с моделью в графическом интерфейсе | Cherry Studio | После настройки поставщика и модели подключение можно проверить в чате |
| Запуск локального агента на собственном сервере | OpenClaw, Hermes Agent | Предоставляют Gateway или CLI для запуска агента и требуют более строгого контроля разрешений на хосте |
| Управление несколькими конфигурациями Claude Code или Codex | CC-Switch | Сохраняет и переключает Provider на локальном компьютере, но не заменяет клиент, отправляющий запросы |
| Подключение внешних инструментов и источников данных | Подключение MCP и безопасность | MCP связывает клиент с сервисом инструментов и не равнозначен API модели |
Проверки перед подключением
1. Определите формат использования
Решите, нужен ли терминал, IDE, настольный чат или собственный Gateway. Не выбирайте только по названию: сначала убедитесь, что инструмент соответствует процессам одобрения и управления разрешениями вашей команды.
2. Проверьте протокол
Скопируйте ID модели, доступной текущему ключу API, из каталога моделей и убедитесь, что она поддерживает требуемый руководством интерфейс Chat Completions, Responses, Anthropic Messages или Gemini Generate Content.
3. Подготовьте отдельные учётные данные
На странице API Keys создайте ключ API, который легко идентифицировать и отключить. Не записывайте настоящий ключ в репозиторий, снимки экрана, журналы или общие настройки.
4. Изучите разрешения
Проверьте доступ инструмента к каталогам, командам, сети и внешним сервисам. По умолчанию отключайте автоматическое одобрение и предоставляйте только минимальный доступ для текущей задачи.
Поэтапная проверка
| Этап | Рекомендуемая задача | Критерий успешной проверки |
|---|---|---|
| Базовое подключение | Ответ фиксированным текстом без вызова инструментов | Получен ответ, Provider, Base URL и модель соответствуют ожиданиям |
| Чтение файлов | Чтение и краткое описание README.md в тестовом каталоге | Файлы не записаны, неодобренные команды не выполнены |
| Контролируемые инструменты | Одна обратимая операция с чёткими границами воздействия | Клиент показывает операцию и запрашивает подтверждение, результат соответствует ожиданиям |
| Проектная задача | Работа с реальным проектом под защитой контроля версий | Изменения можно проверить и откатить, существующие проверки проекта проходят |
Успешный запуск клиента не означает завершённого подключения. Как минимум подтвердите, что реальные запросы используют ожидаемые Provider, модель и протокол и что инструмент не вышел за пределы разрешённого доступа.
Частые вопросы при выборе
| Проблема | Рекомендация |
|---|---|
| Диалог работает, но вызовы инструментов недоступны | Сначала проверьте поддержку вызовов инструментов моделью и протоколом, затем версию клиента и разрешения |
| Одна модель ведёт себя по-разному в разных инструментах | Сравните протокол, системные инструкции, Schema инструментов, контекст и параметры клиента по умолчанию |
| Настройки верны, но запросы идут другому Provider | Полностью перезапустите клиент и проверьте пользовательскую конфигурацию, переменные окружения и активный Provider |
Base URL возвращает 404 | По конкретному руководству проверьте, нужен ли API Origin, Base URL с /v1 или автоматическое добавление пути клиентом |
| Неясно, можно ли включить автоматическое одобрение | Оставьте его выключенным; предоставляйте разрешения по отдельности только при ясных границах задач, каталогов и команд |
| Нужно подключить базу данных, файловую систему или бизнес-сервис | Сначала прочитайте Подключение MCP и безопасность и проверьте происхождение сервиса и разрешения |
Рекомендации по безопасности
- Загружайте установщики и команды из официальных источников инструмента; перед обновлением читайте примечания к версии;
- Используйте для разных инструментов ключи API, которые можно отдельно отключать и проверять;
- Выполняйте задачи с изменением файлов под защитой контроля версий или резервных копий;
- Не отправляйте модели пароли, данные клиентов, производственные данные и другую ненужную конфиденциальную информацию;
- Проверяйте, не содержат ли журналы, экспорт сеансов и отчёты о сбоях ключи, пути или бизнес-данные;
- После прекращения использования инструмента удалите сохранённые учётные данные и отзовите ненужные разрешения.
Если инструмент уже выбран, начните с руководства по CC-Switch или выберите соответствующий инструмент в таблице выше. Поля и структуры ответов описаны в Справочнике API.