告别手改配置!Claude Code/Codex/ChatGPT 桌面应用一条命令即可配好

浏览:6次阅读
没有评论

它解决什么问题

想让 AI 编程工具走第三方 API,就得手动改一堆配置文件,而且每个工具的写法都不一样:

  • Claude Code 要在 ~/.claude/settings.json 的 env 里写 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN;
  • Codex 要在 ~/.codex/config.toml 里自己定义 model_provider,model 还必须放在根表里;
  • Claude Desktop 不读上面两个文件,有自己的第三方推理配置;
  • Gemini CLI 要设置环境变量 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY,还要改认证方式。

写错一个字段,工具就报错;想换模型或者改回原样,又得重新翻文档。

deeprouter 把这些步骤收成一次中文问答:回车配置 Codex / ChatGPT 桌面版(两者共用 ~/.codex/config.toml),想配 Claude Code 就输入 2;你只需要选程序、填令牌、选模型,配置文件由它来写,写完自动测一遍连通性。它是一个 Go 写的静态二进制,没有第三方依赖,采用 MIT 许可证开源。

支持哪些工具,各写到哪里

工具 写入位置(macOS / Linux) Windows
Codex / ChatGPT ~/.codex/config.toml(CLI、桌面应用、IDE 扩展共用) %USERPROFILE%\.codex\config.toml
Claude Code ~/.claude/settings.json %USERPROFILE%\.claude\settings.json
Claude Desktop configLibrary/(macOS:~/Library/Application Support/Claude-3p/,Linux:~/.config/Claude-3p/) %APPDATA%\Claude\configLibrary\
Grok Build ~/.grok/config.toml %USERPROFILE%\.grok\config.toml
Gemini CLI ~/.gemini/settings.json + shell 启动文件中的环境变量 %USERPROFILE%\.gemini\settings.json + 用户环境变量

它只改你在向导里选中的那个客户端,默认是 Codex / ChatGPT,并且采用合并方式写入,文件里原有的其他字段、注释都会保留。写入的文件权限是 0600。

安装

下面用的是国内镜像地址,不用访问 GitHub。

macOS / Linux:

curl -fsSL https://deeprouter.top/install.sh | sh

Windows PowerShell:

irm https://deeprouter.top/install.ps1 | iex

镜像上的脚本先从镜像下载,失败了再回退到 GitHub,并且会打印实际用了哪个地址。无论从哪里下载,都会用 checksums.txt 校验二进制,终端里会显示「校验和已核对」。在 Windows 上不要在 cmd 里跑 curl ... | sh,那样会报 'sh' is not recognized。

安装位置:macOS / Linux 是 ~/.local/bin/deeprouter,Windows 是 %LOCALAPPDATA%\Programs\deeprouter\deeprouter.exe,安装程序会自动把它加进 PATH。

交互向导:选程序 → 选平台 → 填令牌 → 选模型 → 直接写入

在终端里安装完会直接进入向导。界面语言跟随系统,中文系统就是中文界面(想强制英文可加 --lang en)。以后想重新配置,运行 deeprouter 即可。

告别手改配置!Claude Code/Codex/ChatGPT 桌面应用一条命令即可配好插图

实录:运行 deeprouter,一路回车——只配置 Codex / ChatGPT、平台选默认的 DeepRouter、模型不指定,列出要改的文件后直接写入。

1. 选择程序

一次配置一个客户端。 直接回车就是 Codex / ChatGPT 桌面版(两者共用 ~/.codex/config.toml);想配别的,输入对应序号,例如 2 = Claude Code。

 选择要配置的程序。直接回车只配置 Codex / ChatGPT。1) Codex / ChatGPT   Codex CLI 和 ChatGPT 桌面版共用 ~/.codex/config.toml
2) Claude Code       ~/.claude/settings.json
3) Claude Desktop    聊天、Cowork 和 Code 标签(configLibrary)4) Grok Build        ~/.grok/config.toml
5) Gemini CLI        ~/.gemini/settings.json
程序 [1]:

Claude Desktop、Grok Build、Gemini CLI 分别输入 3、4、5;没选的客户端不会改。

如果选中的工具还没安装,向导会先打印它的官方安装命令,例如 npm install -g @openai/codex。配置照常写入,装好工具就能直接用。

2. 选择平台

选完程序再选平台,直接回车就使用默认的 DeepRouter(https://deeprouter.top);列表最后一项「自定义网关地址」可以填其他兼容 OpenAI / Anthropic 接口的地址。

3. 填写令牌

向导会询问所选客户端的令牌,输入时只显示 *;之前保存过的也可以直接回车保留。令牌填错(网关返回 401)或者留空,向导会用中文提示并让你重新输入。令牌需要在 DeepRouter 控制台创建。

4. 选择模型

向导会用你的令牌拉取网关上的模型列表,按工具家族过滤(Codex 只列含 gpt 的模型,Claude Code 列含 claude 的),图片、视频、向量这类模型会被排除。 第 1 项是「不指定模型(使用客户端默认)」,直接回车就选它 ,配置里不写模型字段,由客户端用自己的默认模型。列表里标着「已通过测试」的模型是向导刚刚实际请求成功的。

5. 直接写入并测试

选完模型后,向导会列出要修改的文件并直接写入,不再单独确认。修改前会自动备份,撤销运行 deeprouter restore 即可。写完后会做连通性测试,显示 HTTP 状态和耗时。

之后可以随时运行 deeprouter test 重新测试,用 deeprouter status 查看当前配置和命令行工具版本。

切换模型

deeprouter models                            # 列出网关上的模型
deeprouter switch --codex-model gpt-5.6-luna  # 只改 Codex 的模型
deeprouter switch --claude-model default     # 改回工具自带的默认模型

switch 只会更新上次配置过的工具。如果有多套令牌,可以用 deeprouter profile add 建 profile,再用 deeprouter switch --profile < 名字 > 一键切换。

恢复原配置

每次修改前,deeprouter 都会把原文件备份到 ~/.deeprouter/backups。

deeprouter restore               # 还原到第一次修改之前,工具新建的文件会删除
deeprouter restore --list        # 列出可用的备份
deeprouter restore --id latest   # 只撤销最近一次修改
deeprouter uninstall --purge     # 还原文件,并删除 ~/.deeprouter

相关阅读

小结

deeprouter 把第三方 API 配置变成了一次中文问答:回车配置 Codex / ChatGPT 桌面版(两者共用 ~/.codex/config.toml),输入 2 配置 Claude Code,Claude Desktop、Grok Build、Gemini CLI 也可以输入对应序号选择;切换模型用 deeprouter switch,恢复原配置用 deeprouter restore。安装走国内镜像,二进制经过 checksums 校验,源码完全公开:

  • 开源地址:https://github.com/zfg5118/deeprouter
  • 默认网关与令牌获取:DeepRouter 官网
正文完
 0