Linux 上配置 Codex CLI 的 base_url

在 Linux 上为 Codex CLI 配置自定义 base_url

目录

这篇只记录 Linux 上如何为 Codex CLI 配置自定义 base_url,步骤很简单:改配置、确认认证文件、重新启动。

1. 编辑 config.toml

~/.codex/config.toml 修改为类似下面这样:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
# ~/.codex/config.toml

model_provider = "custom"
model = "gpt-5.4"
disable_response_storage = true
model_reasoning_effort = "medium"

[model_providers]

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://your-api.example.com"

[projects."/home/ubuntu/.codex"]
trust_level = "trusted"

2. 配置环境变量

如果你启用了 requires_openai_auth = true,认证信息通常需要写在 ~/.codex/auth.json 里,不需要再单独写 OPENAI_API_KEY~/.bashrc~/.zshrc~/.codex/auth.json格式如下:

1
2
3
4
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-xxxxxx"
}

3. 启动 Codex

保存配置后重新启动:

1
codex

4. 注意事项

  • [projects."/home/ubuntu/.codex"] 里的路径要改成你自己的实际目录。
  • 如果仍然不生效,优先检查 config.toml 是否被正确读取,以及 API Key、权限和网络是否正常。

这样就完成了 Linux 下的 base_url 配置。

最后更新于 2026-05-23 11:20
本博客已运行
共72篇文章 · 总计15.81k字
总访问量  |  总访客数
使用 Hugo 构建
主题 StackJimmy 设计