> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/advanced-basic/code-tools.md).

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

Code Tools может напрямую запускать и управлять множеством CLI-инструментов для AI-программирования внутри Cherry Studio, таких как Claude Code, Qwen Code, Gemini CLI, OpenAI Codex, iFlow CLI, GitHub Copilot CLI, Kimi CLI и OpenCode. Этот учебник на примере Cherry Studio v1.9.9 проведёт вас через полную настройку.

***

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

#### 1. Проверьте версию Cherry Studio

Сначала убедитесь, что Cherry Studio обновлён до текущей стабильной версии. Вы можете перейти на [загрузку клиента](/docs/russian/cherry-studio/download.md)、[GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) или [официальный сайт](https://cherryai.com.cn/download) и скачать установочный пакет.

#### 2. Перейдите в интерфейс Code Tools

В режиме верхней навигации: нажмите на `+` значок в верхней части интерфейса, чтобы открыть лаунчпад, затем нажмите **Code**。

<figure><img src="/files/cf98d219f249dc13c4cbf5f049f9c6517e018f90" alt=""><figcaption><p>Нажмите на «+» сверху, чтобы открыть лаунчпад</p></figcaption></figure>

<figure><img src="/files/e57a419c8bc2e2766ac62724963ba71d7793567b" alt=""><figcaption><p>Нажмите Code в лаунчпаде</p></figcaption></figure>

{% hint style="info" %}
В режиме левой навигации можно сразу нажать на **Code** кнопку в левой панели навигации, чтобы перейти на эту страницу.
{% endhint %}

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

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

* **Claude Code**
* **Qwen Code**
* **Gemini CLI**
* **OpenAI Codex**
* **iFlow CLI**
* **GitHub Copilot CLI**
* **Kimi CLI**
* **OpenCode**

<figure><img src="/files/c8b0df29925a54ef6b67dac36ff5cfd33d5592a0" alt=""><figcaption><p>Выберите инструмент Code Agent</p></figcaption></figure>

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

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

<figure><img src="/files/f1601b956732a372e3e35dd6105845022ae7346d" alt=""><figcaption><p>Выберите модель</p></figcaption></figure>

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

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

<figure><img src="/files/984826ce9791420ae82d7b61cb35abc85a1ad03c" alt=""><figcaption><p>Укажите рабочую директорию</p></figcaption></figure>

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

* **Автоматическая настройка**: выбранные вами на шаге 4 (модель) и шаге 5 (рабочая директория) параметры автоматически сгенерируют соответствующие переменные окружения.
* **Добавление вручную**: если вашему Agent или проекту нужны другие особые переменные окружения (например `PROXY_URL` и т. д.), их можно добавить здесь вручную.

<figure><img src="/files/55a28951417f623454338340638b240bd31c96f9" alt=""><figcaption><p>Настройка переменных окружения</p></figcaption></figure>

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

* **Встроенные исполняемые файлы**: Cherry Studio уже включает исполняемые файлы указанных выше Code Agent, поэтому обычно нет необходимости вручную устанавливать CLI.
* **Автообновление**: если вы хотите, чтобы CLI-инструмент всегда оставался актуальным, можно отметить **Проверять обновления и устанавливать последнюю версию**. После этого при каждом запуске программа будет проверять наличие обновлений в сети и обновлять пакет исполняемых файлов.

<figure><img src="/files/7a2b25aedc08a9ddf4d48a88c2b90d44eedf1e09" alt=""><figcaption><p>Параметры обновления</p></figcaption></figure>

#### 8. Запустите Agent

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

<figure><img src="/files/d0823e8a12f20503846b3a7aa0f55a3c56670d66" alt=""><figcaption><p>Запуск Code Agent в терминале</p></figcaption></figure>

***

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

1. **Совместимость моделей**：
   * **Claude Code**: нужно выбрать модель, поддерживающую формат Anthropic API Endpoint. Предпочтительно использовать модели серии Claude; некоторые официальные платформы также предлагают совместимые с Claude Code модели — ориентируйтесь на список моделей и документацию провайдера.
   * **Qwen Code**: поддерживаются модели в формате OpenAI Chat Completions API; для лучшего качества генерации кода рекомендуется использовать модели серии Qwen Coder.
   * **Gemini CLI**: нужно выбрать модели серии Google Gemini.
   * **OpenAI Codex**: нужно выбрать модели серии GPT, совместимые с OpenAI / Codex; конкретная поддержка зависит от текущего аккаунта и провайдера модели.
   * **iFlow CLI** / **GitHub Copilot CLI** / **Kimi CLI** / **OpenCode**: требуется выбрать API-модель, совместимую с протоколом платформы; обычно она предоставляется через официальный канал соответствующего провайдера или API-агрегатор.
   * **Примечание**: сторонние шлюзы (например, One API, New API и т. п.), даже если они могут проксировать модели с тем же названием, не обязательно совместимы с методом аутентификации, форматом Endpoint или протоколом вызова инструментов соответствующего CLI. Если запуск не удаётся, в первую очередь используйте модельный сервис, официально поддерживаемый этим CLI.
2. **Зависимости и конфликты среды**：
   * Внутри Cherry Studio встроены отдельная среда выполнения Node.js, исполняемые файлы Code Agent и настройка переменных окружения, чтобы обеспечить чистую среду «из коробки».
   * Если при запуске Agent вы столкнётесь с конфликтами зависимостей или странными ошибками, можно временно **удалить или отключить связанные зависимости, уже установленные в системе**(например, глобально установленный Node.js или определённый набор инструментов), чтобы исключить конфликт.
3. **Предупреждение о расходе API-токенов**：
   * **Code Agent расходует API-токены очень активно**. При выполнении сложных задач Agent может отправлять большое количество запросов для размышления, планирования и генерации кода, что приводит к быстрому расходу токенов.
   * Обязательно исходя из своего лимита API и бюджета,**действуйте разумно**, внимательно следите за использованием токенов, чтобы не выйти за рамки бюджета.

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

***

### 💡 Получить помощь и отправить отзыв

Если вы в процессе настройки или использования столкнётесь с любыми вопросами, багами или предложениями по улучшению функций, пожалуйста, обратитесь к [Обратная связь и предложения](/docs/russian/question-contact/suggestions.md) официальным каналам, указанным там.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/russian/advanced-basic/code-tools.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.