最近在用 Codex 时,整理了一个比较省事的办法:把不同的 url 和 key 预先写进配置文件,用不同 profile 管理,启动时直接用:
codex -p xxx
来切换对应配置。
按当前 Codex CLI 的行为,-p 会从配置文件 ~/.codex/config.toml 里读取 profile。
Windows 下配置文件一般在:
C:\Users\你的用户名.codex\config.toml
macOS / Linux 一般在:
~/.codex/config.toml
如果要直接编辑:
notepad $env:USERPROFILE.codex\config.toml
或者:
nano ~/.codex/config.toml
我的理解可以简单分成两层:
- model_providers.xxx:放具体的接口地址和 token
- profiles.xxx:定义启动时选哪套 provider,以及要配什么模型参数
比如可以这样写:
model_provider = “openai”
model = “gpt-5.4”
model_reasoning_effort = “high”
[model_providers.openai]
name = “openai”
base_url = “https://api.openai.com/v1”
wire_api = “responses”
experimental_bearer_token = “sk-xxxx”
[model_providers.proxy]
name = “proxy”
base_url = “https://your-proxy.example.com/v1”
wire_api = “responses”
experimental_bearer_token = “sk-yyyy”
[profiles.openai]
model_provider = “openai”
model = “gpt-5.4”
model_reasoning_effort = “high”
[profiles.proxy]
model_provider = “proxy”
model = “gpt-5.4”
model_reasoning_effort = “high”
这样配置好之后,就可以直接切:
codex -p openai
codex -p proxy
这样做的好处很直接:
- 不用每次手动改 url 和 key
- 不用来回切环境变量
- 多套渠道、多套账号、多套中转地址切换很快
- 更不容易连错接口或者用错 key
如果只是临时覆盖某个配置,也可以直接命令行指定,比如:
codex -c model=“gpt-5.4”
我自己现在基本就是把“切 URL / Key”这件事,变成“切 profile”:
codex -p xxx
日常会省心很多。