Руководство Code Tools

В Cherry Studio версии v1.5.7 представлена удобная и мощная функция Code Agent, позволяющая напрямую запускать и управлять различными AI-программируемыми агентами. Это руководство проведет вас через полный процесс настройки и запуска.

Шаги выполнения

1. Обновите Cherry Studio

В первую очередь, убедитесь, что у вас установлена версия v1.5.7 или новее. Вы можете скачать последнюю версию на GitHub Releases или официальном сайте.

2. Настройте положение навигационной панели

Для удобного доступа к вкладкам в верхней части интерфейса, рекомендуем переместить навигационную панель наверх.

• Путь: Настройки → Настройки отображения → Настройки навигационной панели

• Установите опцию "Положение навигационной панели" в значение Сверху.

3. Создайте новую вкладку

Нажмите на значок "+" в верхней части интерфейса, чтобы создать новую пустую вкладку.

4. Откройте функцию Code Agent

В новой вкладке нажмите на значок Code (или </>), чтобы перейти к интерфейсу настройки Code Agent.

5. Выберите CLI-инструмент

Выберите инструмент Code Agent в соответствии с вашими потребностями и доступными API-ключами. В настоящее время поддерживаются:

• Claude Code

• Gemini CLI

• Qwen Code

• OpenAI Codex

6. Выберите модель для агента

В выпадающем списке моделей выберите модель, совместимую с выбранным CLI-инструментом. (Подробную информацию о совместимости моделей см. в разделе «Важные примечания» ниже)

7. Укажите рабочую директорию

Нажмите кнопку «Выбрать директорию», чтобы указать рабочую папку для агента. Агент получит доступ ко всем файлам и поддиректориям в этой папке для понимания контекста проекта, чтения файлов и выполнения кода.

8. Настройте переменные окружения

• Автонастройка: Выбор модели (шаг 6) и рабочей директории (шаг 7) автоматически создаст соответствующие переменные окружения.

• Пользовательские настройки: При необходимости можно добавить специфичные переменные окружения для вашего агента или проекта (например, PROXY_URL).

9. Обновление опций

• Встроенные исполняемые файлы: Cherry Studio включает исполняемые файлы для всех перечисленных Code Agent, что позволяет использовать их без подключения к интернету.

• Автообновление: Чтобы агент всегда оставался актуальным, включите опцию Проверять и устанавливать последнюю версию. При активации программа будет автоматически проверять и обновлять инструмент при каждом запуске.

10. Запустите агента

После завершения всех настроек нажмите кнопку Запустить. Cherry Studio автоматически вызовет системный Terminal (терминал), загрузит все переменные окружения и запустит выбранный Code Agent. Теперь вы можете взаимодействовать с AI-агентом в открывшемся терминальном окне.

Важные примечания

1. Совместимость моделей:

   • Claude Code: Требуется выбор моделей, поддерживающих формат Anthropic API Endpoint. В настоящее время официально поддерживаются:

     • Модели серии Claude

     • DeepSeek V3.1 (официальная платформа API)

     • Kimi K2 (официальная платформа API)

     • Zhipu GLM 4.5 (официальная платформа API)

     • Внимание: Многие сторонние сервисы (One API, New API и т.д.) для API DeepSeek, Kimi и GLM чаще всего поддерживают только формат OpenAI Chat Completions и могут быть несовместимы с Claude Code без дополнительной адаптации.

   • Gemini CLI: Требуются модели серии Google Gemini.

   • Qwen Code: Поддерживает модели с API форматом OpenAI Chat Completions. Для лучшего качества генерации кода рекомендуется использование моделей серии Qwen3 Coder.

   • OpenAI Codex: Поддерживает модели серии GPT (gpt-4o, gpt-5 и т.д.).

2. Конфликты зависимостей и окружения:

   • Cherry Studio включает изолированное Node.js окружение, исполняемые файлы Code Agent и настройки переменных среды для обеспечения готовой к использованию среды.

   • При возникновении конфликтов или неожиданных ошибок попробуйте временно удалить или отключить глобально установленные зависимости (Node.js или специфичные инструментальные цепочки).

3. Предупреждение о расходе токенов API:

   • Code Agent активно расходует токены API. При обработке сложных задач агент может генерировать множество запросов, что приводит к быстрому расходу токенов.

   • Контролируйте использование токенов в соответствии с вашими лимитами API и бюджетом, чтобы избежать перерасхода.

Надеемся, что это руководство поможет вам быстро освоить мощные возможности Code Agent в Cherry Studio!