先说结论Opencode这个终端里的AI编码代理用起来确实方便但默认情况下它并不会自觉说中文。你让它改代码它可能回你一大段英文甚至注释和提交信息也全部是英文在Windows上跑的话还可能碰到中文全部变成乱码的鬼情况。我前后折腾了一周把模型提示词、配置文件、终端编码这几个层次全部调了一遍现在基本能做到Opencode一直说简体中文代码里的注释也按中文习惯来。下面这些经验就是围绕“Opencode实现中文输出”这一件事展开的适合已经装好Opencode但被英文回复和乱码折磨的人也适合还没装但准备入坑的新手。1. Opencode是什么以及“中文输出”这个需求从哪来1.1 Opencode在AI编程工具里的定位Opencode是一个开源的终端AI编码代理简单说就是跑在命令行里的编程助手。你可以把它理解成“终端版的智能结对程序员”它会读取当前项目的目录结构调用大模型自己规划改动生成代码甚至执行命令。它和Claude Code、Codex命令行属于同一类工具但Opencode更强调轻量和高定制支持OpenAI、Anthropic、Google、DeepSeek、Qwen等多家模型服务商你可以在TUI界面里随时切换底层模型。我最初注意到Opencode是因为它启动速度快不占内存而且会话管理做得很干净。但真正上手之后第一个让我头疼的问题不是代码能力而是语言无论我在对话里输入什么它都默认回英语。一开始我以为是模型选错了换了很多个模型还是一样后来才意识到问题不在模型本身而在Opencode传给模型的系统指令里根本没有“使用中文”这回事。大模型在接收到的指令没有指定语言时会天然倾向于英文输出因为训练数据里英文占比最高这不是玄学是模型行为的基本规律。所以想让Opencode输出中文本质上是在做三件事第一在配置或系统提示词里说清楚“用中文回复”第二让终端能正确渲染中文字符第三选一个对中文理解足够好的模型。三条缺一不可少任何一条都可能让你的中文输出计划变成空谈。1.2 “英文回复”和“中文乱码”是两个完全不同的问题很多人看到屏幕上的中文变成乱码就把锅全甩给Opencode其实这锅得分清楚。我遇到过的情况有三种典型表现模型完全用英文回复模型用中文回复但屏幕上全是“锟斤拷”模型输出英文和中文混杂在一起且中文部分显示成方块或问号。这三种现象的成因和修复方式完全不一样。我自己的快速判断方法很简单在Opencode里输入一句“请用中文回复”。如果是英文回复说明模型层没有接收到语言指令要去调配置和系统提示词如果模型明明在用中文回答但屏幕上出现乱码、方块、繁体字或日式汉字那就是终端编码、字体或模型语言偏好的问题。一定要先分清是哪一层再动手修。我之前就是先改了一大堆配置结果乱码依旧后来才发现是Windows终端代码页没切到UTF-8白折腾了半小时。2. 安装与环境准备先把工具跑起来2.1 不同平台下Opencode的安装方式安装Opencode的方式不复杂但平台不同坑也不一样。macOS和Linux下最简单的办法是用Homebrew安装brew install opencode-ai如果你已经装了Node.js也可以直接通过npm全局安装npm install -g opencode-aiWindows下也一样可以用npm安装但要注意Node.js版本不能太老。我建议用Node 18以上最好用20 LTS。安装完成后在终端输入opencode就能启动第一次启动会让你选择模型服务商和配置API Key。有一个老Windows用户容易踩的坑启动时提示node_modules\opencode\cli\bin\opencode.exe 与你运行的 Windows 版本不兼容。这个问题通常不是Opencode本身坏了而是系统组件太旧缺少必要的运行库。我的建议是不要硬刚直接装一个新版Windows Terminal然后把大部分实际工作环境切到WSL2里面。在WSL2里安装Opencode方式和Linux完全一样而且字体、编码、路径问题都少很多尤其适合需要处理中文项目的开发者。2.2 Windows终端的中文编码和字体设置Windows默认代码页是936也就是GBK编码而Opencode输出的内容基本都是UTF-8这就导致中文字符在终端里经常显示成乱码。解决办法是先切代码页再启动Opencodechcp 65001如果你用的是PowerShell可以把输出编码也一起设置成UTF-8[Console]::OutputEncoding [System.Text.UTF8Encoding]::new() $OutputEncoding [System.Text.UTF8Encoding]::new()这一步做完大部分“中文变问号”的问题都能解决。但如果你遇到的是“中文变成一格格小方块”那不是编码问题是字体问题。Windows Terminal默认字体对部分中文字形支持得不好建议在终端设置里把字体改成支持中文的等宽字体比如更纱黑体、Sarasa Mono SC、JetBrains Mono Plus Nerd Font这一类。Linux和macOS下一般不需要折腾字体但如果遇到类似问题检查一下LANG环境变量建议设置为zh_CN.UTF-8。3. 核心配置让Opencode每次都输出中文3.1 配置文件的优先级和位置Opencode的配置分两个层级。全局配置存放在~/.config/opencode/config.jsonWindows下是%USERPROFILE%\.config\opencode\config.json它影响你所有项目的会话。项目配置是放在项目根目录下的opencode.json只对当前项目生效优先级高于全局配置。如果你只想让某个项目使用中文就在项目根目录里改局部配置。我自己用得最多的不是opencode.json而是项目根目录下的AGENTS.md文件。这个文件的定位是“项目规则说明书”Opencode启动时会自动读取它把里面的内容作为上下文的一部分传给模型。你可以在里面写各种持久化规则包括输出语言、代码风格、目录规范等等。它和配置文件互补配置文件管模型和指令AGENTS.md管项目级约束。让中文输出稳定最好两个都配。3.2 用instructions字段强制指定中文在Opencode的配置文件里有一个instructions字段可以用来追加系统提示词。我的配置通常是这样的{ provider: anthropic, model: claude-sonnet-4, instructions: [ 你是一个面向中文开发者的编程助手。, 始终使用简体中文回复。, 所有代码注释、文档字符串、提交信息都必须使用中文。, 如果必须保留英文技术名词请在第一次出现时补充中文解释。, 代码中的变量名和函数名保持英文不要使用拼音命名。 ] }关键点在于指令要写得足够具体。只写“请用中文回答”是没用的模型可能会偷懒在代码注释里继续用英文。我把注释、提交信息、文档说明这些具体输出项都写进instructions之后模型的中文输出率几乎稳定在95%以上。这个细节非常重要因为大模型的提示词遵循“越具体越容易遵守”的规律指令越含糊模型的自由度就越大。3.3 用AGENTS.md做项目级语言规则如果某个项目需要长期保持中文输出我强烈建议在项目根目录创建AGENTS.md。这是一个纯Markdown文件不需要任何特殊扩展名写清楚规则就能生效。我常用的模板# 项目规则 - 所有与用户的对话必须使用简体中文。 - 代码中的注释必须使用中文但代码标识符保持英文。 - 提交信息、Pull Request描述、文档说明必须使用中文。 - 不要擅自将代码中的英文关键字翻译成中文。这个文件放好之后Opencode每次进入项目都会自动读到效果比对话里临时叮嘱稳定得多。要注意的是AGENTS.md是在会话启动时读取的如果你在一个已有会话中修改了它需要重启Opencode才会生效。这个坑我踩过一次改完文件发现没用差点以为是功能失效。4. 实操演示从安装到第一次完整中文对话4.1 Windows下的一条完整可复现流程我以Windows Node环境为例给你一条直接从零跑通中文输出的完整流程。建议用Windows Terminal不要用老版CMD。第一步打开Windows Terminal切换代码页chcp 65001第二步确认Node版本然后安装Opencodenode -v npm install -g opencode-ai第三步创建一个测试目录并放入AGENTS.mdmkdir demo cd demo echo # 项目规则 - 必须使用简体中文回复。 - 代码注释必须使用中文。 AGENTS.md第四步启动Opencodeopencode启动后在TUI界面里选择你已有的模型服务商填入API Key然后在输入框里测试一句“用Python写一个快速排序注释全部用中文”。我在这个流程下实测回复里从代码注释到外层解释说基本全是中文。如果你想用某个特定模型可以在TUI里通过/model命令切换比如切到DeepSeek或Qwen中文输出的自然度会更好。4.2 配置前后的一次代码生成对比我用一个实际项目场景来说明配置的作用。之前在一个Python项目里我让Opencode写日志模块没配置中文规则时它给出的代码注释全是英文def log_info(msg: str) - None: Log a regular info message. logger logging.getLogger(__name__) logger.info(msg) print(f[INFO] {msg})虽然能看懂但一个中文团队接手的项目里全英文注释还是让人膈应。后来配置了instructions和AGENTS.md重新开会话问同样的问题输出变成def log_info(msg: str) - None: 记录一条常规信息日志 logger logging.getLogger(__name__) logger.info(msg) print(f[INFO] {msg})注意看函数名、变量名依然是英文但注释说明变成了中文。这是最理想的状态代码本身保持工程规范只有“人读的部分”用中文表达。如果你不小心把规则写成了“所有代码必须使用中文”模型反而可能把变量名也改成中文拼音那才是灾难。所以在配置里一定要明确代码标识符保持英文注释和文档用中文。5. 常见问题排查中文输出的坑我都替你踩过5.1 “只思考不回答”和免费额度报错怎么处理很多人在Opencode里会遇到模型一直显示思考中但迟迟不输出文字的情况。这个现象和中文输出有一定关联如果模型接收到的中文指令太模糊它可能会在内部反复用英文组织思路导致响应时间过长甚至直接超时。我的建议是先切换到一个对中文支持较好的模型比如DeepSeek、Qwen、GLM系列这些模型对中文指令的响应更直接同时把系统提示词精简到几条清晰明确的要求不要堆叠太多互相矛盾的规则。还有一种情况你会看到类似error from provider (console): opencodes free tier can only be used from within opencode的报错。我第一次看到时也懵了后来才搞明白这是Opencode免费额度的授权限制意思是免费额度只能在Opencode官方客户端里使用。如果你在VSCode插件、Web界面或者第三方转发工具里调用就会触发这个报错。解决办法很简单直接在Opencode的CLI/TUI或桌面版里使用不要在外围工具里折腾。这个问题本身和中文输出无关但很多人遇到后会误以为是账号配错了所以我专门提出来。5.2 中文乱码的三种修复方案我整理了一份速查表覆盖常见的三种乱码表现现象原因解决方案中文变成“锟斤拷”终端代码页不是UTF-8执行chcp 65001中文变成“口口口”豆腐块字体缺少中文字形更换支持中文的等宽字体输出繁体字或日式汉字模型对语言区域判断不准在instructions和AGENTS.md中强制写“简体中文”这三个问题可以同时存在所以如果只修一项发现没效果就把三项全部做一遍。完成之后重启Opencode会话再测试一句“用中文回复你的上一段内容”。如果屏幕上能正常显示简体中文就说明所有链路都通了。不要嫌麻烦这一步能帮你节省后面大量的排查时间。5.3 查看token消耗避免中文会话中断中文输出比英文更消耗token这点很多人没意识到。在处理中文时模型的分词器会把一个汉字拆成多个token所以同样需求下中文对话的token消耗大概率比英文对话高30%到50%。如果你用的是免费额度或者有限配额很容易在开发到一半时突然被截断。Opencode里可以用/tokens命令查看当前会话的token消耗量也可以启动时加--debug参数查看更详细的请求日志。我自己习惯在每个长会话的中途检查一次消耗确认剩余额度充足后再继续问大需求。别小看这一步能避免很多“生成到一半断掉辛辛苦苦的上下文全白费”的体验。5.4 桌面版和Web版的局域网访问Opencode桌面版和Web模式默认只监听本机地址127.0.0.1所以你想在局域网里另一台电脑上访问同一个会话时会发现连不上。解决办法是手动指定监听地址opencode serve --host 0.0.0.0 --port 8000这样同一局域网内的设备就可以通过http://主机IP:8000访问了。需要提醒的是绑定0.0.0.0意味着局域网内任何人都可能看到你的会话内容所以不要在上面输入敏感密钥用完记得改回本机监听。这个设置和中文输出关系不大但既然很多人反馈“桌面版里中文显示正常网页端却乱码”通常就是没改对监听地址和终端环境。5.5 插件场景下的中文输入问题有人问过“idea的opencode插件怎么滑动内容”其实这更多是插件交互习惯问题。目前Opencode官方的工作重心在CLI和桌面版VSCode或IDEA插件主要是作为前端连接Opencode后端服务。插件里遇到中文乱码或输入法无法选字先不要在插件里单独调编码而是先在CLI里把UTF-8配置调通再让插件连接同一个服务。插件本身不会改变模型的中文输出能力它只是显示层所以核心问题还要回到底层配置上。6. 进阶玩法Skills和模型选型6.1 用Skills固化中文输出规则Opencode支持Skills机制这个概念类似于Claude Code的Agent Skills。你可以把一组固定的指令打包成一个Skill在需要时调用。比如可以自定义一个“中文模式”Skill里面写清楚所有关于中文输出的规则包括注释、提交信息、文档语言、术语处理方式。每次需要严格中文输出时直接调用这个Skill不用重新打字比改配置更灵活。我建议把自己常用的中文规则整理成一个Markdown文件放在Opencode的Skills目录下比如中文规范.md里面写技能名称中文输出规范 调用条件用户要求使用中文时 规则 1. 所有回复使用简体中文。 2. 代码注释、文档字符串、提交信息全部使用中文。 3. 变量名、函数名、关键字保持英文。 4. 遇到不确定翻译的术语保留英文并补充中文解释。这样把规则独立成技能之后你可以在不同项目里自由开关而不用反复改全局配置。它也更适合在一个团队里共享把文件放到同一个目录所有人都能使用相同的中文规范。6.2 不同模型的中文输出差异与选择同样是Opencode底层模型不同中文输出的质量差距很大。我实测过的几个常见选择里DeepSeek和Qwen系列对中文的响应更自然尤其是代码注释和代码理解上中文表达很顺畅Claude系列本身中文能力不弱但需要明确指令才会稳定输出中文GPT系列如果你不指定语言会非常顽固地回英文。所以如果你的核心诉求就是“Opencode稳定输出中文”建议优先选择对中文支持更好的模型不要为了追求某个英文能力特别强的模型委屈自己。Opencode支持在配置里指定模型也支持在会话里用/model实时切换。我会在项目初期就选定一个以中文为主的工作模型并把它写进项目的opencode.json里避免每次启动都要手动切。6.3 一份可以直接抄的完整配置模板这里给出一份适合大多数项目的配置模板你可以直接复制到项目的opencode.json里{ provider: deepseek, model: deepseek-chat, instructions: [ 你必须使用简体中文回复除非用户明确要求英文。, 代码注释、文档字符串、提交信息必须使用中文。, 变量名、函数名、类名保持英文不得使用拼音命名。, 技术术语第一次出现时可以保留英文并附中文解释。 ], language: zh-CN }同时在项目根目录放一个AGENTS.md内容保持简洁。这套组合搭配下来我目前的经验是Opencode在代码生成、注释书写、提交信息三个核心场景的中文输出都相当稳定。如果你一开始没达到这个效果别急着怀疑模板先确认终端编码和模型选型没出问题因为这三项是互相支撑的关系。7. 一些真正有效的收尾经验7.1 我现在的“三重保险”组合到目前为止我让Opencode保持中文输出最稳定的方案是同时做三件事全局配置里写清楚instructions项目根目录放AGENTS.md终端固定UTF-8编码。这三件事分别解决了模型指令、项目约束、终端渲染三个层面的问题。只做其中一项短期可能有用但一旦切换项目、切换模型或者换一台电脑中文输出就可能重新变成英文或乱码。我之所以强调“三重保险”是因为我实际踩过很多次只改配置不管编码、或者只调终端不调模型的坑。配置和终端看着像两套独立系统但最后都要落在这个终端窗口里呈现任何一个环节掉链子效果都会打折扣。如果你也准备长期把Opencode作为主力编程工具我建议你按照上面的顺序一次配好不要偷懒。7.2 遇到英文回复时的应急技巧最后分享一个我每天都会用的小技巧。如果Opencode在某个会话里又突然冒出英文回复不用着急去改配置直接在对话里补一句“请用中文重写你刚才的回答”。这个指令会把已经生成的英文内容重新以中文输出一遍同时会提醒模型后续都保持中文。实测下来这个办法处理长会话特别有效尤其是那些已经聊了十几轮、突然因为上下文被压缩而切回英文的情况。另外如果你发现Opencode只思考不回答优先检查是不是token配额用完了或者当前模型卡住。重开会话、切换模型、清空上下文再试基本都是最快的解决路径。这个工具的很多问题不是它坏了而是我们给它的指令不够具体。把中文要求写清楚它就能稳定做到中文输出。