1. Codex 中文输出为什么总是配不好CLI 与 VS Code 双端语言设置的真实场景很多人第一次用 Codex 的时候都会遇到同一个困惑明明在设置里把界面语言改成了中文结果一问问题模型还是噼里啪啦回一大段英文。这个问题的核心在于——界面语言和模型输出语言是两套完全独立的机制。界面语言只影响菜单、按钮、提示文案这些 UI 元素而模型回答用什么语言取决于你喂给它的系统提示词System Prompt或者项目级的指令文件。我试过在三个不同的入口分别配置Codex CLI命令行、VS Code 里的 Codex 插件、以及通过 API 通道直连的方式。这三种场景的配置位置完全不一样而且如果你用的是 TaoToken 统一 Key 的方式接入还需要额外确认 Base URL 和 auth.json 的对应关系否则会出现「配置写了但请求根本没走对通道」的情况。这篇文章面向的是习惯中文交互的开发者尤其是那些已经把 Codex 当成日常编码助手、但每次都要在对话开头手动打一句「请用中文回答」的人。我会给出可以直接复制的 config 片段、VS Code 的 settings 项、以及一次完整的中文提问验证流程。你不需要懂太多底层原理跟着改完就能让 Codex 默认说中文。先明确一个概念Codex 的中文输出配置分两层。第一层是全局默认语言通过 AGENTS.md 或者系统提示词实现对所有项目生效第二层是项目级覆盖在特定仓库里放一个配置文件只影响当前项目。两层可以叠加项目级优先级更高。下面按 CLI 和 VS Code 两条线分别展开最后再讲统一 Key 通道下的验证方法。2. TaoToken 统一 Key 前置准备Base URL、API Key 与模型 ID 的对应关系在动手改中文配置之前得先把接入通道理顺。TaoToken 的作用是提供一个统一的 API 入口让你用同一个 Key 就能调用多种模型不用在每个工具里分别填不同的厂商地址。对于 Codex 这类工具来说关键要搞清楚三个东西Base URL、API Key、Model ID。Base URL 是请求的根地址Codex CLI 和 VS Code 插件都需要你显式指定。TaoToken 的 API 地址是https://taotoken.net/api注意这里不要加任何多余的路径后缀有些工具会自动拼接/v1/chat/completions你只需要填到/api这一层就行。如果你填成了带/v1的地址可能会出现 404 或者路径重复的问题。API Key 的获取入口在控制台的 API Keys 页面生成之后是一串以sk-开头的字符串。这个 Key 要妥善保存因为它同时用于 CLI 和 VS Code 两端。我建议在 TaoToken 控制台里给不同的工具生成不同的 Key比如一个专门给 CLI 用一个给 VS Code 用这样万一某个 Key 泄露了可以单独吊销而不影响其他工具。Model ID 是你实际要调用的模型标识。在 TaoToken 的模型对话页面可以看到当前支持的模型列表选一个适合编码场景的就行。注意 Model ID 是区分大小写的填错了会直接报模型不存在的错误。对于 Codex CLI配置主要落在~/.codex/目录下。这个目录里通常有两个关键文件auth.json存认证信息config.toml存模型和通道配置。如果你之前用官方通道登录过auth.json里可能已经有 OAuth 相关的字段切换到 TaoToken 统一 Key 时需要把认证方式改成 API Key 模式。对于 VS Code 插件配置分两部分一部分是插件自己的 settings另一部分是 VS Code 的全局 settings.json。插件设置里填 Base URL 和 Key全局 settings 里可以配一些编辑器级别的行为比如默认语言、编码格式等。这里要特别提醒一点Base URL 和 auth.json 必须对应同一个通道。如果你在 config.toml 里写了 TaoToken 的地址但 auth.json 里还留着官方通道的 OAuth token请求就会失败。正确的做法是让 auth.json 里的认证方式和 config.toml 里的 Base URL 指向同一个服务商。3. 可复制配置Codex CLI 的 config.toml 与 VS Code settings 片段这一节给出可以直接复制的配置片段。先讲 CLI再讲 VS Code最后讲中文输出的核心配置。3.1 Codex CLI 的 config.toml 配置Codex CLI 的配置文件位于~/.codex/config.toml。如果这个文件不存在手动创建即可。下面是一个完整的配置示例把 Base URL 指向 TaoToken 的 API 地址# ~/.codex/config.toml model 你的模型ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat这里有几个关键点。model字段填你在 TaoToken 模型列表里选好的 Model ID。base_url填https://taotoken.net/api不要加/v1。env_key指定从哪个环境变量读取 API Key这样你就不需要把 Key 硬编码在配置文件里。然后在你的 shell 配置文件比如~/.zshrc或~/.bashrc里导出环境变量export TAOTOKEN_API_KEYsk-你的实际Key改完之后执行source ~/.zshrc让环境变量生效。你可以用echo $TAOTOKEN_API_KEY确认一下是否读到了。3.2 auth.json 的对应改法~/.codex/auth.json负责认证信息。如果你之前用官方通道登录过这个文件里可能有tokens字段。切换到 TaoToken 统一 Key 时需要把认证方式改成 API Key 模式。一个典型的 auth.json 结构如下{ OPENAI_API_KEY: sk-你的实际Key }注意这里的字段名是OPENAI_API_KEY这是 Codex CLI 约定的字段名即使你用的是 TaoToken 通道字段名也保持不变值填你的 TaoToken Key 即可。改完之后保存Codex CLI 启动时会优先读取这个文件里的 Key。如果你同时配置了环境变量和 auth.jsonauth.json 的优先级更高。所以如果你发现改了环境变量但没生效检查一下 auth.json 里是不是还留着旧的 Key。3.3 中文输出的核心配置AGENTS.md这是让 Codex 默认说中文的关键一步。在~/.codex/目录下创建AGENTS.md文件mkdir -p ~/.codex cat ~/.codex/AGENTS.md EOF 请始终使用简体中文回答除非我明确要求用其他语言。 代码注释可以用英文但解释性文字必须用中文。 EOF这个文件是 Codex 的全局指令文件每次启动时都会自动加载。里面的内容会作为系统提示词的一部分发给模型所以模型会默认用中文回复。你可以根据需要调整措辞比如加上「技术术语保留英文原文」之类的规则。如果你只想让某个特定项目用中文可以在项目根目录放一个AGENTS.md项目级的会覆盖全局的。这样你就能在不同项目之间灵活切换语言。3.4 VS Code 插件的 settings 配置VS Code 里的 Codex 插件配置分两处。第一处是插件的专属设置通过命令面板打开CtrlShiftP→ 输入Codex: Open Settings。在设置面板里找到 Base URL 和 API Key 两个字段分别填入{ codex.baseUrl: https://taotoken.net/api, codex.apiKey: sk-你的实际Key, codex.model: 你的模型ID }第二处是 VS Code 的全局 settings.json通过CtrlShiftP→Preferences: Open User Settings (JSON)打开。在这里可以配置中文输出相关的行为{ codex.systemPrompt: 请始终使用简体中文回答除非我明确要求用其他语言。, files.encoding: utf8, terminal.integrated.defaultProfile.osx: zsh }codex.systemPrompt是插件级别的系统提示词效果和 CLI 的 AGENTS.md 类似。files.encoding设为 utf8 是为了避免中文乱码。如果你在 Windows 上终端编码也要确认一下PowerShell 默认可能是 GBK需要改成 UTF-8。改完这些配置后重启 VS Code 让设置生效。重启之后打开 Codex 面板发一句中文问题测试一下。4. 验证请求一次中文提问确认输出语言是否生效配置改完之后必须做一次实际验证否则你永远不知道是配置生效了还是模型碰巧用了中文。验证方法很简单发一句明确要求中文的问题观察回复语言。在 Codex CLI 里直接输入codex 用一句话介绍你自己并说明你当前使用的模型ID是什么如果配置正确你会看到模型用简体中文回复并且能说出你配置的 Model ID。如果它用英文回复说明 AGENTS.md 没被加载检查一下文件路径和内容编码。在 VS Code 插件里打开 Codex 面板输入同样的问题。观察回复的语言。如果 CLI 是中文但 VS Code 是英文说明插件的 systemPrompt 没生效检查 settings.json 里的字段名是否拼写正确。还有一种情况是回复中英混杂。这通常是因为系统提示词不够强硬模型在遇到技术术语时自动切换成了英文。解决办法是在 AGENTS.md 里加一句「所有解释性文字必须用中文技术术语可以保留英文原文但需要用中文解释」。验证的时候还可以顺便确认请求走的是不是 TaoToken 通道。方法是在 CLI 里加--verbose参数或者在 VS Code 的输出面板里查看请求日志。如果日志里显示的 Base URL 是https://taotoken.net/api说明通道配置正确。如果显示的是其他地址说明配置没生效需要回头检查 config.toml 或 settings.json。一个完整的验证流程是这样的先确认环境变量或 auth.json 里的 Key 正确再确认 config.toml 里的 Base URL 正确然后确认 AGENTS.md 存在且内容正确最后发一句中文问题观察回复。四步都通过说明配置完全生效。如果你在验证时遇到 401 错误说明 Key 无效或没被读取到。检查 auth.json 里的字段名是否为OPENAI_API_KEY以及环境变量是否在正确的 shell 里导出。如果遇到local proxy failed之类的错误说明 Base URL 填错了确认地址是https://taotoken.net/api而不是其他路径。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 报错对照配置过程中最容易踩的坑集中在几个典型报错上。下面逐个对照说明。401 Unauthorized这是最常见的认证错误。原因通常是 Key 无效、Key 没被读取到、或者 auth.json 字段名写错了。排查步骤先用echo $TAOTOKEN_API_KEY确认环境变量有值再检查~/.codex/auth.json里的字段名是否为OPENAI_API_KEY最后确认 Key 没有多余的空格或换行。如果用的是 VS Code 插件检查 settings.json 里的codex.apiKey是否填对。local proxy failed这个报错通常出现在 Base URL 配置错误的时候。Codex 会尝试连接你填的地址如果地址格式不对或者路径多了/v1就会报这个错。正确地址是https://taotoken.net/api不要加任何后缀。另外确认你的网络能正常访问这个地址可以用curl https://taotoken.net/api测试一下连通性。reading choices 相关报错这个错误说明请求发出去了但返回的数据结构不符合预期。常见原因是 Model ID 填错了或者 wire_api 配置不对。检查 config.toml 里的wire_api是否为chat以及model字段是否和 TaoToken 模型列表里的 ID 完全一致。注意大小写敏感。OAuth 相关报错如果你之前用官方通道登录过auth.json 里可能残留了 OAuth token。切换到 TaoToken 统一 Key 时需要把 auth.json 里的 OAuth 字段删掉只保留OPENAI_API_KEY字段。否则 Codex 会优先尝试 OAuth 认证导致冲突。中文乱码这不是请求错误而是终端或编辑器的编码问题。在 VS Code 里把files.encoding设为utf8。在终端里macOS 和 Linux 默认是 UTF-8Windows 的 PowerShell 需要执行chcp 65001切换到 UTF-8。如果用的是 Windows Terminal可以在设置里把默认编码改成 UTF-8。配置改了但没生效Codex CLI 和 VS Code 插件都会在启动时读取配置改完配置文件后需要重启工具。CLI 直接退出重进即可VS Code 需要完全关闭再打开或者执行Developer: Reload Window。模型偶尔回复英文这不是配置错误而是模型的行为波动。解决办法是在 AGENTS.md 里把提示词写得更强硬比如「无论任何情况都必须用简体中文回复不得使用英文」。另外可以在对话开头再强调一次语言要求模型会遵循最近的指令。排查的时候建议按顺序来先确认认证401再确认通道local proxy failed再确认模型reading choices最后确认语言配置AGENTS.md 或 systemPrompt。每一步都验证通过后再进行下一步这样能快速定位问题所在。6. 长期编码场景下的中文工作流把配置固化成习惯配置一次只能解决一时的问题真正高效的做法是把中文输出变成默认工作流的一部分。这里分享几个我在长期使用中总结出来的实用技巧。第一把 AGENTS.md 纳入版本管理。如果你有多个项目可以在每个项目的根目录放一个 AGENTS.md内容根据项目类型调整。比如前端项目可以加「组件命名用英文注释和文档用中文」后端项目可以加「接口文档用中文日志用英文」。这样切换项目时语言风格自动适配。第二VS Code 的工作区设置可以覆盖全局设置。在项目根目录创建.vscode/settings.json把codex.systemPrompt写进去这样只对当前项目生效。团队协作时把这个文件提交到仓库所有成员都能统一中文输出风格。第三CLI 和 VS Code 共用同一个 Key 但分开管理。在 TaoToken 控制台生成两个 Key一个给 CLI 用一个给 VS Code 用。这样如果某个工具的 Key 需要轮换不会影响另一个工具。同时也能通过控制台的用量统计分别查看两端的调用情况。第四定期检查配置是否被覆盖。有些工具升级后会重置配置文件或者新增的默认值会覆盖你之前的设置。建议每隔一段时间用codex --version确认版本然后检查 config.toml 和 auth.json 是否还是你配置的内容。第五中文提示词要具体。不要只写「请用中文回答」而是写清楚哪些部分用中文、哪些部分保留英文。比如「解释性文字用简体中文代码和命令保持原样技术术语首次出现时用中文加英文原文标注」。这样模型的行为更可控。如果你需要更详细的接入文档可以访问 TaoToken 接入文档 查看完整的配置说明。需要生成新的 API Key 时到 API Keys 管理页面 操作即可。如果你还在选模型可以先到 模型对话页面 试试不同模型的中文表现找到最适合你编码场景的那个。长期做编码和 Agent 任务的话Coding Plan 会更划算一些。