Skip to content

Codex CLI 配置

Codex CLI 是 OpenAI 官方的命令行编程工具。RouterBus 提供 OpenAI 兼容接口(含 Responses API),可直接配合 Codex CLI 使用。

前提条件

  • 已安装 Codex CLI
  • 已在 RouterBus 创建 API Key

配置方法

方法一:环境变量

在 shell 配置文件中添加:

bash
export OPENAI_BASE_URL=https://www.routerbus.com/v1
export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

重新加载:

bash
source ~/.bashrc

方法二:配置文件

编辑 ~/.codex/config.toml,把 RouterBus 添加为自定义 provider:

toml
model = "gpt-5.5"
model_provider = "routerbus"

[model_providers.routerbus]
name = "RouterBus"
base_url = "https://www.routerbus.com/v1"
env_key = "OPENAI_API_KEY"

env_key 指的是从哪个环境变量读取 Key,所以仍然需要设置 OPENAI_API_KEYmodel模型广场 上的模型 ID。

配置项以你的版本为准

Codex CLI 的配置格式随版本变化较快。若上面的字段名对不上,请查阅你所用版本的官方文档,关键只有两点:base URL 指向 https://www.routerbus.com/v1,Key 用你的 RouterBus API Key。

验证

bash
codex "hello world"

使用示例

bash
# 代码生成
codex "写一个 Python 快排算法"

# 代码解释
codex "解释这段代码" < main.py

# 交互模式
codex

地址要带 /v1

OpenAI 兼容客户端通常要求地址带 /v1。只填 https://www.routerbus.com 容易出现请求路径不对或连接失败。

模型选择

Codex CLI 默认使用 GPT 系列模型。RouterBus 上开放的 GPT 与代码类模型 ID 见 模型广场,复制到 model 字段或 --model 参数即可。

RouterBus API Documentation