1. 为什么要在 VS Code 与 CLI 里统一接入 CodexOpenAI Codex 现在有两种常见用法一种是在 VS Code 里装插件选中代码直接对话另一种是在终端里跑 CLI把改代码、跑测试、批量重构这类活儿交给命令行。两种方式各有各的好但真正让人头疼的是配置分散——插件里填一个 KeyCLI 里又得配一遍换台机器还得重新来。这篇要解决的就是这个问题用一套统一的 Key 和 API 通道把 VS Code 插件和 CLI 的配置收敛到同一个config.toml骨架里。你只需要维护一份配置两边都能跑通。适合已经在用 Node.js 做开发、想让 Codex 同时服务编辑器和终端的同学。我试过把插件和 CLI 分开配结果改了一个忘了另一个排查半天才发现是 Key 不一致。后来统一走同一个 API 通道配置文件只留一份省心很多。下面从环境准备开始一步步把config.toml和settings.json骨架搭起来再验证 CLI 连通性最后给一份常见报错排查清单。2. 前置准备Node.js 环境与 TaoToken KeyCodex CLI 是 Node.js 写的所以第一步是把 Node.js 装好。建议 18 以上版本终端里跑node -v能看到版本号就行。如果你机器上已经有 Node跳过这步。node -v # 期望输出类似 v20.11.0 npm -v # 期望输出类似 10.2.4接下来是 Key。TaoToken 提供统一的 API 通道Codex 插件和 CLI 都走这个通道所以只需要一个 Key。登录控制台后进 API Keys 页面创建一个复制出来先存到环境变量里别直接写死在配置文件里。# macOS / Linux export TAOTOKEN_API_KEYsk-你的key # Windows PowerShell $env:TAOTOKEN_API_KEYsk-你的key注意Key 只显示一次创建后立刻复制。如果丢了就重新生成一个旧的自然失效。环境变量设好之后后面config.toml里用${TAOTOKEN_API_KEY}引用就行不用把明文写进文件。这样配置文件可以放心提交到自己的 dotfiles 仓库不会泄露 Key。3. config.toml 骨架CLI 与 VS Code 共用一份Codex CLI 的配置文件默认放在~/.codex/config.tomlWindows 是%USERPROFILE%\.codex\config.toml。这个文件同时被 CLI 和 VS Code 插件读取所以只要配好这一份两边都生效。先建目录mkdir -p ~/.codex然后写入下面的骨架。核心是把base_url指向 TaoToken 的 API 地址env_key指向刚才设的环境变量名。# ~/.codex/config.toml model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses [profiles.default] model gpt-5-codex model_provider taotoken approval_policy on-request几个参数说明一下。base_url是统一通道地址注意结尾不要多加/v1Codex 会自己拼路径。env_key写的是环境变量名不是 Key 本身。wire_api用responses是 Codex 的默认协议如果你用的是兼容 chat 的模型可以改成chat。VS Code 插件那边如果你想让插件也读这份配置需要在插件的 settings 里指定配置路径。打开 VS Code 的settings.jsonCtrlShiftP搜 “Open User Settings (JSON)”加上{ codex.configPath: ~/.codex/config.toml, codex.defaultProfile: default }这样插件启动时会去读同一份config.tomlKey 和模型都跟 CLI 保持一致。改一处两边同步。4. GitHub 仓库级初始化与 CLI 连通性验证配置写好了不代表能跑通得实际验证一下。先做仓库级初始化再跑 CLI 连通性测试。进你的项目目录初始化一个 Codex 工作区cd your-project codex init这个命令会在项目根目录生成一个.codex/目录里面可以放项目级的AGENTS.md用来告诉 Codex 这个项目的技术栈、目录结构、测试命令。比如# AGENTS.md - 技术栈Node.js 20 TypeScript - 测试命令npm run test - 代码规范ESLint Prettier - 禁止修改src/legacy/ 下的文件有了这个Codex 在改代码时会更贴合你的项目习惯不会乱动不该动的地方。接下来验证 CLI 连通性。最直接的方式是跑一个最小请求codex exec 输出当前目录下的文件列表不要修改任何文件如果配置正确你会看到 Codex 返回文件列表并且终端里没有报错。如果卡住或者报 401说明 Key 或base_url有问题往下看排查清单。再验证一下模型是否真的走通了codex exec --profile default 用一句话解释什么是闭包能正常返回中文解释就说明 CLI 这条链路是通的。VS Code 插件那边打开一个.js文件选中几行代码右键选 “Ask Codex”输入 “解释这段代码”如果插件能返回结果说明它读到了同一份配置。5. 常见报错排查清单配置过程中最容易踩的坑就那么几个我整理成清单遇到问题对着查。报错一401 Unauthorized最常见。先确认环境变量有没有生效echo $TAOTOKEN_API_KEY # Windows: echo $env:TAOTOKEN_API_KEY如果输出为空说明环境变量没设上。注意export只在当前终端会话有效新开终端要重新设或者写进~/.bashrc/~/.zshrc。报错二404 Not Found多半是base_url写错了。检查config.toml里是不是写成了https://taotoken.net/api/v1把/v1去掉。Codex 会自己拼/responses或/chat/completions。报错三model not found模型名写错了。gpt-5-codex是 Codex 专用模型名如果你用的是别的模型去模型对话页面确认一下可用的模型标识填对再试。报错四VS Code 插件读不到配置插件默认可能不读~/.codex/config.toml需要在settings.json里显式指定codex.configPath。另外确认插件版本老版本可能不支持自定义配置路径升级到最新版。报错五CLI 卡住不返回先看网络能不能通到https://taotoken.net/api用curl测一下curl -I https://taotoken.net/api如果返回 200 或 405说明网络通。如果超时检查本地网络设置。另外确认 Node.js 版本低于 18 可能会有兼容问题。报错六approval_policy 导致命令被拦config.toml里approval_policy on-request表示 Codex 执行敏感操作前会问你。如果你在自动化脚本里跑可以临时改成never但日常开发建议保留on-request避免误操作。6. 把配置用起来下一步做什么配置搭好之后日常开发里可以这么用。VS Code 里选中代码让 Codex 优化CLI 里跑批量重构两边共用同一个 Key 和模型不用来回切换。如果你要长期跑编码任务或者搭 Agent 工作流建议看一下 Coding Plan它针对长时间、多轮次的编码场景做了优化比按次调用更划算。接入文档里有更细的 API 参数说明遇到配置项不确定的时候可以对照查。模型对话页面可以快速验证某个模型在当前通道下能不能正常返回省得在 CLI 里反复试。最后留一个实用技巧把~/.codex/config.toml纳入你的 dotfiles 管理换机器时 clone 下来设好环境变量就能直接用。Key 走环境变量配置文件里不出现明文这样既方便又安全。
