Codex CLI 默认连的是 OpenAI 官方接口。如果你用的是公司内部网关、聚合服务或者自己搭的兼容服务只需要改一个文件~/.codex/config.toml。这篇把每一行配置的含义、怎么验证是否生效、出错了从哪查一次讲清楚。1. 先确认 Codex 装好了npminstall-gopenai/codex codex--version能打印出版本号就行。macOS 也可以用brew install codex安装。2. 一份最小可用的配置下面以模驿API 的接口为例https://moyi-api.com 换成你自己的服务地址改base_url一行即可model_provider moyiapi model gpt-6.1-sol model_reasoning_effort high [model_providers.moyiapi] name 模驿API base_url https://api.moyi-api.com/v1 env_key OPENAI_API_KEY wire_api responses文件位置macOS / Linux 是~/.codex/config.tomlWindows 是C:\Users\你的用户名\.codex\config.toml。目录不存在就先建一个。3. 每一行是什么意思字段作用容易踩的坑model_provider指定用哪一组接口配置必须和下面[model_providers.xxx]里的 xxx 完全一致model默认用的模型名要和服务端支持的名字一字不差比如gpt-6.1-solmodel_reasoning_effort思考深度可选low/medium/high越高越慢、越费 token简单任务用medium就够name这组配置的显示名随便起只影响展示base_url接口根地址以/v1结尾不要写到/responses或/chat/completionsenv_key从哪个环境变量读 KeyKey 不要直接写进配置文件放环境变量里wire_api用哪种协议调用responses走 Responses API服务端只支持 Chat Completions 时改成chat4. 把 Key 放进环境变量macOS默认 zshechoexport OPENAI_API_KEY你的Key~/.zshrcsource~/.zshrcLinuxbashechoexport OPENAI_API_KEY你的Key~/.bashrcsource~/.bashrcWindowsPowerShell[Environment]::SetEnvironmentVariable(OPENAI_API_KEY,你的Key,User)Windows 设完要重新打开 PowerShell新窗口才读得到。5. 验证配置是否生效不用进交互界面直接跑一条非交互命令codexexec用一句话介绍你自己能正常返回一句话说明地址、Key、模型名三样都对了。报错的话看第 8 节。6. 模型怎么选GPT-6 系列目前三档官方价格如下每百万 tokens输入 / 输出模型模型名适合价格GPT-6.1 Solgpt-6.1-sol日常写代码、改 bug性价比最高$2 / $10GPT-6 Astragpt-6-astra复杂重构、跨文件设计上下文 1M$10 / $50GPT-6 Lunagpt-6-luna批量、简单、对速度敏感的任务$0.1 / $0.5经验上默认用 GPT-6.1 Sol 配high遇到它解决不了的难题再切 Astra跑批量脚本、写注释这类活用 Luna 配low成本只有 Sol 的二十分之一。进入 Codex 后输入/model可以临时切换。7. 用 profile 管理多套配置不同任务要不同模型时不用每次改默认值在配置文件里加几个 profile[profiles.quick] model_provider moyiapi model gpt-6-luna model_reasoning_effort low [profiles.deep] model_provider moyiapi model gpt-6-astra model_reasoning_effort high启动时指定codex--profiledeep8. 常见报错排查现象最常见原因怎么查401 / UnauthorizedKey 没读到或写错执行echo $OPENAI_API_KEYWindows 用echo $env:OPENAI_API_KEY看能不能回显Windows 记得重开窗口404 / Not Foundbase_url少了/v1或者多写了路径对照第 3 节根地址以/v1结尾400 / 不支持的接口wire_api和服务端不匹配把responses改成chat再试model not found模型名拼错或服务端没有这个模型到服务商控制台核对模型名一直没响应地址写错或服务暂时不可用用浏览器打开服务商官网确认能访问小结接入任何兼容接口本质上就三件事在config.toml里写对base_url和model把 Key 放进env_key指定的环境变量再用codex exec跑一条命令验证。剩下的模型选择和 profile按任务难度和预算慢慢调就行。文中示例接口和模型价格可在 https://moyi-api.com 查看。
Codex CLI 默认连的是 OpenAI 官方接口。如果你用的是公司内部网关、聚合服务或者自己搭的兼容服务只需要改一个文件~/.codex/config.toml。这篇把每一行配置的含义、怎么验证是否生效、出错了从哪查一次讲清楚。1. 先确认 Codex 装好了npminstall-gopenai/codex codex--version能打印出版本号就行。macOS 也可以用brew install codex安装。2. 一份最小可用的配置下面以模驿API 的接口为例https://moyi-api.com 换成你自己的服务地址改base_url一行即可model_provider moyiapi model gpt-6.1-sol model_reasoning_effort high [model_providers.moyiapi] name 模驿API base_url https://api.moyi-api.com/v1 env_key OPENAI_API_KEY wire_api responses文件位置macOS / Linux 是~/.codex/config.tomlWindows 是C:\Users\你的用户名\.codex\config.toml。目录不存在就先建一个。3. 每一行是什么意思字段作用容易踩的坑model_provider指定用哪一组接口配置必须和下面[model_providers.xxx]里的 xxx 完全一致model默认用的模型名要和服务端支持的名字一字不差比如gpt-6.1-solmodel_reasoning_effort思考深度可选low/medium/high越高越慢、越费 token简单任务用medium就够name这组配置的显示名随便起只影响展示base_url接口根地址以/v1结尾不要写到/responses或/chat/completionsenv_key从哪个环境变量读 KeyKey 不要直接写进配置文件放环境变量里wire_api用哪种协议调用responses走 Responses API服务端只支持 Chat Completions 时改成chat4. 把 Key 放进环境变量macOS默认 zshechoexport OPENAI_API_KEY你的Key~/.zshrcsource~/.zshrcLinuxbashechoexport OPENAI_API_KEY你的Key~/.bashrcsource~/.bashrcWindowsPowerShell[Environment]::SetEnvironmentVariable(OPENAI_API_KEY,你的Key,User)Windows 设完要重新打开 PowerShell新窗口才读得到。5. 验证配置是否生效不用进交互界面直接跑一条非交互命令codexexec用一句话介绍你自己能正常返回一句话说明地址、Key、模型名三样都对了。报错的话看第 8 节。6. 模型怎么选GPT-6 系列目前三档官方价格如下每百万 tokens输入 / 输出模型模型名适合价格GPT-6.1 Solgpt-6.1-sol日常写代码、改 bug性价比最高$2 / $10GPT-6 Astragpt-6-astra复杂重构、跨文件设计上下文 1M$10 / $50GPT-6 Lunagpt-6-luna批量、简单、对速度敏感的任务$0.1 / $0.5经验上默认用 GPT-6.1 Sol 配high遇到它解决不了的难题再切 Astra跑批量脚本、写注释这类活用 Luna 配low成本只有 Sol 的二十分之一。进入 Codex 后输入/model可以临时切换。7. 用 profile 管理多套配置不同任务要不同模型时不用每次改默认值在配置文件里加几个 profile[profiles.quick] model_provider moyiapi model gpt-6-luna model_reasoning_effort low [profiles.deep] model_provider moyiapi model gpt-6-astra model_reasoning_effort high启动时指定codex--profiledeep8. 常见报错排查现象最常见原因怎么查401 / UnauthorizedKey 没读到或写错执行echo $OPENAI_API_KEYWindows 用echo $env:OPENAI_API_KEY看能不能回显Windows 记得重开窗口404 / Not Foundbase_url少了/v1或者多写了路径对照第 3 节根地址以/v1结尾400 / 不支持的接口wire_api和服务端不匹配把responses改成chat再试model not found模型名拼错或服务端没有这个模型到服务商控制台核对模型名一直没响应地址写错或服务暂时不可用用浏览器打开服务商官网确认能访问小结接入任何兼容接口本质上就三件事在config.toml里写对base_url和model把 Key 放进env_key指定的环境变量再用codex exec跑一条命令验证。剩下的模型选择和 profile按任务难度和预算慢慢调就行。文中示例接口和模型价格可在 https://moyi-api.com 查看。
