Code Tools 使用教程
Tools
Cherry Studio v1.5.7 版本加入咗好易用、強大嘅 Code Agent 功能，可以直接啟動同管理多種 AI 編程 agent。本教學會引導你完成設定同啟動嘅整個流程。
操作步驟
1. 升級 Cherry Studio
首先，請確保你嘅 Cherry Studio 已經升級到 v1.5.7 或更高版本。你可以去 GitHub Releases 或者官方網站下載最新版本。
2. 調整導航欄位置
為咗方便使用頂部標籤頁功能，我哋建議將導航欄調整到頂部。
操作路徑：
設定->顯示設定->導航欄設定將「導航欄位置」選項設為
頂部。
3. 新建標籤頁
點擊介面頂部嘅「+」號圖示，新建一個空白標籤頁。
4. 打開 Code Agent 功能
喺新建嘅標籤頁入面，點擊 Code（或 </>）圖示，進入 Code Agent 配置介面。
5. 選擇 CLI 工具
根據你嘅需求同所持有嘅 API Key，揀一個要使用嘅 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 會自動調用你系統自帶嘅 Terminal（終端）工具，並喺入面加載好所有環境變量，然後運行你選擇嘅 Code Agent。依家你可以喺彈出嘅終端窗口入面同 AI Agent 互動。
重要注意事項
模型相容性說明：
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等）。
依賴與環境衝突：
Cherry Studio 內部集成咗獨立嘅 Node.js 運行環境、Code Agent 可執行文件同環境變量配置，目標係提供一個即開即用嘅純淨環境。
如果你喺啟動 Agent 時遇到依賴衝突或者奇怪嘅錯誤，可以考慮暫時卸載或禁用系統內已安裝嘅相關依賴（例如全局安裝嘅 Node.js 或特定工具鏈），以排除衝突。
API Token 消耗警告：
Code Agent 對 API Token 嘅消耗量非常大。喺處理複雜任務時，Agent 為咗思考、規劃同生成代碼，可能會產生大量請求，導致 Token 快速消耗。
請務必根據自己嘅 API 額度同預算，量力而為，密切關注 Token 使用情況，以免預算超支。
希望本教學可以幫到你快速上手 Cherry Studio 強大嘅 Code Agent 功能！
Last updated
Was this helpful?