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

Инструменты

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

---

Шаги работы

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

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

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

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

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

• Установите опцию «Положение панели навигации» в значение Верх.

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

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

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

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

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

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

• Claude Code

• Gemini CLI

• Qwen Code

• OpenAI Codex

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

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

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

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

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

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

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

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

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

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

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

После завершения всех настроек нажмите Запустить кнопку. 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; настоятельно рекомендуется использовать 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!