Windows下安装OpenCode并配置oh-my-openagent和superpowers前言环境要求一、安装OpenCode方式一使用Scoop推荐方式二使用Chocolatey方式三使用npm方式四使用WSL体验最佳验证安装二、安装Bun三、配置Shell解决PowerShell下bash命令不兼容问题解决方法配置Git Bash方式一全局配置推荐方式二项目级配置验证其他方案四、安装oh-my-openagent安装命令验证oh-my-openagent五、安装superpowers插件配置步骤验证superpowers六、配置模型OpenCode Zen 免费模型设置 OpenCode 默认模型配置 oh-my-openagent 多 Agent 模型Agent 分工与推荐模型Category 分工与推荐模型配置思路配置优先级验证配置七、常用命令与功能OpenCode 内置命令oh-my-openagent 核心功能superpowers 内置技能注意事项总结文章使用AI润色前言OpenCode是一个开源的终端AI编码助手支持多种LLM提供商。搭配oh-my-openagentOmO和superpowers插件后可以获得强大的AI开发团队编排能力。本篇记录在Windows下的完整安装配置过程。官网https://opencode.ai/zh官方文档https://opencode.ai/docs/zh-cn环境要求操作系统Windows 10/11Node.js 20.19.0包管理器bun推荐/ npm / pnpm终端Windows Terminal推荐一、安装OpenCodeWindows下有几种安装方式任选其一方式一使用Scoop推荐scoopinstallopencode方式二使用Chocolatey以管理员身份打开PowerShellchocoinstallopencode方式三使用npmnpminstall-gopencode-ai方式四使用WSL体验最佳Windows下使用WSLWindows Subsystem for Linux能获得最完整的体验# 在WSL终端中执行curl-fsSLhttps://opencode.ai/install|bash验证安装opencode--version看到版本号即表示安装成功。二、安装Bunoh-my-openagent的安装推荐使用bun先安装bunpowershell-cirm bun.sh/install.ps1 | iex安装完成后验证bun--version三、配置Shell解决PowerShell下bash命令不兼容问题OpenCode生成的指令默认使用bash语法如、set VARvalue等但Windows自带的PowerShell 5.1并不支持操作符直接执行会报错 运算符在此版本的 PowerShell 中无效解决方法配置Git Bash如果你已经安装了Git for Windows大概率已装自带的Git Bash可以直接在OpenCode中使用。有两种配置方式方式一全局配置推荐在OpenCode全局配置文件%APPDATA%\opencode\opencode.json中添加shell字段{shell:C:\\Program Files\\Git\\bin\\bash.exe}添加后全局生效所有项目都能使用bash执行命令。方式二项目级配置在项目根目录新建opencode.json如已有则直接编辑同样添加shell字段{shell:C:\\Program Files\\Git\\bin\\bash.exe}项目级配置会覆盖全局配置适合不同项目使用不同终端的情况。验证重启OpenCode后shell命令就会通过Git Bash执行、set、等bash语法全部正常。其他方案使用WSLWSL里是原生Linux bash不存在兼容问题也是OpenCode官方推荐的方式升级PowerShell 7PS7支持操作符但set VARvalue这类bash赋值语法仍需留意四、安装oh-my-openagentoh-my-openagent原oh-my-opencode是一个强大的AI开发代理编排框架提供纪律代理Discipline Agents、团队模式Team Mode、Hash锚定编辑、LSP集成等功能。GitHub地址https://github.com/code-yeongyu/oh-my-openagent安装命令bunx oh-my-openagentinstall安装过程会自动完成以下操作安装插件到OpenCode配置默认模型和代理生成项目配置文件.opencode/oh-my-openagent.jsonc验证oh-my-openagent在项目根目录运行OpenCodeopencode进入TUI后输入ulw或ultrawork如果正常响应说明安装成功。五、安装superpowers插件superpowers插件提供了丰富的开发技能包括Playwright浏览器自动化、Git原子提交、前端UI/UX设计、代码审查等。配置步骤找到OpenCode配置文件全局配置文件位于~/.config/opencode/opencode.json即C:\Users\你的用户名\.config\opencode\opencode.json添加superpowers插件在plugins数组中添加superpowersgithttps://github.com/obra/superpowers.git{plugins:[superpowersgithttps://github.com/obra/superpowers.git]}如果已有其他插件追加到数组末尾即可{plugins:[oh-my-openagent,superpowersgithttps://github.com/obra/superpowers.git]}保存文件重启OpenCode完全退出当前OpenCode会话然后重新启动opencode验证superpowers在OpenCode中发送do you have superpowers?如果返回确认有superpowers列出可用技能等则表示配置成功。六、配置模型OpenCode 提供了一套完整的模型配置体系从全局默认模型到每个子代理的专用模型均可按需设置。以下配置均基于 OpenCode Zen——OpenCode 内置的免费模型提供商无需 API Key。OpenCode Zen 免费模型查看所有可用免费模型# 列出 OpenCode Zen 所有可用模型opencode models opencode常见免费模型模型 ID说明opencode/big-pickle最强免费模型适合深度推理、架构设计opencode/deepseek-v4-flash-freeDeepSeek V4 Flash免费版200K上下文opencode/qwen3.6-plus-freeQwen 3.6 Plus免费版opencode/minimax-m2.5-freeMiniMax M2.5免费版opencode/nemotron-3-super-freeNemotron 3 Super免费版以上模型均完全免费可按需分配无需担心费用。设置 OpenCode 默认模型在全局配置文件~/.config/opencode/opencode.json中添加model字段{$schema:https://opencode.ai/config.json,model:opencode/deepseek-v4-flash-free,small_model:opencode/deepseek-v4-flash-free}model主模型用于编码和复杂任务small_model轻量模型用于标题生成等简单任务。不设置时会自动选择更便宜的模型配置 oh-my-openagent 多 Agent 模型oh-my-openagent 编排了多个专用子代理每个代理可以根据任务特点使用不同的模型在性能和成本之间取得平衡。配置文件位于~/.config/opencode/oh-my-openagent.json分为agents子代理和categories任务分类两部分{$schema:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json,agents:{hephaestus:{model:opencode/minimax-m2.5-free},oracle:{model:opencode/big-pickle},librarian:{model:opencode/qwen3.6-plus-free},explore:{model:opencode/qwen3.6-plus-free},prometheus:{model:opencode/big-pickle},metis:{model:opencode/qwen3.6-plus-free},momus:{model:opencode/big-pickle},multimodal-looker:{model:opencode/qwen3.6-plus-free},atlas:{model:opencode/nemotron-3-super-free},sisyphus-junior:{model:opencode/deepseek-v4-flash-free}},categories:{visual-engineering:{model:opencode/qwen3.6-plus-free},ultrabrain:{model:opencode/big-pickle},deep:{model:opencode/big-pickle},artistry:{model:opencode/deepseek-v4-flash-free},quick:{model:opencode/qwen3.6-plus-free},unspecified-low:{model:opencode/qwen3.6-plus-free},unspecified-high:{model:opencode/minimax-m2.5-free},writing:{model:opencode/qwen3.6-plus-free}}}Agent 分工与推荐模型Agent职责推荐模型hephaestus执行代理处理具体编码任务minimax-m2.5-freeoracle高IQ顾问架构/调试难题big-pickle强模型librarian搜索外部文档和代码示例qwen3.6-plus-freeexplore搜索代码库结构和模式qwen3.6-plus-freeprometheus任务规划和分解big-pickle强模型metis需求分析识别模糊点qwen3.6-plus-freemomus审查计划发现遗漏big-pickle强模型sisyphus-junior执行委派的具体子任务deepseek-v4-flash-freeCategory 分工与推荐模型Category适用场景推荐模型visual-engineering前端UI/UX、样式、动画qwen3.6-plus-freeultrabrain复杂逻辑、架构决策big-pickle强模型deep深度研究 端到端实现big-pickle强模型artistry创意类、非常规方案deepseek-v4-flash-freequick简单修改、修 typoqwen3.6-plus-freewriting文档、技术写作qwen3.6-plus-free配置思路合理分配模型的核心原则高推理需求oracle、prometheus、momus、ultrabrain、deep→ 用big-pickle等强模型保证输出质量高频搜索explore、librarian→ 用qwen3.6-plus-free速度快 token 消耗大但免费视觉/前端visual-engineering→qwen3.6-plus-free或更强模型简单任务quick、unspecified-low→ 最便宜的模型即可配置优先级模型选择遵循以下优先级从上到下递减优先级配置方式说明1opencode -m provider/model命令行参数临时切换2项目根目录的opencode.json项目级配置覆盖全局3~/.config/opencode/opencode.json全局配置用户偏好4最近使用的模型OpenCode 自动记住5内置默认兜底验证配置启动 OpenCode 后输入/models查看当前使用的模型确认显示为目标模型 ID。七、常用命令与功能OpenCode 内置命令进入OpenCode的TUI后直接输入斜杠命令即可调用命令说明/init初始化项目或配置文件/connect连接或切换LLM提供商/models查看和选择可用模型/session会话管理列表、查看、搜索历史会话/themes切换TUI主题/editor在编辑器中打开当前文件/export导出当前会话内容/refactor智能重构LSP AST-grep TDD验证/review代码审查/handoff生成上下文摘要用于跨会话继续工作/start-work从Prometheus规划开始执行任务/hyperplan多代理对抗式规划5个代理交叉评审/ralph-loop启动自我反馈循环持续优化直到完成/ulw-loop启动ultrawork循环不完成不停止/remove-ai-slops移除代码中的AI风格代码/cancel-ralph取消正在运行的Ralph Loop/stop-continuation停止所有持续执行机制/init-deep自动生成项目层级AGENTS.md知识库提示输入/后按 Tab 可以看到当前可用的所有命令列表。oh-my-openagent 核心功能功能说明ulw/ultrawork一键激活所有代理不完成不罢休/start-workPrometheus规划器先访谈再执行/init-deep自动生成项目层级AGENTS.md文件Team Mode多代理并行协作实时可视化superpowers 内置技能技能用途brainstorming创意工作前的需求探索和设计systematic-debugging系统化的bug调试流程test-driven-developmentTDD测试驱动开发git-masterGit原子提交、变基、历史搜索playwright浏览器自动化验证、测试、爬虫frontend-ui-ux前端UI/UX设计开发verification-before-completion完成任务前自动验证writing-plans编写实施计划dispatching-parallel-agents并行分发独立任务注意事项Windows原生 vs WSLOpenCode官方推荐Windows用户使用WSL获得最佳体验因为部分shell工具如ripgrep、git工具链在WSL下工作更顺畅插件冲突如果同时安装了多个插件注意配置不要有冲突配置文件位置OpenCode的全局配置文件为~/.config/opencode/opencode.jsonoh-my-openagent的配置文件为~/.config/opencode/oh-my-openagent.json两者各自独立模型选择oh-my-openagent 会自动根据任务类型选择对应的 category 模型无需手动切换。如需调整修改oh-my-openagent.json即可OpenCode Zen 免费模型需要联网离线环境下无法使用总结整个安装配置流程安装OpenCode → 安装Bun → 配置Shell为Git Bash → 安装oh-my-openagent → 添加superpowers插件 → 配置默认模型与多Agent模型配置完成后你就拥有了一个强大的终端AI开发环境可以享受纪律代理编排、团队并行开发、浏览器自动化等一系列高级功能且所有模型均为免费无需担心API费用。