Code Tools 使用チュートリアル

ツール

Cherry Studio v1.5.7 では、操作が簡単で強力な Code Agent 機能が導入され、複数の AI プログラミングエージェントを直接起動・管理できるようになりました。本チュートリアルでは、設定と起動の全手順を案内します。

---

操作手順

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

まず、Cherry Studio が v1.5.7 以上にアップグレードされていることを確認してください。最新版は GitHub Releases または公式サイトからダウンロードできます。

2. Code Tool ツール画面に入る

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

左側ナビゲーションの場合は、左のナビゲーション内の Code Tool ボタンをクリックして該当ページに入ります

3. CLI ツールを選択する

ご利用のニーズと所持している API キーに応じて、使用する Code Agent ツールを選択してください。現在は以下がサポートされています：

• Claude Code

• Gemini CLI

• Qwen Code

• OpenAI Codex

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

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

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

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

6. 環境変数を設定する

• 自動構成：ステップ6（モデル）とステップ7（作業ディレクトリ）での選択に基づき、対応する環境変数が自動生成されます。

• カスタム追加：Agent やプロジェクトが他の特定の環境変数（例： PROXY_URL など）を必要とする場合は、この領域でカスタム追加できます。

7. オプションを更新する

• 組み込み実行ファイル：Cherry Studio は上記すべての Code Agent の実行ファイルを統合しており、多くの場合インターネット接続なしでそのまま利用できます。

• 自動更新：Agent を常に最新に保ちたい場合は、 更新をチェックして最新バージョンをインストールする オプションにチェックを入れてください。チェックを入れると、起動時に毎回ネットワーク接続で Agent ツールの更新確認と適用が行われます。

8. Agent を起動する

すべての設定が完了したら、 起動 ボタンをクリックします。Cherry Studio は自動的にシステム付属のターミナルを呼び出し、そこで全ての環境変数を読み込んで選択した Code Agent を実行します。ポップアップしたターミナルウィンドウで AI Agent と対話できます。

---

重要な注意事項

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 トークン消費の警告：

   • Code Agent は API トークンを大量に消費します。複雑なタスクを処理する際、Agent は思考、計画、コード生成のために多数のリクエストを発生させ、トークンが急速に消費される可能性があります。

   • 必ずご自身の API 割当と予算に応じて、無理のない範囲でトークン使用状況を注意深く監視し、予算超過を防いでください。

本チュートリアルが、Cherry Studio の強力な Code Agent 機能の早期習得に役立つことを願っています！