1. Windows 桌面端 opencode 接入 Azure GPT5.2 的真实场景如果你在 Windows 上用 opencode Desktop App又想让它走 Azure 上的 GPT5.2大概率会卡在三个地方环境变量到底写哪几个、oh-my-opencode 装完提示 “OpenCode is not installed”、Superpowers 插件 clone 完不生效。这三个问题我在一台 Windows 11 机器上从头到尾踩了一遍下面把完整链路拆开写清楚。opencode 是一个终端里的 AI 编码代理能读项目、改文件、跑命令Desktop App 是它的图形外壳。Azure GPT5.2 是微软云上部署的 GPT 系列模型通过 Azure OpenAI 接口调用。oh-my-opencode 是给 opencode 加命令补全和交互增强的插件Superpowers 则是往 opencode 里塞一套技能skills和插件钩子的扩展包。适合谁看已经在 Windows 上装了 opencode Desktop App、手里有 Azure OpenAI 资源、想让编码代理真正跑起来的开发者。整篇会给出可复制的环境变量、opencode.cmd包装器脚本、Superpowers 的 clone 与软链命令以及启动验证和插件生效检查动作。中间会顺带说一个统一 Key/API 通道的接入方式方便你不想在每台机器上重复填 Azure 参数时用。2. 前置准备TaoToken 统一 Key 与 API 通道在配 Azure 之前先说一个能省事的做法。Azure OpenAI 的 endpoint、key、api-version、deployment name 这几项每换一台机器就要重填一遍团队里几个人各配各的还容易写错。我现在的习惯是走一个统一的 API 通道把模型调用收敛到一个 Key 上opencode 这边只认一个 base_url 和一个 key。TaoToken 就是干这个的官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的作用是给你一个兼容 OpenAI 协议的端点你在 opencode 里把 base_url 指过去、key 填进去就能调用后端挂的模型不用在本地维护一堆 Azure 变量。具体操作登录后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 生成一个 Key复制出来。这个 Key 后面会填到 opencode 的配置里。如果你只是想先验证模型通不通可以直接用模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一条消息试试确认通道可用再往下配。注意Key 只显示一次生成后立刻存到密码管理器里。不要写进会提交到 git 的配置文件。如果你坚持用原生 Azure 变量也没问题下一节两种方式都给。区别是走 TaoToken 通道时opencode 侧只需要base_urlapi_key走原生 Azure 时需要AZURE_RESOURCE_NAME、AZURE_OPENAI_ENDPOINT、AZURE_OPENAI_API_KEY、AZURE_OPENAI_API_VERSION四个变量。3. 可复制配置Azure GPT5.2 环境变量与 settings.json 骨架3.1 原生 Azure 环境变量写法在 Windows 上环境变量分「用户变量」和「系统变量」opencode Desktop App 读的是用户变量。按 Win 键搜「环境变量」打开「编辑账户的环境变量」在用户变量里新增这四项变量名填什么示例AZURE_RESOURCE_NAMEAzure 资源名my-gpt52-resourceAZURE_OPENAI_ENDPOINT资源端点https://my-gpt52-resource.openai.azure.com/AZURE_OPENAI_API_KEYAzure 密钥你的 32 位 keyAZURE_OPENAI_API_VERSIONAPI 版本2025-xx-xx-xxx填完必须重启 opencode Desktop App环境变量才会被进程读到。只关窗口不算要在任务栏右键退出或者任务管理器里结束 OpenCode.exe 再重开。3.2 走 TaoToken 通道的 settings.json 骨架如果你用统一通道就不需要上面四个 Azure 变量改成在 opencode 的配置目录里写 settings.json。Windows 下配置目录一般在%USERPROFILE%\.config\opencode\没有就手动建。{ provider: { taotoken: { type: openai, baseURL: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, models: { gpt-5.2: { name: GPT5.2, contextWindow: 128000 } } } }, model: taotoken/gpt-5.2 }baseURL后面不要带/v1opencode 会自己拼路径。apiKey填你在控制台生成的那串。model字段决定默认用哪个模型格式是provider/model。3.3 config.toml 骨架如果你用 TOML 风格配置部分 opencode 版本读的是 config.toml放在同一目录[provider.taotoken] type openai base_url https://taotoken.net/api api_key sk-你的TaoTokenKey [provider.taotoken.models.gpt-5.2] name GPT5.2 context_window 128000 [default] model taotoken/gpt-5.2两种格式选一种就行同时存在可能以其中一个为准建议只留一个。改完配置同样要重启 App。4. oh-my-opencode 与 Superpowers 插件安装4.1 装 Bunoh-my-opencode 的安装器是 Bun 脚本先装 Bun。打开 PowerShellirm https://bun.sh/install.ps1 | iex装完关掉当前终端重新开一个让 PATH 生效然后确认bun --version能打印版本号就说明 Bun 装好了。如果提示bun不是内部或外部命令说明 PATH 没刷新重开终端或者注销重登一次。4.2 解决 “OpenCode is not installed”直接跑bunx oh-my-opencode install大概率会报 “OpenCode is not installed”。原因是 oh-my-opencode 安装器要调用opencode这个命令而 OpenCode Desktop App 不会把opencode放进系统 PATH它只装了OpenCode.exe和opencode-cli.exe两个文件。最省事的做法是在已经在 PATH 里的~\.bun\bin目录放一个opencode.cmd包装器把命令转发给opencode-cli.exe。第一步先确认 CLI 本体能跑。假设你的安装目录是D:\software\OpenCode D:\software\OpenCode\opencode-cli.exe --version能打印版本号说明本体没问题。第二步创建包装器$exe D:\software\OpenCode\opencode-cli.exe $shim $env:USERPROFILE\.bun\bin\opencode.cmd echo offrn$exe %* | Set-Content -Encoding ASCII $shim这段脚本会在~\.bun\bin下生成opencode.cmd内容就是调用你的opencode-cli.exe并把参数透传。关掉当前终端重新开一个 PowerShell验证opencode --version这次应该能直接输出版本号。如果还是不行检查~\.bun\bin是否真的在 PATH 里用$env:PATH -split ;看一眼。4.3 安装 oh-my-opencode包装器生效后再跑安装bunx oh-my-opencode install安装器会检测到opencode命令正常走完流程。装完重启 OpenCode Desktop App在命令面板里应该能看到 oh-my-opencode 提供的增强命令。验证方式是打开 App 后按快捷键唤起命令列表搜oh-my看有没有相关条目。4.4 安装 SuperpowersSuperpowers 不用安装器直接在 OpenCode 里输入一段自然语言指令让它自己 clone 和建软链。打开 OpenCode 对话输入Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugins, then symlink ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js to ~/.config/opencode/plugins/superpowers.js, then symlink ~/.config/opencode/superpowers/skills to ~/.config/opencode/skills/superpowers, then restart opencode.它会依次执行 clone、建目录、建软链、重启。Windows 上建软链需要开发者模式或管理员权限如果报权限错误手动来一遍git clone https://github.com/obra/superpowers $env:USERPROFILE\.config\opencode\superpowers New-Item -ItemType Directory -Force $env:USERPROFILE\.config\opencode\plugins New-Item -ItemType SymbolicLink -Path $env:USERPROFILE\.config\opencode\plugins\superpowers.js -Target $env:USERPROFILE\.config\opencode\superpowers\.opencode\plugins\superpowers.js New-Item -ItemType SymbolicLink -Path $env:USERPROFILE\.config\opencode\skills\superpowers -Target $env:USERPROFILE\.config\opencode\superpowers\skills建软链前确认~\.config\opencode\skills目录存在不存在先建。软链建完重启 opencode插件才会加载。5. 验证请求与插件生效检查5.1 验证模型请求配置改完、App 重启后打开 OpenCode 对话发一条最简单的消息比如「用一句话说明你现在用的是哪个模型」。如果返回正常说明模型通道通了。想更确定一点可以在终端里直接打 APIcurl.exe -X POST https://taotoken.net/api/chat/completions -H Authorization: Bearer sk-你的TaoTokenKey -H Content-Type: application/json -d {\model\:\gpt-5.2\,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里有choices字段和内容就说明 Key 和通道都没问题。如果返回 401检查 Key 有没有复制全返回 404检查baseURL有没有多写/v1。5.2 检查 oh-my-opencode 是否生效重启 App 后在命令面板搜oh-my。能搜到条目说明插件加载了。另一个检查方式是看 opencode 启动日志日志里会打印加载了哪些插件。如果搜不到回到 4.2 确认opencode --version在终端里能跑因为 oh-my-opencode 依赖这个命令做运行时检测。5.3 检查 Superpowers 是否生效Superpowers 生效的标志是 skills 目录被识别。在 OpenCode 里问它「你有哪些 skills」如果列出了 superpowers 相关的技能说明软链建对了。也可以直接看文件系统Get-Item $env:USERPROFILE\.config\opencode\plugins\superpowers.js | Select-Object LinkType, TargetLinkType显示SymbolicLink且Target指向 superpowers 仓库里的文件就对了。如果显示的是普通文件说明软链没建成被复制成了实体文件插件更新时不会跟着变。6. 本篇常见错误排查报错一bunx oh-my-opencode install提示 OpenCode is not installed。这是最高频的坑。根因是 Desktop App 不注册opencode命令。按 4.2 建opencode.cmd包装器重开终端后opencode --version能跑再装。注意包装器里的 exe 路径要写你实际的安装路径别照抄D:\software\OpenCode。报错二环境变量填了但 App 读不到。Windows 环境变量分用户级和系统级opencode 读用户级。填完必须完全退出 App 再启动关窗口不算退出。可以在 PowerShell 里echo $env:AZURE_OPENAI_ENDPOINT确认变量在当前会话可见但 App 是独立进程还是得重启。报错三Superpowers 软链建失败提示权限不足。Windows 建符号链接默认要管理员权限或开启开发者模式。设置 → 隐私和安全性 → 开发者选项 → 打开「开发人员模式」然后重开 PowerShell 再建。或者用管理员身份开 PowerShell。报错四模型返回 404 或 model not found。走 TaoToken 通道时baseURL写https://taotoken.net/api不要带/v1也不要带/chat/completions。model字段写taotoken/gpt-5.2这种provider/model格式。走原生 Azure 时deployment name 要和你在 Azure 门户里建的一致大小写敏感。报错五改了 settings.json 没反应。确认文件在%USERPROFILE%\.config\opencode\下文件名是settings.json不是setting.json。JSON 里不能有注释和尾逗号用编辑器校验一下。改完重启 App。报错六远程连接opencode attach连不上。服务端启动命令是opencode serve --port 4096 --hostname 0.0.0.0--hostname 0.0.0.0不能省否则只监听本地。客户端opencode attach http://10.182.17.2:4096里的 IP 换成服务端实际内网 IP。两端网络要互通防火墙放行 4096 端口。7. 继续往下走Coding Plan 与接入文档配完这一套opencode 在 Windows 上就能跑 Azure GPT5.2 了oh-my-opencode 和 Superpowers 也挂上了。如果你后面要长期用它做编码代理、跑 Agent 任务建议看一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对长时间编码场景做了额度规划比按次调用更划算。接入过程中如果遇到协议细节问题比如某个字段名对不上、返回格式和预期不一致直接翻接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有完整的请求示例和字段说明。Claude Code 相关的接入方式在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 也有单独说明。最后提醒一句opencode.cmd包装器里的 exe 路径是你机器上的绝对路径换机器要改。Superpowers 的软链在 Windows 上偶尔会被某些同步工具破坏如果哪天 skills 突然不生效先检查软链还在不在。