Windows下安装OpenCode并配置oh-my-openagent和superpowers

文章使用AI润色

前言

OpenCode是一个开源的终端AI编码助手，支持多种LLM提供商。搭配oh-my-openagent（OmO）和superpowers插件后，可以获得强大的AI开发团队编排能力。本篇记录在Windows下的完整安装配置过程。

官网：https://opencode.ai/zh

官方文档：https://opencode.ai/docs/zh-cn

环境要求

• 操作系统：Windows 10/11
• Node.js：>= 20.19.0
• 包管理器：bun（推荐）/ npm / pnpm
• 终端：Windows Terminal（推荐）

一、安装OpenCode

Windows下有几种安装方式，任选其一：

方式一：使用Scoop（推荐）

scoopinstallopencode

方式二：使用Chocolatey

以管理员身份打开PowerShell：

chocoinstallopencode

方式三：使用npm

npminstall-gopencode-ai

方式四：使用WSL（体验最佳）

Windows下使用WSL（Windows Subsystem for Linux）能获得最完整的体验：

# 在WSL终端中执行curl-fsSLhttps://opencode.ai/install|bash

验证安装

opencode--version

看到版本号即表示安装成功。

二、安装Bun

oh-my-openagent的安装推荐使用bun，先安装bun：

powershell-c"irm bun.sh/install.ps1 | iex"

安装完成后验证：

bun--version

三、配置Shell（解决PowerShell下bash命令不兼容问题）

OpenCode生成的指令默认使用bash语法（如&&、set VAR=value等），但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语法全部正常。

其他方案

• 使用WSL：WSL里是原生Linux bash，不存在兼容问题，也是OpenCode官方推荐的方式
• 升级PowerShell 7+：PS7支持&&操作符，但set VAR=value这类bash赋值语法仍需留意

四、安装oh-my-openagent

oh-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

安装过程会自动完成以下操作：

1. 安装插件到OpenCode
2. 配置默认模型和代理
3. 生成项目配置文件（.opencode/oh-my-openagent.jsonc）

验证oh-my-openagent

在项目根目录运行OpenCode：

opencode

进入TUI后，输入ulw（或ultrawork），如果正常响应说明安装成功。

五、安装superpowers插件

superpowers插件提供了丰富的开发技能，包括Playwright浏览器自动化、Git原子提交、前端UI/UX设计、代码审查等。

配置步骤

1. 找到OpenCode配置文件

   全局配置文件位于~/.config/opencode/opencode.json（即C:\Users\你的用户名\.config\opencode\opencode.json）

2. 添加superpowers插件

   在plugins数组中添加"superpowers@git+https://github.com/obra/superpowers.git"：

   {"plugins":["superpowers@git+https://github.com/obra/superpowers.git"]}

   如果已有其他插件，追加到数组末尾即可：

   {"plugins":["oh-my-openagent","superpowers@git+https://github.com/obra/superpowers.git"]}

3. 保存文件

4. 重启OpenCode

   完全退出当前OpenCode会话，然后重新启动：

   opencode

验证superpowers

在OpenCode中发送：

do you have superpowers?

如果返回确认有superpowers（列出可用技能等），则表示配置成功。

六、配置模型

OpenCode 提供了一套完整的模型配置体系，从全局默认模型到每个子代理的专用模型，均可按需设置。以下配置均基于 OpenCode Zen——OpenCode 内置的免费模型提供商，无需 API Key。

OpenCode Zen 免费模型

查看所有可用免费模型：

# 列出 OpenCode Zen 所有可用模型opencode models opencode

常见免费模型：

以上模型均完全免费，可按需分配无需担心费用。

设置 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 分工与推荐模型

Category 分工与推荐模型

配置思路

合理分配模型的核心原则：

• 高推理需求（oracle、prometheus、momus、ultrabrain、deep）→ 用big-pickle等强模型，保证输出质量
• 高频搜索（explore、librarian）→ 用qwen3.6-plus-free，速度快 token 消耗大但免费
• 视觉/前端（visual-engineering）→qwen3.6-plus-free或更强模型
• 简单任务（quick、unspecified-low）→ 最便宜的模型即可

配置优先级

模型选择遵循以下优先级（从上到下递减）：

验证配置

启动 OpenCode 后输入/models，查看当前使用的模型，确认显示为目标模型 ID。

七、常用命令与功能

OpenCode 内置命令

进入OpenCode的TUI后，直接输入斜杠命令即可调用：

提示：输入/后按 Tab 可以看到当前可用的所有命令列表。

oh-my-openagent 核心功能

superpowers 内置技能

注意事项

1. Windows原生 vs WSL：OpenCode官方推荐Windows用户使用WSL获得最佳体验，因为部分shell工具（如ripgrep、git工具链）在WSL下工作更顺畅
2. 插件冲突：如果同时安装了多个插件，注意配置不要有冲突
3. 配置文件位置：OpenCode的全局配置文件为~/.config/opencode/opencode.json，oh-my-openagent的配置文件为~/.config/opencode/oh-my-openagent.json，两者各自独立
4. 模型选择：oh-my-openagent 会自动根据任务类型选择对应的 category 模型，无需手动切换。如需调整，修改oh-my-openagent.json即可
5. OpenCode Zen 免费模型需要联网，离线环境下无法使用

总结

整个安装配置流程：

安装OpenCode → 安装Bun → 配置Shell为Git Bash → 安装oh-my-openagent → 添加superpowers插件 → 配置默认模型与多Agent模型

配置完成后你就拥有了一个强大的终端AI开发环境，可以享受纪律代理编排、团队并行开发、浏览器自动化等一系列高级功能，且所有模型均为免费，无需担心API费用。