讓 Claude Code 直接跑 GPT 模型






CLIProxyAPI 最近在社群上很常被提到,連 OpenAI Codex 團隊的負責人 Tibo(Thibault Sottiaux)都發推文推薦。他的說法是三步驟就搞定:裝好、連上、設一個 alias(幫一長串指令取一個好記的短名字),就能在 Claude Code 的介面裡直接跑 GPT 模型。
那個 alias 長這樣:
alias claudex='CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.6-sol \
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1 \
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3 \
ENABLE_TOOL_SEARCH=false \
claude --model gpt-5.6-sol'
打 claudex,就等於開一個「介面是 Claude Code、腦是 GPT」的組合——主模型和子代理都指到 gpt-5.6-sol,後面幾個環境變數是配合 GPT 後端調的 Claude Code 行為。聽起來很美,但我照著裝了一輪,覺得沒有他講的那麼簡單。
這篇講三件事:它到底在幫你做什麼、為什麼中間非得卡一層 proxy(就是中間的翻譯員,原理),還有我自己更推、設定簡單很多的 cc-switch。
它在幫你做什麼
一句話:讓你用 Claude Code 的操作介面,跑 OpenAI 的模型。
這篇是給這種人看的:習慣 Claude Code 的互動方式和 agent 流程,但想試 gpt-5.6 系列的模型;或者手上有 ChatGPT/Codex 訂閱,想物盡其用。CLIProxyAPI 就是把這兩件事接起來的中間人。
「三步驟」沒告訴你的
實際裝的時候,步驟比推文上多不少。CLIProxyAPI 是一支用 Go 寫的自架伺服器(MIT 授權),你得先把它跑起來——下載執行檔、用 Docker,或自己 build 都行;接著對每個要用的帳號跑一次 OAuth 授權(沿用你已經登入的帳號,免自己貼 API key);最後把 Claude Code 的 ANTHROPIC_BASE_URL 指到本機的 proxy(預設 http://127.0.0.1:8317),另外塞一個假的 token。
而且官方 README 講得很省,有些設定沒寫全。實際上你得照 https://help.router-for.me/agent-client/claude-code 這頁一步步對,才會真的通。對只想試個模型的人來說,有點大費周章。
中間為什麼一定要卡一個 proxy
這是這個工具的核心,也是我覺得值得多講的地方。
Claude Code 說的是 Anthropic 的 Messages API 格式(Claude 那套請求/回應結構);GPT、Codex 說的是另一套——端點、訊息格式、串流事件、連 tool call 的寫法都不一樣。兩邊語言不通,直接接會壞。
proxy(代理,中間負責轉發並轉換的那一層)就是那個翻譯。它在你本機開一個「長得像 Anthropic」的端點,你只要把 Claude Code 的 ANTHROPIC_BASE_URL 指過去。之後的流程是:
Claude Code 送出 Anthropic 格式的請求 → proxy 把它翻成 OpenAI/Codex 格式 → 用你 OAuth 綁好的 ChatGPT/Codex 訂閱送到真正的後端 → 回來的內容再翻回 Anthropic 格式 → Claude Code 當作什麼都沒發生,照常顯示。
所以它不是單純的 API key 轉接,是一層即時的雙向翻譯。想通這件事你就會發現:真正有價值的是「翻譯」本身;至於這層翻譯是自己架一台 server 來做、還是用現成的 app 幫你做,是可以選的。
我會直接用 cc-switch
cc-switch 本來是一個桌面 app,用來一鍵切換 Claude Code、Codex、Gemini CLI 各種供應商的設定。重點是它內建一個「本地 router」——打開之後做的,其實就是上面那件事:格式轉換,把 Claude Code 接到非 Anthropic 的模型。
差別全在設定的麻煩程度。CLIProxyAPI 要你自己跑 server、設環境變數;cc-switch 是在它的介面上點一點、把 router 打開就好,不用碰終端機。
安裝也單純:
brew install --cask cc-switch
Mac、Windows、Linux 都有,一樣是開源 MIT。
那要不要完全不用 CLIProxyAPI
也不是。如果你要的是一台可以自架、能寫腳本、同時服務多個用戶端或多個帳號的閘道,跑在自己機器或 Docker 上,CLIProxyAPI 的彈性才用得上。但如果你只是想在 Claude Code 裡試跑 GPT 模型,不想順便顧一台 server,cc-switch 點一點就到位。
說到底,你要的只是中間那層翻譯。能在介面上點一點解決的事,就不用自己養一台 server。
最近開始做免費的一對一諮詢,幫你把 AI 接進自己的工作流——有需要的話可以約:https://www.dawsonwang.com/
- Tibo 推文:https://x.com/thsottiaux/status/2076119366647894371
- CLIProxyAPI:https://github.com/router-for-me/CLIProxyAPI
- CLIProxyAPI 設定 Claude Code:https://help.router-for.me/agent-client/claude-code
- cc-switch:https://github.com/farion1231/cc-switch