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

# コーディングパートナー

【コーディングパートナー】は、一般的なプログラミング用コマンドラインツールのインストール、設定、起動に使用します。Cherry Studio は自分で管理するインストールを認識するとともに、システムのログイン環境で既に利用可能な CLI も検出します。システムツールは従来どおり元のパッケージマネージャーで管理されます。

<figure><img src="/files/eb604dbdb63ef9742daf70b78c28212851f6b493" 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 を設定するとき、【モデル】には 2 つのモードがあります：

* 【汎用】：すべてのリクエストで同じモデルを使用するため、設定が簡単です；
* 【詳細】：【モデルロールマッピング】で Fable、Opus、Sonnet、Haiku、Subagent を個別に設定します。表の【実際のリクエストモデル】は各ロールが最終的に使用するモデルです。必要に応じて、対応するロールに【1M】コンテキストを有効にすることもできます。

バックグラウンドのサブタスク、要約、タイトルなどのロールに別のモデルを指定する必要が本当にある場合にのみ、【詳細】を使用してください。空欄のロールはメインモデルに従います。変更後は、まず小さなタスクで各ロールが正常にリクエストできるか確認してください。

## 使用シーン：プロジェクトディレクトリでコーディングツールを起動する

| 選択       | 推奨の開始値                                | 適用場面                   | 注意事項                               |
| -------- | ------------------------------------- | ---------------------- | ---------------------------------- |
| インストール元  | 既存のシステム版があるなら、まずそれを使用する               | チームですでに CLI が統一管理されている | 更新とアンインストールは引き続き元のパッケージマネージャーが担当する |
| モデル接続    | まず、Cherry Studio で利用可能と確認済みの接続を 1 つ選ぶ | モデルサービスが必要な 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/jp/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.
