# Code Tools使用チュートリアル

Cherry Studio v1.5.7 版では、操作が簡単で強力な Code Agent 機能が導入され、複数の AI プログラミング agent を直接起動して管理できます。本チュートリアルでは、設定から起動までの一連の流れを案内します。

***

### 操作手順

#### 1. Cherry Studio をアップグレードする

まず、Cherry Studio が **v1.5.7** 以上にアップグレードされていることを確認してください。 [GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) または公式サイトから最新バージョンをダウンロードできます。

#### 2. Code Tool の画面に入る

上部ナビゲーションモード：画面上部の「+」アイコンをクリックして、新しい空白のタブを作成します

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-418f066aef26e03d31b30206c9cdfc3ecaa5d2c4%2Fimage%20(2)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-b42e875e93506534a3c5cebc72b95502a0595ad1%2Fimage%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
左側ナビゲーションモードの場合は、左側ナビゲーション内の Code Tool ボタンをクリックしてこのページに入ります
{% endhint %}

#### 3. CLI ツールを選択する

必要に応じて、またお持ちの API Key に基づいて、使用する Code Agent ツールを選択します。現在は以下をサポートしています：

* **Claude Code**
* **Gemini CLI**
* **Qwen Code**
* **OpenAI Codex**

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-ab7bc9ff839720c2777568a48d1ff71a2177741a%2Fimage%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 4. Agent が呼び出すモデルを選択する

モデルのドロップダウンリストから、選択した CLI ツールと互換性のあるモデルを選択してください。 *（詳細なモデル互換性については、下記の「重要な注意事項」をご参照ください）*

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-b8148d693337e9c06b403b3c46e7e15e0a03e72e%2Fimage%20(5).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 5. 作業ディレクトリを指定する

「ディレクトリを選択」ボタンをクリックして、Agent 用の作業ディレクトリを指定します。Agent はこのディレクトリ内のすべてのファイルとサブディレクトリにアクセスできるため、プロジェクトの文脈を理解し、ファイルを読み込み、コードを実行しやすくなります。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-26d4e51e4689e71727cbe6d938f9e74bb4c88f1a%2Fimage%20(6).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 6. 環境変数を設定する

* **自動設定**：第 6 ステップ（モデル）と第 7 ステップ（作業ディレクトリ）での選択に応じて、対応する環境変数が自動生成されます。
* **カスタム追加**：Agent やプロジェクトに他の特定の環境変数が必要な場合（例： `PROXY_URL` など）、この欄でカスタム追加できます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-7f0ac5497f2acfd266c4212c67f065bb12d19427%2Fimage%20(7).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 7. 更新オプション

* **内蔵実行ファイル**：Cherry Studio には、上記すべての Code Agent の実行ファイルが統合されています。ほとんどの場合、ネット接続なしでもそのまま使用できます。
* **自動更新**：Agent を常に最新バージョンに保ちたい場合は、 **`更新を確認して最新バージョンをインストール`** のオプションにチェックを入れてください。チェック後は、起動のたびにプログラムがネットワークに接続して Agent ツールを確認・更新します。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-8d32add7b26fbce23a777eb82d2614061fb339fb%2Fimage%20(8).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 8. Agent を起動する

すべての設定が完了したら、 **`起動`** ボタンをクリックします。Cherry Studio は自動的にシステム標準の Terminal（ターミナル）を呼び出し、そこにすべての環境変数を読み込んだうえで、選択した Code Agent を実行します。これで、表示されたターミナルウィンドウ内で AI Agent とやり取りできます。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-2a54f0893723d0dfca5a67c4c28c374d5d34a8a5%2Fimage%20(9).png?alt=media" alt=""><figcaption></figcaption></figure>

***

### 重要な注意事項

1. **モデル互換性の説明**に由来する：
   * **Claude Code**: Anthropic API Endpoint 形式をサポートするモデルを選択する必要があります。現在、公式にサポートされているモデルには以下が含まれます：
     * Claude 系モデル
     * DeepSeek V3.1（公式 API プラットフォーム）
     * Kimi K2（公式 API プラットフォーム）
     * 智譜 GLM 4.5（公式 API プラットフォーム）
     * **注意**：現在、多くのサードパーティサービスプロバイダー（One API、New API など）は、DeepSeek、Kimi、GLM の API インターフェースについて、ほとんどが OpenAI Chat Completions 形式のみをサポートしており、Claude Code と直接互換性がない可能性があります。サービスプロバイダー側の段階的な対応を待つ必要があります。
   * **Gemini CLI**：Google の Gemini 系モデルを選択する必要があります。
   * **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 使用状況をこまめに確認して、予算超過を防いでください。

このチュートリアルが、Cherry Studio の強力な Code Agent 機能を素早く使い始める助けになれば幸いです！