必须修改~/.codex/config.toml中[model_providers.xxx]段落并填满5个字段（name、base_url、wire_api、env_key、http_headers）才能启用Responses协议转发，缺一则报401或stream断连。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让Codex调用GPT-5.6、DeepSeek、Qwen或本地Ollama等非OpenAI模型，必须修改~/.codex/config.toml里的[model_providers.xxx]段落，填对5个字段才能触发Responses协议转发，少一个都会报401或stream断连。
确认Codex CLI已安装并验证版本
打开终端，执行：codex --version。输出应为0.110或更高——低于此版本不支持wire_api = "responses"字段，强行配置会静默失效。
若提示command not found，说明CLI未安装或未加入PATH。此时需先运行sudo npm install -g @openai/codex，再重试版本检查。
Windows用户请确认Node.js版本≥22，否则npm install会卡在依赖解析阶段，且后续所有配置均无法生效。
准备第三方API服务与密钥
选择任一支持OpenAI Responses API的第三方服务：Token侠、EasyAPI、Codeilab、One API或自建Ollama+llama.cpp网关均可。重点确认该服务文档明确标注支持/v1/responses端点，而非仅/v1/chat/completions。
方法一：网页控制台创建密钥
登录服务商后台→进入「API密钥」→新建→分组选codex（不是chat或gpt）→复制生成的sk-xxx字符串。注意：密钥权限必须开放responses类型调用，否则Codex发送请求后服务端直接返回空响应。
方法二：使用环境变量（更安全）
不把密钥写进文件，而是执行：export EASYAPI_KEY="sk-xxx"（Linux/macOS）或set EASYAPI_KEY=sk-xxx（Windows CMD）。后续config.toml中只需引用变量名，无需硬编码。
编辑config.toml完成核心配置
第一步：确保配置目录存在mkdir -p ~/.codex。这一步不能跳过，否则codex启动时会静默忽略缺失目录，直接回退到官方OpenAI endpoint。
第二步：创建并编辑配置文件touch ~/.codex/config.toml && nano ~/.codex/config.toml（macOS/Linux）；Windows用户请用记事本打开C:\Users\你的用户名\.codex\config.toml（需开启显示隐藏文件）。
第三步：粘贴最小可用配置（以Token侠为例）model = "gpt-5.6-sol"model_provider = "tokenxia"[model_providers.tokenxia]name = "Token侠"base_url = "https://api.tokenxia.com/v1"wire_api = "responses"env_key = "TOKENXIA_KEY"http_headers = { "X-Title" = "Codex CLI" }
【base_url末尾必须带/v1，缺斜杠会导致404】。很多用户复制URL时漏掉最后的/v1，结果Codex不断重试直到超时，日志里只显示stream disconnected before completion，根本看不出是路径错误。
第四步：保存后退出编辑器
Nano用户按Ctrl+O → Enter → Ctrl+X；Windows记事本直接保存即可。不要改文件扩展名为.txt，必须是纯config.toml。
可选：分离密钥到auth.json提升安全性
创建~/.codex/auth.json文件，内容仅一行：{"TOKENXIA_KEY": "sk-xxx"}。注意字段名必须与config.toml中env_key值完全一致，大小写敏感。
立即执行chmod 600 ~/.codex/auth.json（macOS/Linux），防止其他用户读取密钥。Windows无此命令，但需右键属性→安全→取消继承权限→仅保留当前用户“完全控制”。
这一步不做也不会影响功能，但若服务器多人共用或存在恶意脚本风险，auth.json比明文写在config.toml里安全得多。
启动Codex并测试连通性
终端执行codex --help，若看到帮助文档输出，说明CLI已加载配置；若仍走OpenAI官网，则检查model_provider是否拼错，或~/.codex/路径下是否存在多个config.toml（比如备份文件config.toml.bak会被Codex误读）。
运行真实测试：codex "写一个Python函数，计算斐波那契数列第10项"。成功时会实时流式输出代码；失败则立刻报错，常见错误包括：401 Unauthorized（密钥无效或env_key名不匹配）、404 Not Found（base_url缺/v1）、connection refused（第三方服务宕机或网络不通）。
测试通过后，Codex将永久使用该第三方API，无需每次重复配置。
