如果你最近在逛开发者社区大概率会刷到一个叫 opencode 的终端 AI 编码代理。它长得很像新版 Claude Code 或 Codex CLI但更“程序员直给”一个 TUI 界面直接在当前项目目录里跑起来读代码、改文件、跑测试、给 diff全程不用离开终端。我用了小一个月之后最大的感受是opencode 本身已经够强但真正让我顺手起来的是 Oh-My-Opencode 和 SuperPower 这两个插件体系。这篇文章就围绕在 Mac 上完成 opencode 安装、再装好这两个增强套件来写把完整操作、踩坑记录和配置思路都分享出来适合第一次上手 opencode 的人也适合那些已经装好但觉得“不够顺手”的朋友。1. 先花3分钟理清 opencode、Oh-My-Opencode、SuperPower 的关系1.1 opencode 是什么它和 Claude Code、Codex CLI 有什么不一样opencode 是一个开源的终端 AI 编码代理核心 CLI 用 Go 编写发布出来是单个可执行文件。装完之后在任意项目目录里敲一条 opencode就能启动一个全屏 TUI 会话。和 Claude Code、Codex CLI 这类工具属于同一赛道但我实际用下来的感受是opencode 对模型提供商的开放程度更高OpenAI、Anthropic、Google Gemini、本地 Ollama甚至各种 OpenAI 兼容端点都能接。这意味着你可以按项目切换模型不容易被某一家模型服务绑死。它另一个讨喜的点是操作方式是“Agent 式”的不是简单聊天。AI 能读取项目文件结构、搜索代码、执行 shell 命令、修改文件然后给你 diff再跑测试验证。相当于把“结对编程助手”直接塞进了终端里而不是让你在网页和编辑器之间来回复制粘贴。如果你之前用过 Claude Code应该能立刻理解这种体验——opencode 在开源生态里把这件事又往前推了一步。1.2 Oh-My-Opencode让 opencode 的配置有“家”Oh-My-Opencode 的名字明显是致敬 Oh-My-Zsh作用也类似它把 opencode 的配置从一堆散落的 JSON 文件整理成角色、插件、命令、主题四个维度统一管理。你可以把它理解成新房交付时的“精装服务”。默认安装完 opencode你面对的是一个能跑但没什么模板的终端界面角色、斜杠命令都要自己写装完 Oh-My-Opencode 后交互式菜单里勾一勾常见的架构师角色、git 提交助手、TUI 主题就都齐了配置文件也会被归纳到一处。这个项目的价值在于它把“调教 AI”这件事从每次手动改 prompt 变成了可以积累、可以复用的配置资产。角色、插件、命令被拆分后你可以像搭乐高一样按需组合而不是在一个巨大的 config 文件里反复改来改去。我自己以前没有它的时候每次换项目就要重新调整一堆配置装了它之后大部分场景直接选中对应角色和插件就能开始干活。1.3 SuperPower 和 OpenSpecAI 的职业技能手册SuperPower 解决的又是另一个问题AI 编码代理再怎么强遇到复杂任务时还是容易“自由发挥”。比如你让它写测试它可能直接写一个简单 happy path 就交差了完全没有覆盖率概念。SuperPower 是一套基于 OpenSpec 规范组织的技能库每个技能就是一组 Markdown 文档加脚本模板规定了任务背景、执行步骤、输出格式和验收标准。opencode 在会话中读到技能文件后等于拿到了一份“工作手册”按章办事不太会跑偏。注意SuperPower 不是 opencode 官方插件它是 opencode 生态里的第三方技能包但社区使用率极高。OpenSpec 在这里扮演的是“通用技能格式”的角色SuperPower 则是围绕这个格式打磨出来的一整套实用技能集合。简单说Oh-My-Opencode 管“怎么把 opencode 配得顺手”SuperPower 管“让 AI 具备哪些具体干活能力”两者不是替代关系而是叠加关系。2. Mac 环境准备装之前先把这些检查一遍2.1 Node.js 版本与包管理器先别急着装 opencode第一步是确认你 Mac 上的 Node 环境。以 npm 方式安装 opencode 的包名是 opencode-ai它依赖 Node.js 20 及以上版本我建议直接用 20 LTS 或 22 的稳定版。如果你之前没装过 Node推荐用 nvm 装一个 LTS 版本因为 nvm 可以随时切版本不会污染系统环境。安装命令这里给一份curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash回车后重启终端再执行nvm install 20即可。如果你已经装了 Homebrew 并且不想再引入 nvm那也可以brew install node20。但注意 brew 和 nvm 二选一别两套共存。我见过太多人因为同时装了两套 Node导致 npm 全局目录混乱本来一行命令能装好的包最后折腾半天查路径。选一条路走到底这个能帮你省掉后面 80% 的环境问题。2.2 终端、Shell 与 PATH 环境变量Mac 默认 shell 是 zsh配置文件在~/.zshrc。为什么要单独说它因为 opencode 安装完之后的“command not found”问题八成出在 PATH。npm 全局包的 bin 目录不一定在你的 PATH 里尤其是用 nvm 安装 Node 后npm 全局目录是 ~/.nvm/versions Mac上安装opencode并配置Oh-My-Opencode与SuperPower实战
如果你最近在逛开发者社区大概率会刷到一个叫 opencode 的终端 AI 编码代理。它长得很像新版 Claude Code 或 Codex CLI但更“程序员直给”一个 TUI 界面直接在当前项目目录里跑起来读代码、改文件、跑测试、给 diff全程不用离开终端。我用了小一个月之后最大的感受是opencode 本身已经够强但真正让我顺手起来的是 Oh-My-Opencode 和 SuperPower 这两个插件体系。这篇文章就围绕在 Mac 上完成 opencode 安装、再装好这两个增强套件来写把完整操作、踩坑记录和配置思路都分享出来适合第一次上手 opencode 的人也适合那些已经装好但觉得“不够顺手”的朋友。1. 先花3分钟理清 opencode、Oh-My-Opencode、SuperPower 的关系1.1 opencode 是什么它和 Claude Code、Codex CLI 有什么不一样opencode 是一个开源的终端 AI 编码代理核心 CLI 用 Go 编写发布出来是单个可执行文件。装完之后在任意项目目录里敲一条 opencode就能启动一个全屏 TUI 会话。和 Claude Code、Codex CLI 这类工具属于同一赛道但我实际用下来的感受是opencode 对模型提供商的开放程度更高OpenAI、Anthropic、Google Gemini、本地 Ollama甚至各种 OpenAI 兼容端点都能接。这意味着你可以按项目切换模型不容易被某一家模型服务绑死。它另一个讨喜的点是操作方式是“Agent 式”的不是简单聊天。AI 能读取项目文件结构、搜索代码、执行 shell 命令、修改文件然后给你 diff再跑测试验证。相当于把“结对编程助手”直接塞进了终端里而不是让你在网页和编辑器之间来回复制粘贴。如果你之前用过 Claude Code应该能立刻理解这种体验——opencode 在开源生态里把这件事又往前推了一步。1.2 Oh-My-Opencode让 opencode 的配置有“家”Oh-My-Opencode 的名字明显是致敬 Oh-My-Zsh作用也类似它把 opencode 的配置从一堆散落的 JSON 文件整理成角色、插件、命令、主题四个维度统一管理。你可以把它理解成新房交付时的“精装服务”。默认安装完 opencode你面对的是一个能跑但没什么模板的终端界面角色、斜杠命令都要自己写装完 Oh-My-Opencode 后交互式菜单里勾一勾常见的架构师角色、git 提交助手、TUI 主题就都齐了配置文件也会被归纳到一处。这个项目的价值在于它把“调教 AI”这件事从每次手动改 prompt 变成了可以积累、可以复用的配置资产。角色、插件、命令被拆分后你可以像搭乐高一样按需组合而不是在一个巨大的 config 文件里反复改来改去。我自己以前没有它的时候每次换项目就要重新调整一堆配置装了它之后大部分场景直接选中对应角色和插件就能开始干活。1.3 SuperPower 和 OpenSpecAI 的职业技能手册SuperPower 解决的又是另一个问题AI 编码代理再怎么强遇到复杂任务时还是容易“自由发挥”。比如你让它写测试它可能直接写一个简单 happy path 就交差了完全没有覆盖率概念。SuperPower 是一套基于 OpenSpec 规范组织的技能库每个技能就是一组 Markdown 文档加脚本模板规定了任务背景、执行步骤、输出格式和验收标准。opencode 在会话中读到技能文件后等于拿到了一份“工作手册”按章办事不太会跑偏。注意SuperPower 不是 opencode 官方插件它是 opencode 生态里的第三方技能包但社区使用率极高。OpenSpec 在这里扮演的是“通用技能格式”的角色SuperPower 则是围绕这个格式打磨出来的一整套实用技能集合。简单说Oh-My-Opencode 管“怎么把 opencode 配得顺手”SuperPower 管“让 AI 具备哪些具体干活能力”两者不是替代关系而是叠加关系。2. Mac 环境准备装之前先把这些检查一遍2.1 Node.js 版本与包管理器先别急着装 opencode第一步是确认你 Mac 上的 Node 环境。以 npm 方式安装 opencode 的包名是 opencode-ai它依赖 Node.js 20 及以上版本我建议直接用 20 LTS 或 22 的稳定版。如果你之前没装过 Node推荐用 nvm 装一个 LTS 版本因为 nvm 可以随时切版本不会污染系统环境。安装命令这里给一份curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash回车后重启终端再执行nvm install 20即可。如果你已经装了 Homebrew 并且不想再引入 nvm那也可以brew install node20。但注意 brew 和 nvm 二选一别两套共存。我见过太多人因为同时装了两套 Node导致 npm 全局目录混乱本来一行命令能装好的包最后折腾半天查路径。选一条路走到底这个能帮你省掉后面 80% 的环境问题。2.2 终端、Shell 与 PATH 环境变量Mac 默认 shell 是 zsh配置文件在~/.zshrc。为什么要单独说它因为 opencode 安装完之后的“command not found”问题八成出在 PATH。npm 全局包的 bin 目录不一定在你的 PATH 里尤其是用 nvm 安装 Node 后npm 全局目录是 ~/.nvm/versions