1. 为什么 Codex 在 VS Code 里会突然切回英文你大概遇到过这种场景在 VS Code 里用 Codex 插件改一个 Python 脚本前面几轮对话都老老实实说中文结果你贴了一段 traceback 进去它下一句就开始 Let me analyze the error...。再问一次它又切回中文。这种语言漂移不是插件坏了而是 Codex 本身没有语言开关它输出什么语言是当前上下文里所有指令博弈后的结果。先把机制讲清楚后面调优才不会瞎试。Codex 的 base instructions 是英文写的模型天然会跟随系统提示的语言风格。当你提问很短、或者上下文里塞满了英文代码、英文报错、英文注释、英文 commit message模型判断当前语境是英文的概率就上去了。它看的不是你最后一句话而是整个上下文窗口的语言分布。第二个来源是 AGENTS.md。这个文件是 Codex 读取项目约定的入口如果项目根目录的 AGENTS.md 是英文写的或者压根没写语言要求那模型就没有任何必须说中文的约束。很多人以为装了中文插件就万事大吉其实插件界面语言和模型输出语言是两回事。第三个坑是内置子命令。像/review这类命令走的是独立的审查 Agent有自己的提示词模板不一定读你的语言偏好。有用户反馈即使 AGENTS.md 里明确写了始终用日文回答/review依然固定输出英文。中文环境下同理这类命令的语言问题属于已知限制只能在使用时临时补一句中文要求。第四个原因是配置没真正生效。AGENTS.md 放错位置想全局生效却放在项目里或者反过来、改完配置没重启会话、配了model_instructions_file但文件里没写语言要求都会导致你以为配了其实没配。旧会话不会自动加载新指令这一点特别容易被忽略。最后一个原因是模型本身。如果你通过自定义model_provider接了第三方模型或中转服务不同模型对中文指令的遵循能力差异很大。有些模型在多语言混排场景下默认回英文这时候再怎么写 AGENTS.md 也压不住得换模型或者换接入方式。理解这五层原因之后调优思路就清晰了从最轻量的会话内指令到全局 AGENTS.md再到项目级 AGENTS.md最后才是model_instructions_file这种强力手段。下面按这个顺序逐层给可复制的配置。2. TaoToken 前置准备与 Codex 接入配置在动语言配置之前得先保证 Codex 能稳定连上模型。如果你用的是官方直连可以跳过这一节如果你通过 TaoToken 这类聚合服务接入需要先把 Base URL、API Key、Model ID 三件套配好否则后面调语言调半天发现是请求根本没通白折腾。TaoToken 的定位是给开发者提供统一的模型调用入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它的作用是让你用一套 Key 和 Base URL 访问多个模型省去每个模型单独申请和配置的麻烦。对于 Codex 这种需要频繁切换模型做对比的场景比较实用。Codex 的配置文件在~/.codex/config.toml。如果你还没建过这个文件先创建目录mkdir -p ~/.codex touch ~/.codex/config.toml然后写入模型 provider 配置。下面是一个可复制的 TOML 片段路径和字段名保持和 Codex 官方一致# ~/.codex/config.toml model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat这里几个字段要解释一下。model是你默认使用的模型 ID按你实际要用的填。model_provider指向下面定义的 provider 名。base_url填 TaoToken 的 API 地址注意不要带 UTM 参数API 调用只需要干净的端点。env_key是读取 API Key 的环境变量名这样 Key 不用明文写在配置文件里。wire_api一般填chat对应 OpenAI 兼容的 chat completions 接口。接着把 API Key 写进环境变量。在~/.bashrc或~/.zshrc里加一行export TAOTOKEN_API_KEYsk-你的实际Key然后source ~/.zshrc让它生效。Key 的获取入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后在控制台创建即可。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 VS Code 插件而不是 CLI插件设置里同样需要填 Base URL 和 API Key。打开 VS Code 设置搜索 Codex找到模型配置区域把 Base URL 填成https://taotoken.net/apiAPI Key 填你的 KeyModel ID 填你要用的模型。三件套缺一不可只填 Key 不填 Base URL 会走默认端点只填 Base URL 不填 Model ID 会报模型不存在。配好之后先做一次连通性验证别急着调语言。在终端跑codex 用一句话说明你现在用的是哪个模型如果返回正常内容说明接入通了。如果报 401说明 Key 没读到或者 Key 无效如果报连接超时检查 Base URL 是否写错。这一步过了再进入语言调优。3. 从 AGENTS.md 到 config.toml 的可复制配置语言调优分四层从轻到重。建议按顺序试不要一上来就动model_instructions_file。第一层会话内直接说。进入 Codex 交互界面后发一句从现在开始请始终使用简体中文回答我包括解释、总结和提交信息。通常从这一轮起就会用中文回复。但这只对当前会话有效新开窗口就失效了适合应急。第二层全局 AGENTS.md。这是最推荐的方案所有项目生效。在用户目录下创建mkdir -p ~/.codex cat ~/.codex/AGENTS.md EOF # 语言要求 - 始终使用简体中文回复Always respond in Chinese-Simplified。 - 所有解释、计划、总结、代码审查意见、commit message 均使用中文。 - 代码本身、变量名、技术专有名词保持英文原样不要翻译。 EOF这里有个关键技巧中英双语写指令效果更好。模型对英文指令的遵循权重通常更高中英对照能显著降低偶尔蹦英文的概率。同时要明确写出哪些要中文、哪些保持英文否则它可能把变量名也翻译成中文那就更麻烦了。改完后必须重启 Codex 会话旧会话不会加载新配置。第三层项目级 AGENTS.md。在某个项目里执行/init会在项目根目录生成 AGENTS.md在里面加上同样的语言要求。这个文件可以提交到 Git 仓库让全团队共享同一套语言规范。优先级上项目级 AGENTS.md 会叠加在全局配置之上两者不冲突。第四层model_instructions_file。如果 AGENTS.md 仍然压不住英文输出比如某些模型的英文倾向很强可以在~/.codex/config.toml里指定自定义指令文件# ~/.codex/config.toml model_instructions_file /home/yourname/.codex/prompts/my-instructions.md注意这个字段是整体替换 Codex 内置的 base instructions而不是追加。这意味着官方的安全对齐、工具调用规范等提示词全部失效可能导致功能异常或行为不可控。一般情况下第二层加第三层已经足够除非你有明确的高级定制需求否则不建议动这个字段。如果非要用至少把语言要求写全# 自定义指令 You are a coding assistant. Always respond in Simplified Chinese. 所有解释、计划、总结、代码审查意见、commit message 均使用中文。 代码本身、变量名、技术专有名词保持英文原样。VS Code 插件用户还有一层 GUI 配置。打开插件设置查找语言选项选择中文简体或者在自定义指令框里写明中文要求。桌面应用则在设置齿轮图标里的 Personalization 区域填写自定义指令。这层配置和 AGENTS.md 是叠加关系不冲突。四层配置的优先级从低到高是会话内指令 全局 AGENTS.md 项目级 AGENTS.md model_instructions_file。实际生效时是叠加的后面的会覆盖前面的同类要求。所以如果你在项目级 AGENTS.md 里写了英文指令它会盖掉全局的中文要求这就是为什么有人配了全局还是出英文。4. 验证请求与成功结果确认配完之后不能凭感觉要用固定测试语句做回归。最小验证语句是请用中文简要说明你对本次会话的语言设置。如果返回的是中文说明配置生效了。但一次通过不代表稳定因为语言漂移往往在特定触发条件下才出现。建议做三组回归测试。第一组纯中文提问。连续问三个中文问题看是否全程中文。这组测的是基础语言偏好。第二组中英混排提问。贴一段英文报错然后用中文问这个错误怎么解决。这组测的是上下文英文占主导时模型会不会被带跑。这是最容易暴露问题的一组。第三组触发内置命令。如果你常用/review跑一次看输出语言。如果它固定出英文说明是命令本身的限制不是你配置的问题只能在使用时临时补一句请用中文输出审查结果。三组都通过基本可以认为稳定了。如果第二组挂了说明 AGENTS.md 的权重不够需要加强指令比如把语言要求放在文件最顶部或者加上即使上下文包含英文代码和报错回复也必须使用中文这样的显式约束。验证时还要注意会话状态。每次改完配置必须完全退出 Codex 再重开不是新开一个对话窗口就行。CLI 的话按 CtrlC 退出进程再重新运行VS Code 插件的话关掉插件面板不够要重启 VS Code 窗口或者用命令面板执行 Reload Window。成功的结果长这样你贴一段英文 traceback问这个怎么修它用中文解释错误原因代码块里的变量名和函数名保持英文解释文字是中文。如果它把变量名也翻译成中文了说明 AGENTS.md 里代码保持英文原样那条没写清楚回去补上。5. 本篇常见报错排查调优过程中会遇到几类典型报错逐个说清楚。第一类401 Unauthorized。这个和语言配置无关是接入层的问题。原因通常是 API Key 没读到、Key 无效、或者环境变量名和 config.toml 里的env_key对不上。排查步骤先echo $TAOTOKEN_API_KEY看环境变量有没有值再看 config.toml 里env_key写的是不是TAOTOKEN_API_KEY最后确认 Key 没有过期。如果用的是 VS Code 插件检查插件设置里的 Key 有没有填错。第二类local proxy failed 或连接超时。这个通常是 Base URL 写错了。检查 config.toml 里base_url是不是https://taotoken.net/api注意不要多写路径也不要带查询参数。如果你在插件里填的是https://taotoken.net/api/v1有些客户端会拼成/api/v1/chat/completions而实际端点可能不接受这个路径就会报错。以文档为准接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。第三类reading choices 相关报错。这个一般出现在响应格式不匹配时比如wire_api填错了。如果你用的是 chat completions 接口wire_api填chat如果用的是 responses 接口填responses。填错会导致解析响应时找不到choices字段。检查 config.toml 里这一项。第四类OAuth 相关报错。如果你之前用官方账号登录过Codex 可能缓存了 OAuth token切换 provider 后旧 token 还在导致认证冲突。解决办法是清掉缓存目录通常在~/.codex/下找 auth 相关文件删掉然后重新用 API Key 认证。第五类配置改了但没生效。这个最常见。排查顺序确认文件路径对不对全局是~/.codex/AGENTS.md不是项目目录确认会话重启了没有确认项目级 AGENTS.md 有没有覆盖全局配置确认model_instructions_file有没有被设置如果设了它会替换掉内置指令可能把你的语言要求也冲掉。第六类特定命令语言不受控。/review这类内置命令有独立提示词已知可能无视语言设置。变通方法是在使用时追加请用中文输出审查结果。如果这个命令你用得频繁可以考虑在项目级 AGENTS.md 里针对它单独写一条约束但效果不保证。排查时建议开一个干净的测试会话不要在有大量历史上下文的会话里测因为历史上下文本身就会影响语言判断。新开会话用固定测试语句逐层验证。6. 稳定中文输出的长期实践把语言配置做稳之后日常使用还有几个习惯能减少漂移。第一AGENTS.md 里把语言要求放在最顶部。模型读指令时对开头部分的注意力更高放顶部比放中间有效。第二中英双语写关键约束。纯中文指令在某些模型上权重不够中英对照能明显提升遵循率。特别是始终使用简体中文这句配上 Always respond in Chinese-Simplified 效果更稳。第三明确例外项。写清楚代码、变量名、技术专有名词保持英文避免模型过度翻译。这条不写它可能把user_id翻译成用户标识反而影响可读性。第四项目级 AGENTS.md 提交到仓库。团队共享同一套语言规范避免每个人本地配置不一致导致输出风格混乱。第五换模型时重新验证。不同模型对中文指令的遵循能力差异很大换模型后跑一遍三组回归测试确认语言行为没变。如果你需要长期做编码和 Agent 任务可以考虑用 Coding Plan 这类套餐入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 适合高频调用场景。单纯想验证模型对话效果的话模型对话入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说一个我踩过的坑改完model_instructions_file之后忘了它替换的是整个内置指令结果工具调用行为变得很奇怪排查了半天才想起来是这个字段的副作用。所以除非你明确知道自己在做什么否则全局 AGENTS.md 加项目级 AGENTS.md 这两层就够了别轻易动model_instructions_file。语言调优的本质是给模型足够的约束信号而不是把它的底层行为改掉。约束给到位它自然就稳定说中文了。
