CLIProxyAPI 是什麼？快速打造自己的 AI API 統一入口

CLIProxyAPI 是什麼？
#

CLIProxyAPI 是一個開源的 Proxy Server，可以把 Codex、Claude Code、Gemini 等API 或訂閱帳號整合成的一個入口點。如果都有串接，只需要一個 API 入口點就能使用所有已登錄的模型。

警告，許多服務商 (如:Anthropic、Google)，已有明文禁止將訂閱憑證轉接到第三方工具或 Proxy 上使用，所以不建議將訂閱服務轉接到 CLIProxyAPI 上使用，有可能導致帳號被鎖。

如何設定？
#

安裝步驟按照 CLIProxyAPI 教學跟著做。

將 config.example.yaml 複製成 config.yaml，然後照著教學做即可，我的配置如下:

yaml

host: "" # 不寫的話就是走 localhost 
port: 8317 # 預設走 8317 prot

tls:
  enable: false
  cert: ""
  key: ""

# 管理後台：保護 /v0/management
remote-management:
  # 是否允許遠端管理；true = 可從其他機器管理
  # 這個是「管理金鑰」，不是 API 進入金鑰
  allow-remote: true
  secret-key: "${page_password}"
  disable-control-panel: false

auth-dir: "~/.cli-proxy-api"

# API 進入金鑰：用來驗證外部請求是否可呼叫這個代理
api-keys:
  - "${api_key}"

debug: false
logging-to-file: true
usage-statistics-enabled: false

routing:
  strategy: "round-robin"

# WebSocket 也要驗證身份
ws-auth: true

設定完成後，看是要執行檔直接啟動，或是用 docker 跑起來吧可以。

我這裡是用 docker 快速跑起來。

如果配置跟我一樣，打開 http://127.0.0.1:8317/management.html ，就會看管理頁面了。

輸入在 config.xml 上設定的管理密碼進行登入。
選擇 AI供應商，這裡把你我的服務商提供的 api key 與 服務位址 填寫進來。
選擇 OAuth登入 ，則可以把訂閱的帳號接進來管理，但不推薦因為有可能導致帳號被鎖 (雖然截至目前 OpenAI 尚未明訂不能接到 Proxy 使用)。
新增完成之後，進到檔案驗證管理，就會看到已經串接的服務商。
接著進到設定面板，新增一組 API Key。
複製 API Key，用 curl 指令直接測試 API 是否有回應。

bash

curl http://127.0.0.1:8317/v1/responses \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "input": "請只回答：gpt-5.6-luna 測試成功"
  }'