命令列與代理程式工具
根據使用場景、協議和權限範圍選擇適合的 AGTCloud 開發工具。
AGTCloud 可以串接命令列代理程式、IDE 擴充、桌面用戶端和設定管理工具。選擇工具時，先確認工作方式和協議，再評估它能夠存取的檔案、命令和外部服務。
本頁用於快速選擇教學，不重複各工具的安裝和設定步驟。進入具體教學後，請按照其中的 Base URL、身分驗證和模型要求完成串接。
代理程式工具可能執行本機操作
部分工具能夠讀取和修改檔案、執行 Shell 命令或存取網路。首次串接請使用不含敏感資料的測試目錄，關閉自動核准，並從唯讀任務開始驗證。
按工具選擇
| 工具 | 使用形態 | AGTCloud 串接協議 | 更適合 |
|---|---|---|---|
| Claude Code | 終端機程式開發代理程式 | Anthropic Messages | 已經使用 Claude Code 工作流程，希望保留 Messages 與 Content Blocks 結構 |
| Codex | CLI 與桌面 App | OpenAI Responses | 使用 Responses、Typed Items 或 Codex 專案工作流程 |
| Gemini CLI | 終端機代理程式 | Gemini Generate Content | 已經採用 Gemini Contents 與 Parts 結構 |
| Cline | IDE 擴充 | OpenAI Chat Completions | 希望在 VS Code 相容編輯器或 JetBrains 中審閱代理程式操作 |
| Cherry Studio | 桌面聊天用戶端 | OpenAI Chat Completions | 需要圖形介面的多模型聊天和基本連線驗證 |
| OpenClaw | 自行託管 Gateway、TUI 與 Control UI | OpenAI Chat Completions | 需要本機 Gateway 和可擴充的個人代理程式執行環境 |
| CC-Switch | 本機設定管理工具 | Anthropic Messages、OpenAI Responses | 需要儲存並切換 Claude Code 與 Codex 的 Provider 設定 |
| Hermes Agent | 終端機代理程式 | OpenAI Chat Completions | 需要 Custom Endpoint、終端機工作階段和工具呼叫工作流程 |
協議名稱不代表模型廠商。同一個模型可能提供多種協議入口，但工具呼叫、多模態、推理和上下文能力仍以目前模型的實際支援範圍為準。
按任務選擇
| 目標 | 建議優先檢視 | 選擇理由 |
|---|---|---|
| 在終端機中完成程式碼分析和修改 | Claude Code、Codex、Gemini CLI | 三者都有完整的終端機工作流程，但使用的協議結構不同 |
| 在 IDE 中逐步審閱檔案和命令操作 | Cline | 操作計畫、檔案變化和授權過程集中在編輯器中 |
| 使用圖形介面進行一般模型對話 | Cherry Studio | 設定服務供應商和模型後即可從聊天介面驗證連線 |
| 執行本機、自行託管代理程式 | OpenClaw、Hermes Agent | 提供 Gateway 或 CLI 代理程式執行方式，需要更嚴格的主機權限控制 |
| 管理多套 Claude Code 或 Codex 設定 | CC-Switch | 適合在本機儲存並切換 Provider，不替代實際發起請求的用戶端 |
| 連線外部工具和資料源 | MCP 串接與安全 | MCP 是用戶端與工具服務之間的協議，不等同於模型 API |
串接前確認
1. 確認使用形態
決定需要終端機、IDE、桌面聊天還是自行託管 Gateway。不要只依據工具名稱選擇，先確認它能否適應團隊的審核和權限管理方式。
2. 確認協議
從模型廣場複製目前 API Key 可用的模型 ID，並確認該模型支援教學所要求的 Chat Completions、Responses、Anthropic Messages 或 Gemini Generate Content 入口。
4. 閱讀權限說明
核對工具能夠存取的目錄、命令、網路和外部服務。預設關閉自動核准，只開放完成目前任務所需的最小範圍。
分階段驗證
| 階段 | 建議任務 | 通過標準 |
|---|---|---|
| 基本連線 | 只回覆一段固定文字，不呼叫工具 | 能夠傳回內容，Provider、Base URL 和模型符合預期 |
| 唯讀檔案 | 讀取測試目錄中的 README.md 並概括 | 沒有寫入檔案，也沒有執行未核准命令 |
| 受控工具 | 執行一項可撤銷、影響範圍明確的操作 | 用戶端展示操作內容並經過確認，結果與預期一致 |
| 專案任務 | 在版本控制保護下處理真實專案 | 變更可審閱、可回退，並能透過專案現有檢查 |
不要把“用戶端成功啟動”當作串接完成。至少要確認實際請求使用了預期的 Provider、模型和協議，並檢查工具沒有越過授權範圍。
常見選擇問題
| 問題 | 處理建議 |
|---|---|
| 工具能夠對話，但無法呼叫工具 | 先確認目標模型和協議是否支援工具呼叫，再檢查用戶端版本與工具權限 |
| 同一個模型在不同工具中表現不同 | 對比協議、系統提示、工具 Schema、上下文和用戶端預設參數 |
| 設定正確但仍請求其他 Provider | 完全重新啟動用戶端，並檢查使用者層級設定、環境變數和目前啟用的 Provider |
Base URL 傳回 404 | 按具體教學確認應填寫 API Origin、/v1 Base URL 還是由用戶端自動串接路徑 |
| 不確定是否允許自動核准 | 保持關閉；只有在任務、目錄和命令邊界都明確時再逐項開放 |
| 需要連線資料庫、檔案系統或業務服務 | 先閱讀 MCP 串接與安全，並核對服務來源和權限 |
安全建議
- 從工具官方管道下載安裝套件或命令，升級前閱讀版本說明；
- 為不同工具使用便於獨立停用和稽核的 API Key；
- 在版本控制或備份保護下執行會修改檔案的任務；
- 不向模型提交密碼、客戶資料、正式環境資料或其他非必要敏感資訊；
- 檢查工具記錄、工作階段匯出和當機報告中是否包含 Key、路徑或業務資料；
- 停止使用工具後，刪除其中儲存的憑證並撤銷不再需要的權限。
如果已經確定工具，請從 CC-Switch 整合教學開始，或直接選擇上表中的對應工具。介面欄位和回應結構請以 API Reference 為準。