在 macOS 上配置 Claude Code 与 oh-my-claudecode：从安装到多代理协作

最近又折腾了一套新的 AI 编程环境，这次主角换成了 Claude Code 和 oh-my-claudecode。

如果说 Claude Code 是 Anthropic 官方提供的编码代理，那么 oh-my-claudecode 更像是在它上面加了一层“指挥系统”——把多代理协作、自动分工和更工程化的工作流接上去。对日常写代码、改项目、修 bug 来说，这套组合确实挺有意思。

这篇就按 macOS 从零配置 的顺序写，尽量不拐弯抹角。

一、先理解这两个东西

Claude Code 是官方的 agentic coding tool，能读代码库、改文件、跑命令、和你的开发工具集成。它不只是聊天框，而是一个真正能下场干活的编码代理。

它支持的入口也不少：

  • 终端 CLI

  • VS Code 扩展

  • 桌面应用

  • 浏览器

  • JetBrains 插件

oh-my-claudecode 则是一个面向 Claude Code 的多代理编排层。它主打的是：少记命令、少自己调度，把复杂任务拆给不同角色处理。简单说，就是让 Claude Code 从“一个很强的助手”，变成“一支会协作的小队”。

二、在 macOS 上安装 Claude Code

官方文档里给了几种安装方式，macOS 上最常见的有两个：

curl -fsSL https://claude.ai/install.sh | bash

或者用 Homebrew：

brew install --cask claude-code

如果你想省心一点，我更倾向于官方推荐的原生安装方式；它会自动更新，后续维护更轻。Homebrew 也没问题，只是你得记得自己升级。

装好之后，在项目目录里直接运行：

cd your-project
claude

第一次启动会要求登录。走完登录流程之后，Claude Code 就算正式活过来了。

三、先确认 Claude Code 本体能正常工作

这一步很重要，别一上来就猛装插件。先确认 Claude Code 本体能正常工作，再叠增强层，后面排错会轻松很多。

最简单的验证方式，是进一个项目后直接给它一个小任务，比如：

claude "summarize this repository and explain the main modules"

如果它已经能正常读取代码库、理解目录、给出合理输出，那就说明底座没问题。

四、安装 oh-my-claudecode

oh-my-claudecode 的思路很直接：别花太多时间学 Claude Code 的各种姿势，直接把多代理 orchestration 接进去。

它的 README 里给了一个非常直给的安装流程：

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

然后继续初始化：

/setup
/omc-setup

做完这几步，基础环境就差不多齐了。

它的理念其实挺粗暴但有效：别先学一堆命令，再开始干活；先能用起来，细节慢慢补。

五、oh-my-claudecode 能带来什么

这个项目最有吸引力的地方，不是“又多了一套命令”，而是它在认真做 多代理编排。

比如它的 Team 模式已经是当前主推的编排入口，可以把任务按照流水线方式推进：

team-plan → team-prd → team-exec → team-verify → team-fix

这意味着一件事不是“Claude 回你一段建议就结束”，而是会进入规划、执行、验证、修复这样的闭环。

像下面这种命令就很典型：

/team 3:executor "fix all TypeScript errors"

这类多代理协作特别适合这些场景：

  • 批量修 lint / TypeScript 报错

  • 跨多个模块的大改动

  • 需要先分析再动手的复杂任务

  • 你不想盯着每一步 micromanage 的时候

六、在 macOS 上启用 Team 支持

如果你准备使用它更完整的 Team 能力，README 里提到需要在 ~/.claude/settings.json 里开启实验环境变量：

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

这一步可以理解为：把 Claude Code 的原生 team 能力打开，然后让 OMC 去接管更高层的 orchestration。

如果这个能力没有启用，OMC 通常会给出提醒，并尽量回退到非 Team 的执行方式。

七、实际使用时，我会怎么分层理解

我自己的理解很简单：

  • Claude Code 负责提供官方能力和基础执行面

  • oh-my-claudecode 负责让复杂任务的执行方式更聪明

这就像你先有一个靠谱的主力工具，再给它装上一套更成熟的调度系统。两者不是替代关系，而是叠加关系。

如果你只想快速问几个问题、改几个文件，原生 Claude Code 已经够用；但如果你经常做中大型任务，比如重构、整模块迁移、连续修复、复杂审查，那 OMC 这种 orchestration 层就会开始显出价值。

八、一些值得注意的点

  • 先把 Claude Code 本体跑通：别本体都没登录成功，就急着装一堆增强层。

  • Team 相关能力要看配置：不是所有环境默认都开着，缺实验开关时别一脸懵。

  • 别把多代理神化：它能提高效率，但前提还是任务描述要足够清楚。

  • 自然语言入口很好用：这类工具最大的价值之一，就是降低你组织复杂任务的门槛。

九、结语

如果你已经在用 Claude Code，那 oh-my-claudecode 值得试；它不是给 Claude Code 换皮，而是把“一个强助手”升级成“一个更会协作的工作流系统”。

对 macOS 用户来说，这套配置并不算复杂：先装 Claude Code，再装 OMC，再把 Team 之类的能力接上去，基本就能形成一套比较顺手的 AI 编程环境。