# Руководство по использованию Code Tools
Версия Cherry Studio v1.5.7 представила простую в использовании и мощную функцию Code Agent, которая позволяет напрямую запускать и управлять различными AI-агентами для программирования. Этот учебник проведёт вас через полный процесс настройки и запуска.
***
### Порядок действий
#### 1. Обновите Cherry Studio
Сначала убедитесь, что ваша Cherry Studio обновлена до **v1.5.7** или более новой версии. Вы можете перейти на [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) или на официальный сайт, чтобы скачать последнюю версию.
#### 2. Перейдите в интерфейс инструмента Code Tool
Режим верхней навигации: нажмите на значок «+» в верхней части интерфейса, чтобы создать новую пустую вкладку
{% hint style="info" %}
В режиме левой навигации нажмите кнопку Code Tool в левом меню, чтобы перейти на эту страницу
{% endhint %}
#### 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!
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.cherry-ai.com/docs/russian/advanced-basic/code-tools-shi-yong-jiao-cheng.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.