AI 中轉站設定指南

CLI 工具總覽

CLI 是命令行工具，不是一個具體軟件。Claude Code、Codex CLI、Gemini CLI、OpenClaw、OpenCode 都屬於這類工具：你在終端裡輸入自然語言，它們可以讀取項目、解釋代碼、生成文件、運行命令或幫你完成開發任務。

官方信息 下載和文檔以官方站點為準

Claude Code 官方說明和安裝入口 Codex CLI OpenAI 官方 CLI 文檔 Gemini CLI Google 官方 CLI 文檔 OpenClaw 終端和 Web UI 編碼助手 OpenCode 開源終端 AI 編碼助手

CLI 工具比普通聊天軟件更強，也更容易誤操作。新手第一次配置時，只在測試項目裡運行，先讓它“只解釋，不修改，不執行命令”。

準備項	說明	為什麼重要
終端	Windows 用 PowerShell，macOS / Linux 用 Terminal	CLI 都在終端裡運行
工具本體	先安裝 Claude Code、Codex CLI、Gemini CLI、OpenClaw 或 OpenCode	配置文件只對已安裝工具生效
Key / 登錄方式	可能是官方登錄、API Key、OAuth 或中轉站 Key	不同 CLI 認證方式不一樣
Base URL	只有走中轉站或代理時才需要	不同協議的地址後綴可能不同，不能只改域名
測試項目	新建一個空文件夾或複製項目副本	避免第一次配置時改壞真實項目

中轉站文檔裡的 URL 通常是它自己的示例。你真正填寫時，要換成自己服務商後臺給出的 API 地址和 Key；如果它分別提供 OpenAI、Claude、Gemini 三種接口，不要把三種地址混著用。

Claude Code 配置 Claude Code 的 Key、Base URL、模型和 settings.json。

Codex CLI 配置 Codex 終端工具的 config.toml、自定義 Provider 和測試方式。

Gemini CLI 配置 Gemini CLI 的 Google 登錄、API Key 和中轉站注意事項。

OpenClaw 配置 OpenClaw 的 baseUrl 與 api 字段成對配置。

OpenCode 配置 OpenCode 的連接嚮導、配置文件位置和手動配置注意事項。

你現在要做什麼	建議打開	為什麼
只想統一切換多個 CLI 的服務商	CC-Switch 通用步驟	CC-Switch 更適合集中管理 Provider，再分發到 Claude、Codex、Gemini 等工具
只配置 Claude Code	Claude Code 配置	Claude Code 重點看 Anthropic / Claude 相關 Key、Base URL、模型名和 settings.json
只配置 Codex CLI	Codex 配置	Codex 重點看 config.toml、OpenAI 兼容 Provider、模型名和環境變量
只配置 Gemini CLI	Gemini 配置	Gemini 的登錄方式、Key 和 Vertex / Gemini 接口與 OpenAI 兼容接口不同
使用 OpenClaw / OpenCode	OpenClaw / OpenCode	這兩個工具的 Provider 字段會隨版本變化，應該看對應頁面和官方文檔

風險	容易發生在哪裡	建議
工具能讀項目文件	Claude Code、Codex、Gemini、OpenClaw、OpenCode	第一次只在測試目錄運行，不要直接打開真實生產項目
模型會執行或建議命令	所有代碼 CLI	先開啟確認模式，遇到刪除、移動、安裝、上傳等動作要逐條看清
配置項互相覆蓋	系統環境變量、項目配置、用戶配置、CC-Switch	配置不生效時先查優先級，不要同時改多處
協議混用	OpenAI、Claude、Gemini、Vertex、中轉站兼容接口	服務商後臺給哪一種接口，就按哪一種工具頁面填寫
複製了別人的示例	第三方教程、截圖、舊文檔	示例裡的 URL、Key、模型名都要換成自己的服務商後臺內容

配置完成後，不要馬上讓 CLI 修改真實項目。先新建一個空目錄，放一個簡單的測試文件，讓工具只讀取、只解釋、不要改文件。

可以複製給 CLI 的安全測試指令

請先只閱讀當前目錄。 請告訴我這裡有哪些文件。 不要修改任何文件。 不要運行任何命令。 不要安裝任何依賴。

如果這一步都不能正常返回，再去對應的問題排查頁面。不要在沒確認配置成功前，把真實項目交給 CLI 自動處理。