CLIProxyAPI 快速上手指南：把 Claude Code / Codex / Grok 统一成一个本地 API

发表于 2026-07-24 更新于 2026-08-30 分类于 AI工具

如果你同时买了 ChatGPT Plus/Pro、Claude Pro、Grok、Kimi 等多个 AI 订阅，会发现每个 CLI 工具只能绑定自家模型：Claude Code 默认走 Anthropic，Codex 默认走 OpenAI。换个工具就得换个入口，账号和配额各管各，非常割裂。

CLIProxyAPI 做的就是把这些订阅统一收敛到一个本地 API 网关。启动后，你可以用同一套 endpoint 和 API Key，在 Claude Code、Codex、OpenClaw 或其他兼容客户端里自由切换模型。

一、CLIProxyAPI 是什么

CLIProxyAPI（github.com/router-for-me/CLIProxyAPI）是一个基于 Go 编写的开源代理服务，主要能力：

把 Codex / Claude Code / Grok / Kimi / Gemini 等订阅转成兼容 OpenAI、Anthropic、Gemini、Codex 协议的本地 API
支持 OAuth 登录，不需要额外购买各平台 API Key
支持 多账号轮询，一个订阅触顶自动切到下一个
支持 负载均衡（round-robin / fill-first）和 会话亲和
支持代理、热重载、WebUI 管理

简单说：它让你花一份订阅钱，让所有 AI 编程工具都能调用所有模型。

二、下载与安装

1. 从 GitHub Releases 下载

打开 Releases 页面，下载对应系统压缩包。以 Windows 64 位为例：

# 用 PowerShell 下载（也可直接浏览器下载）
Invoke-WebRequest `
  -Uri "https://github.com/router-for-me/CLIProxyAPI/releases/download/v7.2.97/CLIProxyAPI_7.2.97_windows_amd64.zip" `
  -OutFile "CLIProxyAPI.zip"

Expand-Archive -Path "CLIProxyAPI.zip" -DestinationPath "CLIProxyAPI"
cd CLIProxyAPI

解压后目录结构如下：

CLIProxyAPI/
├── cli-proxy-api.exe
├── config.example.yaml
├── README.md
└── README_CN.md

2. 其他系统

系统	压缩包
Windows ARM64	`CLIProxyAPI_7.2.97_windows_aarch64.zip`
macOS Intel	`CLIProxyAPI_7.2.97_darwin_amd64.tar.gz`
macOS Apple Silicon	`CLIProxyAPI_7.2.97_darwin_aarch64.tar.gz`
Linux AMD64	`CLIProxyAPI_7.2.97_linux_amd64.tar.gz`
Linux ARM64	`CLIProxyAPI_7.2.97_linux_aarch64.tar.gz`

Linux/macOS 解压后建议把二进制放到 ~/.local/bin 或 /usr/local/bin，方便全局调用。

三、最小配置文件

复制示例配置并修改：

1	cp config.example.yaml config.yaml

下面是一个本地最小可用配置，你只需要改三处：端口、代理、API Key。

# config.yaml
host: "127.0.0.1"
port: 8317

# 如果你在中国大陆，需要代理才能访问 OpenAI/Claude/Grok
proxy-url: "http://127.0.0.1:7890"

# 认证文件存放目录，OAuth 登录后会自动生成
auth-dir: "~/.cli-proxy-api"

# 客户端访问 CLIProxyAPI 时使用的 API Key
# 相当于你自己给本地网关设的密码
api-keys:
  - "sk-cliproxy-local"

# 多账号轮询：某个账号触发限额后自动切换
quota-exceeded:
  switch-project: true
  switch-preview-model: true
  antigravity-credits: true

# 路由策略：round-robin 为轮询，fill-first 为优先填满
routing:
  strategy: "round-robin"

# 日志与调试
debug: false
logging-to-file: false
usage-statistics-enabled: true
request-retry: 3

提示：配置文件支持热重载，修改后无需重启程序即可生效。

四、OAuth 登录各平台

CLIProxyAPI 的核心优势是走 OAuth，用你现有的订阅账号登录，不需要再买 API Key。

Codex（ChatGPT 订阅）

1	./cli-proxy-api.exe -config config.yaml -codex-login -no-browser

运行后会输出一个 https://auth.openai.com/... 链接。把链接贴到浏览器，登录你的 ChatGPT 账号并授权。授权成功后，CLIProxyAPI 会自动把凭证存到 ~/.cli-proxy-api/。

Claude Code（Anthropic 订阅）

1	./cli-proxy-api.exe -config config.yaml -claude-login -no-browser

同样在浏览器完成 Claude 账号授权。

Grok（xAI 订阅）

1	./cli-proxy-api.exe -config config.yaml -xai-login -no-browser

Kimi

1	./cli-proxy-api.exe -config config.yaml -kimi-login -no-browser

五、启动服务

登录完成后，启动代理：

1	./cli-proxy-api.exe -config config.yaml

看到类似 CLIProxyAPI Version: 7.2.97 的日志即表示启动成功。服务监听在 http://127.0.0.1:8317。

六、验证服务

1. 查看可用模型

1 2	curl http://127.0.0.1:8317/v1/models \ -H "Authorization: Bearer sk-cliproxy-local"

如果返回了 gpt-5.6-sol、claude-opus-4-1-20250805 等模型列表，说明配置正确。

2. 发一条测试消息

curl -X POST http://127.0.0.1:8317/v1/chat/completions \
  -H "Authorization: Bearer sk-cliproxy-local" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "hello"}],
    "max_tokens": 20
  }'

返回 JSON 且 choices 里有内容，即表示整条链路打通。

七、接入客户端

Claude Code

在启动 Claude Code 前设置环境变量：

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:8317"
$env:ANTHROPIC_AUTH_TOKEN="sk-cliproxy-local"

# 根据 Claude Code 版本选择
# 2.x 版本
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-5.6-sol"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5-20250929"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="gemini-2.5-flash"

# 1.x 版本
# $env:ANTHROPIC_MODEL="claude-sonnet-4-20250514"
# $env:ANTHROPIC_SMALL_FAST_MODEL="gemini-2.5-flash"

claude

这样 Claude Code 的 API 请求会先打到本地 CLIProxyAPI，再由它路由到 Codex、Claude 或 Gemini。

Codex

# Windows PowerShell
$env:OPENAI_BASE_URL="http://127.0.0.1:8317"
$env:OPENAI_API_KEY="sk-cliproxy-local"

codex

OpenClaw / 其他 OpenAI 兼容工具

把 base URL 和 API Key 改成：

Base URL: http://127.0.0.1:8317
API Key: sk-cliproxy-local（即你在 config.yaml 里设的 api-keys）

八、高级：多账号与模型别名

如果你有多组 ChatGPT / Claude / Grok 账号，可以在 config.yaml 里配置多 key：

codex-api-key:
  - api-key: "sk-your-codex-key-1"
    base-url: "https://your-codex-relay.example.com"
  - api-key: "sk-your-codex-key-2"
    base-url: "https://another-relay.example.com"

也可以给模型起别名，方便客户端切换：

codex-api-key:
  - api-key: "sk-xxx"
    models:
      - name: "gpt-5.6-sol"
        alias: "sol"

客户端请求 model: "sol" 时，CLIProxyAPI 会自动映射到 gpt-5.6-sol。

九、常见问题

Q: 浏览器授权后 CLIProxyAPI 没反应？
A: 确保 OAuth 回调地址 localhost:1455（或程序提示的端口）没被其他程序占用。如果授权页在远程浏览器打开，需要本地做 SSH 端口转发。

Q: 模型列表里没有 Claude / Grok？
A: 需要先完成对应平台的 OAuth 登录。模型列表只显示已成功认证的提供商。

Q: 请求报错 401？
A: 检查客户端填写的 API Key 是否和 config.yaml 里 api-keys 的某一项完全一致。

Q: 在中国大陆需要代理吗？
A: 需要。在 config.yaml 的 proxy-url 填入你的本地代理，例如 http://127.0.0.1:7890。

十、一句话总结

CLIProxyAPI = 一个本地网关 + 一次 OAuth 登录 + 一套 API Key，让你的 Claude Code、Codex、OpenClaw 都能调用所有订阅模型。不用重复买 API，不再被单一平台锁定。

参考来源

CLIProxyAPI GitHub

CLIProxyAPI 官方文档