很多人一开始接 AI 编程工具时,都是一个工具配一套模型入口:Claude Code 配 Anthropic,Codex CLI 配 OpenAI,Gemini CLI 再单独配 Gemini。这个方式能用,但工具一多,配置、路由、日志和成本统计都会变得分散。

如果你想让 DeepSeek 同时服务 Claude Code 和 Codex CLI,更好的做法不是分别去改两个工具的底层适配,而是在本机放一个统一的 AI gateway。

CliGate 解决的就是这个问题。

它默认运行在本地 localhost,把 Claude Code、Codex CLI、Gemini CLI、OpenClaw 等工具接到同一个控制平面里。DeepSeek 作为一个 provider 添加到 CliGate 后,Claude Code 和 Codex CLI 都可以通过 CliGate 访问它。

整体思路

最终结构是这样:

Claude Code  ─┐
              ├─> CliGate 本地网关 ─> DeepSeek
Codex CLI   ──┘

Claude Code 走 Anthropic Messages 风格请求,Codex CLI 走 OpenAI Responses / Chat Completions 风格请求。CliGate 在中间做协议适配、凭证选择、模型映射和日志记录。

这样带来的好处是:

  • DeepSeek Key 只需要在 CliGate 里管理;
  • Claude Code 和 Codex CLI 都指向同一个本地入口;
  • 后续可以在 Dashboard 里统一查看请求日志和用量;
  • 如果以后要换 provider,也主要改 CliGate 的路由,而不是逐个改工具。

第一步:启动 CliGate

如果你还没有安装 CliGate,可以直接用:

npx cligate@latest start

或者全局安装:

npm install -g cligate
cligate start

默认仪表盘地址是:

http://localhost:8081

启动后,先打开 Dashboard,确认服务是可访问的。

第二步:添加 DeepSeek API Key

进入 CliGate Dashboard 后,打开 API Keys 页面,添加一个新的 key。

关键配置一般是:

Provider: DeepSeek
Base URL: https://api.deepseek.com
API Key: 你的 DeepSeek Key

CliGate 内部把 DeepSeek 作为独立 provider 处理。它既可以走 OpenAI-compatible 入口,也可以走 Anthropic-compatible 入口。

这正是它能同时接入 Codex CLI 和 Claude Code 的关键。

第三步:确认 DeepSeek 模型映射

CliGate 有一层模型映射能力。客户端可能请求的是 gpt-5.4claude-sonneto4-mini 这类模型名,但真正发给 DeepSeek 时,需要映射到 DeepSeek 自己的模型。

当前 CliGate 的 DeepSeek 默认映射思路是:

flagship  -> deepseek-v4-pro
standard  -> deepseek-v4-flash
fast      -> deepseek-v4-flash
reasoning -> deepseek-v4-flash

也就是说,你可以让不同工具继续按自己的习惯发请求,再由 CliGate 根据能力层级映射到 DeepSeek 模型。

如果你希望更精确,也可以在模型映射设置里显式调整。

第四步:让 Claude Code 指向 CliGate

Claude Code 侧只需要把 Anthropic API 入口指向本地 CliGate。

在 macOS / Linux shell 中:

export ANTHROPIC_BASE_URL=http://localhost:8081
export ANTHROPIC_API_KEY=any-key
claude

在 Windows PowerShell 中:

$env:ANTHROPIC_BASE_URL="http://localhost:8081"
$env:ANTHROPIC_API_KEY="any-key"
claude

这里的 any-key 不是 DeepSeek Key。真正的 DeepSeek Key 已经保存在 CliGate 里。这个值只是让 Claude Code 客户端愿意把请求发给本地代理。

请求进入 CliGate 后,CliGate 会按路由策略选择可用凭证。如果你希望 Claude Code 固定使用 DeepSeek,可以在 App Routing 中把 claude-code 绑定到那条 DeepSeek API Key。

第五步:让 Codex CLI 指向 CliGate

Codex CLI 侧需要把 OpenAI / ChatGPT 相关入口指向 CliGate。

常见配置在:

~/.codex/config.toml

可以配置为:

chatgpt_base_url = "http://localhost:8081/backend-api/"
openai_base_url = "http://localhost:8081"

CliGate 也提供一键配置入口,适合不想手动编辑配置文件的用户。

和 Claude Code 类似,Codex CLI 发出的请求进入 CliGate 后,再由 CliGate 决定走哪个 provider。如果你希望 Codex 固定使用 DeepSeek,可以在 App Routing 中把 codex 绑定到同一条 DeepSeek API Key。

第六步:使用 App Routing 固定两端都走 DeepSeek

如果你只添加了一个 DeepSeek Key,自动路由通常已经能工作。

但在实际环境里,很多人还会同时添加 OpenAI、Claude、Gemini、Azure OpenAI、本地模型等资源。这时建议打开 App Routing,把应用和凭证绑定清楚:

claude-code -> DeepSeek API Key
codex       -> DeepSeek API Key

这样做有两个好处:

  1. Claude Code 和 Codex CLI 都会优先走指定 DeepSeek Key;
  2. 日志里能更清楚地看到每个工具的请求路径。

如果你担心 DeepSeek 临时不可用,可以保留 fallback,让 CliGate 在目标 key 不可用时回退到默认路由。

第七步:验证链路

建议按这个顺序验证:

  1. 在 Dashboard 的 API Keys 页面测试 DeepSeek Key;
  2. 在 Dashboard 的 Chat 页面选择 DeepSeek 相关模型发一条测试消息;
  3. 启动 Claude Code,发送一个简单请求;
  4. 启动 Codex CLI,发送一个简单请求;
  5. 打开 Request Logs,确认请求确实进入 CliGate,并且 provider 是 DeepSeek。

如果请求失败,优先检查:

  • DeepSeek Key 是否有效;
  • Base URL 是否是 https://api.deepseek.com
  • Claude Code / Codex CLI 是否真的指向 localhost:8081
  • App Routing 是否错误绑定到了不可用凭证;
  • 模型映射是否把请求模型映射到了 DeepSeek 支持的模型。

为什么不直接分别配置两个工具

你当然可以分别改 Claude Code 和 Codex CLI 的配置,让它们直接访问不同的 OpenAI-compatible 或 Anthropic-compatible 服务。

但这样会带来几个问题:

  • 两边的配置分散;
  • Key 轮换时要改多个地方;
  • 请求日志分散在不同工具里;
  • 成本和用量不容易统一统计;
  • 后续想切换 provider 时需要逐个工具调整。

CliGate 的价值在于把这些事情收口到本地网关:

工具只管请求 CliGate
CliGate 负责选择 DeepSeek 或其他 provider

总结

用 CliGate 接入 DeepSeek 后,Claude Code 和 Codex CLI 不需要各自维护复杂的 provider 细节。

你只需要:

  1. 启动 CliGate;
  2. 添加 DeepSeek API Key;
  3. 配好模型映射;
  4. 让 Claude Code 和 Codex CLI 都指向 localhost:8081
  5. 如有需要,用 App Routing 把 claude-codecodex 都绑定到 DeepSeek。

这样,一个 DeepSeek provider 就可以同时服务两类主流 AI 编程工具,同时保留统一日志、统一路由、统一用量统计和后续切换 provider 的空间。

项目地址:

https://github.com/codeking-ai/cligate
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐