1. 从零跑通 Codex为什么第一步是改 auth.jsonCodex 是 OpenAI 推出的一套自主软件工程智能体工具链它和早期那个只做代码补全的模型已经完全不是一回事了。现在的 Codex 包含命令行客户端 Codex CLI、本地沙盒应用 Codex App以及 IDE 插件三部分协同工作。它能自己读文件、改代码、跑测试、看报错、再改直到任务完成。适合谁用适合已经有一定命令行基础、想让 AI 真正动手写代码而不是只给建议的开发者。但很多人卡在第一步装完之后不知道身份怎么配。默认情况下 Codex CLI 会引导你走 ChatGPT 账号登录走的是 OAuth 那一套。如果你手上用的是 API Key 方式或者想把请求指向自己的接入端点就必须去动~/.codex/auth.json这个文件。这篇就按“安装 → 改 auth.json → 验证调用”的完整链路走一遍每一步都给可复制的命令和配置片段。我试过在 macOS 和 Windows 上各跑一遍踩过的坑主要集中在 auth.json 的字段格式和 Base URL 的写法上后面会单独开一节讲报错排查。你只要跟着做十分钟内能让 Codex 发出第一个真实请求。先明确一个概念Codex CLI 本身是个 Node.js 程序它不绑定某一家模型服务。它读auth.json决定“用哪个 Key、请求发到哪个地址、默认用哪个模型”。所以把这三个东西配对Codex 就能跑起来。本文用 TaoToken 作为接入端点来演示因为它的接口格式和 OpenAI 兼容配置起来最省事。2. 安装 Codex CLI 与前置准备npm 全局安装与 Node 版本要求2.1 环境要求Codex CLI 基于 Node.js官方要求 Node 18 以上实测 Node 20 LTS 最稳。先确认版本node -v npm -v如果 node 版本低于 18先去升级。Windows 用户建议用 nvm-windows 管理版本macOS/Linux 用 nvm 就行。这一步别跳过Node 16 装 Codex 会在启动时报SyntaxError: Unexpected token ??之类的语法错误因为代码里用了空值合并运算符。2.2 全局安装 Codex CLInpm install -g openai/codex装完验证codex --version能打印出版本号就说明 CLI 装好了。如果提示command not found多半是 npm 全局 bin 目录没进 PATH。用npm config get prefix看路径把它加到环境变量里。2.3 关于 Codex App 和 IDE 插件Codex App 是图形客户端主要作用是提供沙盒工作区和账号鉴权macOS 和 Windows 都有。IDE 插件VS Code 扩展则让你在编辑器里直接调用。但本文聚焦 CLI auth.json 这条链路因为它是所有形态里最透明、最容易排障的。App 和插件本质上也是读同一份配置你把 CLI 跑通了另外两个自然就通。2.4 准备 TaoToken 的 API Key在开始改配置前先拿到 Key。访问 https://taotoken.net/api-keys 创建一个 API Key复制保存好。这个 Key 就是后面 auth.json 里OPENAI_API_KEY字段的值。注意 Key 只在创建时完整显示一次丢了就重新建一个。同时记下两个地址后面配置要用Base URLhttps://taotoken.net/api模型对话入口用于网页端验证https://taotoken.net/model-chat3. 可复制配置把 auth.json 指向 TaoToken 的完整写法3.1 auth.json 在哪Codex CLI 读取的配置文件默认在用户主目录下的.codex文件夹里macOS / Linux~/.codex/auth.jsonWindowsC:\Users\你的用户名\.codex\auth.json如果这个文件不存在手动创建。目录也要一起建mkdir -p ~/.codex3.2 auth.json 完整片段把下面这段复制进去替换掉sk-你的TaoToken密钥{ OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_BASE_URL: https://taotoken.net/api, model: gpt-5.5 }三个字段的含义字段作用取值OPENAI_API_KEY身份凭证你在 TaoToken 创建的 KeyOPENAI_BASE_URL请求发往的地址https://taotoken.net/apimodel默认模型 ID如 gpt-5.5、gpt-5.4-mini注意 Base URL 结尾不要带/v1也不要带斜杠。Codex 内部会自己拼接路径你多写一段就会变成https://taotoken.net/api/v1/v1/chat/completions这种重复路径直接 404。3.3 用 TOML 配置默认模型可选但推荐除了 auth.jsonCodex 还支持在~/.codex/config.toml里写更细的偏好比如默认模型和推理强度。这个文件和 auth.json 是互补的auth.json 管身份config.toml 管行为model gpt-5.5 model_reasoning_effort medium [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api wire_api chatwire_api chat表示走 Chat Completions 协议这是兼容性最好的选项。如果你用的是支持 Responses 协议的端点可以改成responses但先用chat跑通再说。3.4 环境变量方式备选如果你不想写文件也可以用环境变量临时覆盖export OPENAI_API_KEYsk-你的TaoToken密钥 export OPENAI_BASE_URLhttps://taotoken.net/api但环境变量在每次开新终端都要重设长期用还是写 auth.json 省事。两种方式同时存在时环境变量优先级更高排查问题时记得检查有没有残留的旧变量。4. 验证请求跑一次真实调用确认配置生效4.1 启动交互式会话在任意项目目录下打开终端输入codex如果配置正确会进入交互式界面显示当前模型和会话状态。此时直接输入一句自然语言比如用 Python 写一个读取 CSV 并统计每列缺失值的函数Codex 会把请求发到https://taotoken.net/api返回代码。如果能看到流式输出的代码块说明 Key、Base URL、模型三个字段全部生效。4.2 用单次执行模式验证不想进交互界面可以用exec子命令做一次性调用codex exec 解释一下这段代码的作用print([x**2 for x in range(5)])正常返回类似这行代码生成 0 到 4 的平方列表输出 [0, 1, 4, 9, 16]。4.3 指定模型验证想确认模型切换也正常用-m参数codex -m gpt-5.4-mini exec 写一个 bash 函数判断文件是否存在如果返回结果且没有报模型不存在的错误说明模型 ID 写对了。模型 ID 必须和端点支持的列表一致写错会返回model_not_found。4.4 成功结果的判断标准一次成功的调用满足三个条件终端有流式文字输出、没有红色报错、退出码为 0。你可以用echo $?检查上一条命令的退出码。如果输出是 0配置就是通的。到这一步Codex 的基础链路已经跑通后面就是怎么用它干活的问题了。5. 常见报错排查401、local proxy failed 与 reading choices 怎么解5.1 401 Unauthorized报错长这样Error: 401 Unauthorized - invalid_api_key原因通常是三个Key 复制时带了空格、Key 已失效、auth.json 里字段名写错。先检查OPENAI_API_KEY的值有没有首尾空格JSON 里字符串不能有多余空白。然后去 https://taotoken.net/api-keys 确认这个 Key 还在、没被删。最后确认字段名是大写下划线格式写成apiKey或openai_api_key都不认。5.2 local proxy failed / connection refusedError: local proxy failed: dial tcp 127.0.0.1:xxxx: connect: connection refused这个报错说明 Codex 在尝试连本地某个端口通常是你之前配过代理类工具留下的残留配置。检查~/.codex/config.toml里有没有proxy相关字段有就删掉。同时检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY指向本地端口有就 unset 掉。Codex 应该直连https://taotoken.net/api不需要经过任何本地转发。5.3 reading choices 相关报错Error: error reading choices: unexpected end of JSON input这个多半是 Base URL 写错导致返回了非预期内容。最常见的是结尾多写了/v1请求打到了不存在的路径服务端返回了 HTML 错误页Codex 按 JSON 解析就炸了。把OPENAI_BASE_URL改回https://taotoken.net/api不带任何后缀。另一个可能是模型 ID 写错服务端返回了错误结构同样会触发这个解析错误。5.4 OAuth 登录循环如果你之前走过账号登录流程auth.json 里可能残留了 OAuth 相关字段和 API Key 模式冲突。最干净的做法是删掉整个 auth.json 重新写rm ~/.codex/auth.json然后按第 3 节的片段重新创建。Codex 启动时如果发现没有 OAuth token 但有 API Key会直接走 Key 模式不会再弹登录。5.5 排查顺序建议遇到报错按这个顺序查先看 Base URL 有没有多余后缀再看 Key 是否有效再看模型 ID 是否存在最后看有没有代理残留。这四步能覆盖九成以上的配置问题。如果还不行用codex --debug启动它会打印实际请求的 URL 和响应状态码一眼就能看出请求打到哪去了。6. 长期使用建议与接入入口跑通之后日常使用还有几个提效点。第一把常用模型写进 config.toml 的model字段省得每次-m。第二项目根目录放一个精简的 README.mdCodex 需要时会自己去读深层文件不用你把上万行上下文全塞进 prompt。第三涉及数据库迁移、外部 webhook 这类高危操作时Codex 会挂起等你确认别嫌烦认真看一眼再放行。如果你打算把 Codex 用在长期编码任务或者 Agent 场景里可以了解下 Coding Plan它针对高频调用做了额度优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_plan需要管理多个 Key 或者查看调用量控制台在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole接入文档含各语言 SDK 示例和字段说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc如果你用的是 Claude Code 那套工具链对应的接入说明在https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude_code最后提醒一句auth.json 里存的是明文 Key别把它提交到 git。在项目里加一行.codex/到 .gitignore或者干脆把配置放在用户主目录而不是项目目录从源头避免泄露。