1. Windows 下这套组合到底解决什么问题OpenCode 是一个跑在终端里的 AI 编程助手oh-my-opencode 则是它的增强插件层通过多智能体协作把「一个对话框」升级成「一支小团队」。GLM 在这里扮演模型提供方的角色负责实际的推理与代码生成。三者组合起来适合重度终端用户、远程开发场景以及希望把 AI 编码工作流沉淀到本地的开发者。但 Windows 环境有个绕不开的麻烦配置文件路径散、环境变量写法怪、Key 管理容易乱。我见过太多人卡在「插件装了但模型不生效」「settings.json 放错目录」「环境变量在 PowerShell 和 CMD 里行为不一致」这几步上。这篇就按从零搭建的顺序把 OpenCode oh-my-opencode GLM 的完整链路走一遍重点放在可复制的配置骨架和一条能立刻验证通道连通的 curl 命令上。核心检索词先明确OpenCode 是终端 AI 编程助手oh-my-opencode 是它的多智能体插件GLM 是接入的模型通道Windows 是运行环境。适合谁适合已经在用终端写代码、想让 AI 帮忙做重构和批量修改、又不想把 Key 散落在多个工具里的开发者。整条链路的目标是用 TaoToken 统一 Key 接入让 OpenCode 通过一个入口调用 GLMoh-my-opencode 负责把任务拆给不同子智能体执行。下面从环境准备开始。2. TaoToken 前置统一 Key 与接入信息在动手改配置之前先把「Key 从哪来、往哪填」这件事定下来。TaoToken 在这里的作用是提供一个统一的接入入口你不需要为每个工具单独申请一套凭证而是用同一个 Key 去对接模型通道。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。第一步是拿到 API Key。进入控制台的 API Keys 页面创建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后立刻复制保存页面通常只完整显示一次。这个 Key 后面会同时用在 OpenCode 的模型配置和 curl 验证里。第二步是确认你要用的模型标识。GLM 系列在通道里通常以模型名区分具体名称以文档为准接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你不确定该填哪个模型名可以先到模型对话页面试一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 在网页里选 GLM 发一条消息确认能通再把这个模型名抄进配置文件。注意Key 不要写进会提交到 Git 的文件里。Windows 下建议用系统环境变量存 Key配置文件里只引用变量名。这样即使你把配置分享出去也不会泄露凭证。第三步是理解接入结构。OpenCode 读的是它自己的配置文件oh-my-opencode 读的是插件配置两者都需要知道「用哪个模型、走哪个 API 地址、用哪个 Key」。统一 Key 的意义就在于这三处填的是同一个 Key 和同一个 API 基址改的时候只改一处环境变量即可。3. 可复制配置settings.json 与 config.toml 骨架Windows 下最容易踩的坑就是路径。OpenCode 的配置目录默认在用户主目录下的.config/opencode/在 Windows 上对应C:\Users\你的用户名\.config\opencode\。oh-my-opencode 的插件配置也放在同一目录下文件名是oh-my-opencode.json。先把目录建好# 在 PowerShell 中执行创建配置目录 New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.config\opencode然后是环境变量。Windows 下推荐用「用户级环境变量」这样新开的终端都能读到。设置两个一个存 Key一个存 API 基址。# 设置用户级环境变量当前用户永久生效 [Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key粘贴在这里, User) [Environment]::SetEnvironmentVariable(TAOTOKEN_BASE_URL, https://taotoken.net/api, User)设置完必须重开终端才生效这点很多人会忽略然后在旧终端里调试半天以为配置错了。接下来是 OpenCode 的主配置。它支持 JSON 格式路径为C:\Users\你的用户名\.config\opencode\opencode.json。下面是一个可复制的骨架重点是 provider 段和 model 段{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: {env:TAOTOKEN_API_KEY} }, models: { glm-4.6: { name: GLM-4.6 } } } }, model: taotoken/glm-4.6 }这里{env:TAOTOKEN_API_KEY}是 OpenCode 的环境变量引用语法它会去读你刚设的系统变量而不是把 Key 硬编码进去。model字段指定默认用哪个模型格式是provider/model。然后是 oh-my-opencode 的插件配置路径为C:\Users\你的用户名\.config\opencode\oh-my-opencode.json。这个文件控制多智能体的行为包括权限和不同 Agent 用哪个模型{ permission: { edit: allow, bash: allow, web: allow }, agents: { sisyphus: { model: taotoken/glm-4.6 }, explore: { model: taotoken/glm-4.6 } } }permission里把edit、bash、web设为allow是为了让无人值守模式ultrawork能自动改代码、跑命令、查资料而不频繁弹确认。如果你更谨慎可以先保持默认的ask等熟悉了再放开。提示如果你更习惯 TOML 风格OpenCode 的部分版本也支持config.toml字段名与 JSON 一致只是语法不同。但 Windows 下建议优先用 JSON因为路径和转义问题更少社区示例也更多。配置写完后检查一下文件编码。Windows 记事本有时会存成带 BOM 的 UTF-8导致解析失败。用 VS Code 或 Notepad 另存为「UTF-8 无 BOM」最稳妥。4. 验证请求一条 curl 确认 GLM 通道连通配置文件写得再漂亮不通就是不通。所以在启动 OpenCode 之前先用一条 curl 命令确认 TaoToken 的 GLM 通道是活的。Windows 10 及以上自带 curl直接在 PowerShell 里跑curl -X POST https://taotoken.net/api/chat/completions -H Authorization: Bearer $env:TAOTOKEN_API_KEY -H Content-Type: application/json -d { model: glm-4.6, messages: [ {role: user, content: 只回复两个字连通} ] }注意 PowerShell 里换行用反引号不是反斜杠。如果你在 CMD 里跑换行符和变量语法都不一样建议统一用 PowerShell。$env:TAOTOKEN_API_KEY会读取你设的环境变量前提是终端已经重开过。成功的话你会看到一段 JSON 返回结构里包含choices数组message.content字段就是模型回复的内容。如果返回里带了正常的回复文本说明 Key、API 基址、模型名三者都对上了。如果返回的是错误先看 HTTP 状态码401 通常是 Key 没读到或写错404 多半是模型名不对400 可能是请求体格式问题。把返回的完整 JSON 贴出来看error.message字段比猜快得多。通道确认连通后再启动 OpenCode# 进入你的项目目录 cd D:\projects\your-project # 启动 OpenCode opencode进入 TUI 后先跑一次/init它会在项目根目录生成AGENTS.md。这个文件是项目的「说明书」你可以在里面写技术栈、代码规范、目录约定。AI 会优先读它来理解项目这一步做扎实后面生成代码的准确率会明显不一样。5. 本篇常见错排查第一个高频问题环境变量设了但读不到。原因通常是设完之后没重开终端或者设到了「系统变量」但当前进程没刷新。验证方法是新开一个 PowerShell 窗口执行echo $env:TAOTOKEN_API_KEY能打印出 Key 就说明生效了。如果打印为空回到第 3 步重设。第二个问题配置文件路径放错。Windows 下.config是隐藏目录资源管理器默认不显示。你可以在地址栏直接输入%USERPROFILE%\.config\opencode回车进入。确认opencode.json和oh-my-opencode.json都在这个目录下而不是在项目目录里。放错位置的表现是「配置改了但完全没生效」。第三个问题JSON 语法错误导致整个配置被忽略。常见的是多了一个逗号、少了引号、或者用了中文引号。用 VS Code 打开文件它会直接标红。也可以在线用 JSON 校验工具过一遍。配置文件解析失败时OpenCode 往往不会报很明确的错只是默默用默认值所以这一步要主动检查。第四个问题模型名和通道里的实际名称不一致。你在网页模型对话里能选到的名字才是能用的名字。如果配置里写的glm-4.6在通道里叫别的就会 404。以接入文档和模型对话页面显示的为准。第五个问题oh-my-opencode 装了但插件没加载。装完之后启动 OpenCode看启动日志里有没有插件标识。如果没有检查全局安装是否成功以及 Node 版本是否满足要求。版本过低时插件可能装上了但运行时报错。第六个问题无人值守模式跑飞。permission全设成allow之后AI 会自动执行 shell 命令。建议第一次在非核心的测试项目里试确认行为符合预期再放到正式项目。/undo可以撤销上一条消息和文件更改但前提是项目用了 Git所以务必先git init并提交一次初始状态。6. 把工作流固定下来的几个习惯配置跑通只是起点真正省时间的是把交互习惯固定下来。我的做法是每个新项目第一件事就是/init生成AGENTS.md然后花五分钟把技术栈和规范写清楚。这一步的投入产出比最高因为后面所有对话都建立在这个上下文之上。复杂需求先切到 Plan 模式让它出方案确认没问题再切 Build 模式执行。oh-my-opencode 的 Tab 键可以在不同 Agent 之间切换Plan 只读不改Build 才动代码这个分工能避免 AI 一上来就乱改。需要长时间跑的任务用ulw:前缀触发无人值守或者显式调用/hephaestus让它后台执行。Key 管理上坚持用环境变量 配置文件引用永远不要把 Key 写死进任何会提交的文件。这样换机器、换项目、分享配置都不会出问题。TaoToken 的统一 Key 接入让 OpenCode 和 oh-my-opencode 共用一套凭证改的时候只改环境变量一处这是整套方案里最省心的设计。如果你还没开始建议先在一个测试项目里把第 3 节的配置骨架复制过去跑通第 4 节的 curl再启动 OpenCode 试一次/init。链路通了之后剩下的就是慢慢调AGENTS.md和 Agent 分工让它越来越贴合你的项目。