Руководство по использованию 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-ключа выберите инструмент Code Agent, который вы собираетесь использовать. В настоящее время поддерживаются следующие варианты:

• Claude Code

• Gemini CLI

• Qwen Code

• OpenAI Codex

4. Выберите модель, вызываемую агентом

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

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

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

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

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

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

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

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

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

8. Запуск агента

После завершения всех настроек нажмите Запустить кнопку. Cherry Studio автоматически вызовет встроенный в вашу систему терминал и загрузит в него все переменные окружения, а затем запустит выбранный вами 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 и др.) для DeepSeek, Kimi, GLM чаще всего поддерживают только формат OpenAI Chat Completions, и они могут быть несовместимы с Claude Code напрямую; требуется ждать, пока провайдеры постепенно адаптируют свои сервисы.

   • Gemini CLI：требуется выбирать модели серии Google Gemini.

   • Qwen Code：модели, поддерживающие формат OpenAI Chat Completions API; настоятельно рекомендуется использовать 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!