Code Tools 使用教學

Tools

Cherry Studio v1.5.7 版本引入咗操作簡單、功能強大嘅 Code Agent 功能，可以直接啟動同管理多種 AI 編程 agent。本教學會引導您完成設置同啟動嘅完整流程。

---

操作步驟

1. 升級 Cherry Studio

首先，請確保您嘅 Cherry Studio 已經升級到 v1.5.7 或更高版本。您可以前往 GitHub Releases 或官方網站下載最新版本。

2. 進入 Code Tool 工具介面

頂部導航模式：點擊介面頂部嘅“+”號圖示，新建一個空白標籤頁

左側導航模式嘅情況下點擊左側導航入面嘅 Code Tool 按鈕進入該頁面

3. 選擇 CLI 工具

根據您嘅需求同所持有嘅 API Key，選擇一個要使用嘅 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 會自動調用您系統自帶嘅 Terminal（終端）工具，並喺入面加載好所有環境變量，然後運行您選擇嘅 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 Token 消耗警告：

   • Code Agent 對 API Token 嘅消耗量非常大。喺處理複雜任務時，Agent 為咗思考、規劃同生成代碼，可能會產生大量請求，導致 Token 快速消耗。

   • 請務必根據自己嘅 API 額度同預算，量力而為，密切關注 Token 使用情況，以免預算超支。

希望本教學可以幫助您快速上手 Cherry Studio 強大嘅 Code Agent 功能！