> 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/advanced-basic/code-tools.md). # Code Tools使用ガイド Code Tools は Cherry Studio 内で、Claude Code、Qwen Code、Gemini CLI、OpenAI Codex、iFlow CLI、GitHub Copilot CLI、Kimi CLI、OpenCode など、さまざまな AI プログラミング CLI ツールを直接起動・管理できます。このチュートリアルでは Cherry Studio v1.9.9 を例に、完全な設定手順を案内します。 *** ### 操作手順 #### 1. Cherry Studio のバージョンを確認 まず、Cherry Studio が現在の正式版にアップグレードされていることを確認してください。以下へ移動できます [クライアントのダウンロード](/docs/jp/cherry-studio/download.md)、[GitHub Releases](https://github.com/CherryHQ/cherry-studio/releases) または [公式サイト](https://cherryai.com.cn/download) インストールパッケージをダウンロードしてください。 #### 2. Code Tools 画面に入る 上部ナビゲーションモード：画面上部の `+` 号をクリックしてランチャーを開き、次に **Code**。

上部の + をクリックしてランチャーを開く

ランチャーで Code をクリック

{% hint style="info" %} 左側ナビゲーションモードでは、左側ナビゲーションバー内の **Code** ボタンをクリックしてこのページに入れます。 {% endhint %} #### 3. CLI ツールを選択 必要に応じて、またお持ちの API Key に基づいて、使用する Code Agent ツールを 1 つ選択してください。現在は以下をサポートしています： * **Claude Code** * **Qwen Code** * **Gemini CLI** * **OpenAI Codex** * **iFlow CLI** * **GitHub Copilot CLI** * **Kimi CLI** * **OpenCode**

Code Agent ツールを選択

#### 4. Agent が呼び出すモデルを選択 モデルのドロップダウンリストで、選択した CLI ツールと互換性のあるモデルを選んでください。 *（詳細なモデル互換性の説明は、下記の「重要な注意事項」を参照してください）*

モデルを選択

#### 5. 作業ディレクトリを指定 クリック **ディレクトリを選択** ボタンで、Agent に作業ディレクトリを指定します。Agent はこのディレクトリ内のすべてのファイルとサブディレクトリへアクセスする権限を持ち、プロジェクトの文脈を理解し、ファイルを読み取り、コードを実行できるようになります。

作業ディレクトリを指定

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

環境変数の設定

#### 7. 更新オプション * **内蔵実行ファイル**：Cherry Studio には上記の Code Agent の実行ファイルが統合されており、通常は CLI を手動でインストールする必要はありません。 * **自動更新**：CLI ツールを常に最新バージョンに保ちたい場合は、 **更新を確認して最新バージョンをインストール**にチェックを入れてください。チェックすると、起動のたびにプログラムがオンラインで確認し、実行可能ツールパッケージを更新します。

更新オプション

#### 8. Agent を起動 すべての設定が完了したら、 **起動** ボタンをクリックしてください。Cherry Studio はシステム標準の Terminal（ターミナル）ツールを自動的に起動し、その中にすべての環境変数を読み込んでから、選択した Code Agent を実行します。これで、表示されたターミナルウィンドウで AI Agent と対話できます。

ターミナルで Code Agent を実行

*** ### 重要な注意事項 1. **モデル互換性の説明**に由来する： * **Claude Code**：Anthropic API Endpoint 形式をサポートするモデルを選択する必要があります。Claude 系モデルを優先してください。一部の公式プラットフォームでは Claude Code 互換モデルも提供されています。具体的にはモデルのドロップダウンリストと提供元の案内に従ってください。 * **Qwen Code**：OpenAI Chat Completions API 形式をサポートするモデルに対応しています。より良いコード生成結果を得るには、Qwen Coder 系モデルの使用を推奨します。 * **Gemini CLI**：Google Gemini 系のモデルを選択する必要があります。 * **OpenAI Codex**：OpenAI / Codex 互換の GPT 系モデルを選択する必要があります。具体的には、現在のアカウントとモデル提供元のサポート状況に従ってください。 * **iFlow CLI** / **GitHub Copilot CLI** / **Kimi CLI** / **OpenCode**：そのプラットフォームのプロトコルと相互互換性のある API モデルを選択する必要があります。通常は、対応する提供元の公式チャネルまたは API 集約ゲートウェイから提供されます。 * **注意**：サードパーティのゲートウェイ（One API、New API など）は、同名モデルを転送できても、対応 CLI の認証方式、Endpoint 形式、またはツール呼び出しプロトコルと必ずしも互換ではありません。起動に失敗した場合は、まずその CLI が公式にサポートしているモデルサービスを使用してください。 2. **依存関係と環境の競合**に由来する： * Cherry Studio には、独立した Node.js 実行環境、Code Agent の実行ファイル、および環境変数設定が組み込まれており、すぐに使えるクリーンな環境を提供することを目的としています。 * Agent の起動時に依存関係の競合や不可解なエラーが発生した場合は、一時的に **システムにインストール済みの関連依存関係をアンインストールまたは無効化し**（グローバルにインストールされた Node.js や特定のツールチェーンなど）して、競合を切り分けてください。 3. **API トークン消費の警告**に由来する： * **Code Agent は API トークンの消費量が非常に大きく**。複雑なタスクを処理する際、Agent は思考・計画・コード生成のために多数のリクエストを発生させる可能性があり、トークンが急速に消費されます。 * 必ずご自身の API 料金枠と予算に応じて、**無理のない範囲で**、トークン使用状況を注意深く確認し、予算超過を防いでください。 本チュートリアルが、Cherry Studio の強力な Code Agent 機能を素早く使いこなす助けになれば幸いです！ *** ### 💡 ヘルプの取得とフィードバックの送信 設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/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/jp/advanced-basic/code-tools.md?ask=&goal= ``` `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.