Tools
Code Tools 可以喺 Cherry Studio 入面直接啟動同管理多種 AI 編程 CLI 工具，例如 Claude Code、Qwen Code、Gemini CLI、OpenAI Codex、iFlow CLI、GitHub Copilot CLI、Kimi CLI 同 OpenCode。本教程以 Cherry Studio v1.9.9 為例，帶你完成一次完整配置。
請先確認 Cherry Studio 已升級到而家正式版。你可以前往 客戶端下載、GitHub Releases 或者 官方網站 下載安裝包。
頂部導航模式：撳界面頂部嘅 + 號打開啟動台，然後撳 Code。
+
左側導航模式下，可直接撳左側導航欄入面嘅 Code 按鈕進入呢個頁面。
根據你嘅需求同手上持有嘅 API Key，揀一個要用嘅 Code Agent 工具。目前支援以下幾種：
Claude Code
Qwen Code
Gemini CLI
OpenAI Codex
iFlow CLI
GitHub Copilot CLI
Kimi CLI
OpenCode
喺模型下拉列表入面，揀同所選 CLI 工具兼容嘅模型。 （詳細嘅模型兼容性說明，請參考下方嘅「重要注意事項」）
撳 選擇目錄 按鈕，為 Agent 指定一個工作目錄。Agent 將會有權訪問呢個目錄下所有文件同子目錄，以便理解項目上下文、讀取文件同執行代碼。
自動配置：你喺第 4 步（模型）同第 5 步（工作目錄）入面嘅選擇，會自動生成相應嘅環境變量。
自定義添加：如果你嘅 Agent 或項目需要其他特定嘅環境變量（例如 PROXY_URL 等），可以喺呢個區域自定義添加。
PROXY_URL
內置可執行文件：Cherry Studio 已整合上述 Code Agent 嘅可執行文件，通常唔需要手動安裝 CLI。
自動更新：如果想 CLI 工具一直保持最新版本，可以剔選 檢查更新並安裝最新版本。剔選之後，每次啟動時程式都會聯網檢查並更新可執行工具包。
所有配置完成後，撳 啟動 按鈕。Cherry Studio 會自動調用系統自帶嘅 Terminal（終端）工具，並喺入面載入好所有環境變量，然後運行你揀嘅 Code Agent。你而家可以喺彈出嘅終端窗口入面同 AI Agent 互動。
模型兼容性說明：
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 官方支援嘅模型服務。
依賴同環境衝突：
Cherry Studio 內部整合咗獨立嘅 Node.js 運行環境、Code Agent 可執行文件同環境變量配置，旨在提供一個開箱即用嘅純淨環境。
如果你喺啟動 Agent 時遇到依賴衝突或者古怪嘅錯誤，可以考慮暫時 卸載或禁用系統內已安裝嘅相關依賴（如全局安裝嘅 Node.js 或特定工具鏈），以排除衝突。
API Token 消耗警告：
Code Agent 對 API Token 嘅消耗量非常大。喺處理複雜任務時，Agent 為咗思考、規劃同生成代碼，可能會產生大量請求，導致 Token 快速消耗。
請務必根據自己嘅 API 額度同預算，量力而為，密切留意 Token 使用情況，以防止預算超支。
希望本教程可以幫你快速上手 Cherry Studio 強大嘅 Code Agent 功能！
如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 反饋同建議 入面提供嘅官方渠道。
最後更新 1 個月前
呢個有冇幫助？
