> 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/cherry-studio/preview/code-cli.md).

# Партнер по коду

【Кодовый напарник】用于安装、配置和启动常ие программные CLI-инструменты. Cherry Studio распознаёт собственные управляемые установки и также обнаруживает уже доступные в среде входа в систему CLI; системные инструменты по-прежнему обслуживаются исходным пакетным менеджером.

<figure><img src="/files/9d1670855a592eaed8e9eeab4e9c5e57771ce41d" alt="编码搭档页面中的安装状态、版本检查和 Code CLI 提供方"><figcaption><p>Сначала убедитесь, что инструмент установлен и его версия доступна, затем настройте подключение к модели и каталог проекта.</p></figcaption></figure>

## Что может делать эта страница

* Проверять, установлен ли инструмент и доступны ли обновления;
* Устанавливать или обновлять управляемую Cherry Studio копию инструмента;
* Обнаруживать уже имеющиеся инструменты в системном PATH;
* Выбирать провайдера и модель для CLI, которому требуется сервис модели;
* Сохранять нативный способ входа для CLI, которые используют собственную учётную запись;
* Выбирать рабочий каталог и терминал, обнаруженный системой, а затем запускать.

На странице сейчас есть такие инструменты, как Claude Code, OpenAI Codex, Gemini CLI, OpenCode, Qwen Code, Kimi Code, Qoder CLI и GitHub Copilot CLI. Фактически видимые элементы будут меняться вместе с обновлениями продукта; ориентируйтесь на список на странице.

## Порядок использования

{% stepper %}
{% step %}

### 1. Откройте пункт слева 【Кодовый напарник】

Выберите нужный инструмент и сначала посмотрите его статус: не установлен, управляется Cherry Studio или установлен в системе.
{% endstep %}

{% step %}

### 2. Завершите установку или вход

Если не установлен, нажмите 【Установить】. Для CLI, которые сами предоставляют вход по аккаунту, завершите нативный вход по подсказкам страницы; выбирать провайдера в Cherry Studio не нужно.
{% endstep %}

{% step %}

### 3. Настройте подключение к модели

Для инструментов, которым нужен сервис моделей Cherry Studio, выберите совместимого провайдера и модель. Страница фильтрует варианты по типу интерфейса, необходимому CLI; несовместимые провайдеры не будут показаны.
{% endstep %}

{% step %}

### 4. Выберите каталог и терминал

Рабочий каталог определяет, где запускается CLI. Терминал можно выбрать только из списка, обнаруженного системой; путь к пользовательскому исполняемому файлу терминала больше не предоставляется.
{% endstep %}

{% step %}

### 5. Запустите и проверьте

Нажмите 【Запустить】 и выполните в терминале проверку только для чтения. Убедитесь, что учётная запись, модель и каталог указаны правильно, прежде чем выполнять изменение файлов или команды.
{% endstep %}
{% endstepper %}

## Режимы модели Claude Code

При настройке Claude Code в разделе 【Модель】 доступны два режима:

* 【Универсальный】: для всех запросов используется одна и та же модель, настройка простая;
* 【Подробный】: отдельно задаются Fable, Opus, Sonnet, Haiku и Subagent в 【Сопоставлении ролей модели】. 【Фактическая модель запроса】 в таблице — это модель, которую в итоге использует каждая роль; при необходимости для соответствующих ролей можно также включить контекст 【1M】.

Используйте 【Подробный】 только если действительно нужно назначить разные модели для ролей вроде фоновых подзадач, сжатия или заголовков. Пустые роли будут следовать основной модели. После изменений сначала проверьте маленькой задачей, что каждый role может корректно отправлять запросы.

## Сценарий использования: запуск инструмента кодирования в каталоге проекта

| Выбор                | Рекомендуемая отправная точка                                        | Сценарий применения                          | Примечания                                                                 |
| -------------------- | -------------------------------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------- |
| Источник установки   | Если уже есть системная версия, сначала используйте её               | CLI уже централизованно управляются командой | Обновление и удаление по-прежнему выполняются исходным пакетным менеджером |
| Подключение к модели | Сначала выберите уже проверенное в Cherry Studio рабочее подключение | CLI, которым требуется сервис модели         | Инструменты со встроенным входом по аккаунту входят через нативный процесс |
| Рабочий каталог      | Выбирайте только текущий каталог проекта                             | Изменение кода, запуск проверок              | После запуска сначала убедитесь в пути, в котором открыт терминал          |
| Первая команда       | Просмотр статуса проекта только для чтения                           | Проверка учётной записи, модели и каталога   | Только после подтверждения правильности разрешайте запись файлов           |

### Критерии завершения

Страница может распознавать источник установки; терминал открыт в правильном каталоге; минимальная команда только для чтения выполнена успешно; учётная запись или модель, показываемые инструментом, соответствуют ожидаемым.

## Нужно различать источники установки

| Источник                 | Что делает Cherry Studio                                           | Как вам следует это поддерживать                              |
| ------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------- |
| Управляемо Cherry Studio | Установка, обновление и удаление соответствующих управляемых копий | Управление в 【Кодовом напарнике】 или 【Зависимостях окружения】 |
| Системный PATH           | Обнаруживать и использовать напрямую, не перезаписывая             | Обновлять или удалять через исходный пакетный менеджер        |
| Встроенное в приложение  | Использовать напрямую, не предоставляя системное удаление          | Обновляется вместе с Cherry Studio                            |

{% hint style="warning" %}
После удаления управляемой Cherry Studio копии, если в системе всё ещё есть исполняемый файл с тем же именем, страница автоматически откатится к системной версии. Когда версия или поведение меняются, сначала проверьте, какой именно источник используется сейчас.
{% endhint %}

<details>

<summary>Почему не удаётся найти уже установленный терминал или CLI?</summary>

Cherry Studio обнаруживает инструменты в среде входа и в стандартных местах. Убедитесь, что команда запускается в терминале входа, затем перезапустите приложение, чтобы обновить окружение. Для портативных или нестандартных путей сейчас нужно запускать вручную из этого терминала.

</details>


---

# 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/cherry-studio/preview/code-cli.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.