官网GitHub

Code Tools 使用チュートリアル

ツール

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

操作手順

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

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

2. ナビゲーションバーの位置を調整

トップのタブ機能を便利に使うために、ナビゲーションバーを上部に配置することを推奨します。

  • 操作手順：設定 -> 表示設定 -> ナビゲーションバー設定

  • 「ナビゲーションバーの位置」オプションを設定して、 上部。

3. 新しいタブを作成

画面上部の「＋」アイコンをクリックして、空の新しいタブを作成します。

4. Code Agent 機能を開く

新しく作成したタブで、次をクリックします。 Code（または </>）アイコンをクリックして、Code Agent の設定画面に入ります。

5. CLI ツールを選択

必要性やお持ちの API キーに応じて、使用する Code Agent ツールを選択してください。現在以下のものをサポートしています：

  • Claude Code

  • Gemini CLI

  • Qwen Code

  • OpenAI Codex

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

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

7. 作業ディレクトリを指定

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

8. 環境変数を設定

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

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

9. 更新オプション

  • 組み込み実行ファイル：Cherry Studio は上記のすべての Code Agent の実行ファイルを統合しており、ほとんどの場合、ネットワーク接続なしで直接使用できます。

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

10. Agent を起動

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

重要な注意事項

  1. モデル互換性の説明：

    • Claude Code: Anthropic API エンドポイント形式をサポートするモデルを選択する必要があります。現在公式でサポートされているモデルには以下が含まれます：

      • 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 機能の早期習得に役立つことを願っています！

前へコールチェーンの使用説明次へCherry Agent 使用チュートリアル

最終更新

役に立ちましたか？