Руководство по использованию Code Tools

Инструменты

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

---

Порядок действий

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

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

2. Перейдите в интерфейс инструмента Code Tool

Режим верхней навигации: нажмите на значок «+» в верхней части интерфейса, чтобы создать новую пустую вкладку

В режиме левой навигации нажмите кнопку Code Tool в левом меню, чтобы перейти на эту страницу

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

В зависимости от ваших потребностей и имеющегося API Key выберите один из Code Agent-инструментов для использования. В настоящее время поддерживаются следующие варианты:

• Claude Code

• Gemini CLI

• Qwen Code

• OpenAI Codex

4. Выберите модель для вызова Agent

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

5. Укажите рабочий каталог

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

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

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

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

7. Параметры обновления

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

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

8. Запуск Agent

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

---

Важные замечания

1. Описание совместимости моделей：

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

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

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

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

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

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

   • Gemini CLI: необходимо выбрать модели серии Gemini от Google.

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

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

2. Зависимости и конфликты среды：

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

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

3. Предупреждение о расходе API Token：

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

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

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