Mac上安装并使用OpenCode

犯二青年 发布于

前言

最近 AI 相关的工具层出不穷，从 ChatGPT 到 Claude，再到各种 Agent。作为开发者，我们不仅想要一个能聊天的 AI，更想要一个能直接帮我们写代码、改 Bug、甚至操作终端的 AI 助手。

今天就给大家介绍一个开源的 AI 编程 Agent —— OpenCode，以及它的增强版配置框架 Oh My OpenCode。这就好比 Zsh 和 Oh My Zsh 的关系，OpenCode 是核心引擎，而 Oh My OpenCode 让它变得更好用、更顺手。

什么是 OpenCode？

OpenCode 是一个开源的 AI 编程助手，它不仅能理解你的代码，还能执行终端命令、读写文件、甚至浏览网页。它的目标是成为你的 “结对编程伙伴”。

而 Oh My OpenCode 则是一套配置和插件集合，帮你快速配置好 OpenCode，集成各种常用工具（Git、Docker 等），让你开箱即用。

环境准备

在开始之前，确保你的 Mac 已经安装了以下环境：

  • Node.js (推荐 v18+) 或 Bun (推荐，速度飞快)
  • Git

安装步骤

1. 安装 OpenCode 核心

作为 Mac 用户，我强烈推荐使用 brew 来安装，方便又快捷：

1
brew install anomalyco/tap/opencode

如果你是 Linux 或 Windows 用户，或者想了解更多安装方式，可以去官方文档查看：OpenCode 官方安装文档

安装完成后，验证一下是否安装成功：

1
opencode --version

如果能看到版本号，说明核心已经安装好了。

OpenCode安装成功

OpenCode 基础配置

OpenCode 的配置文件通常位于 ~/.config/opencode/config.json。初次运行后会自动生成，你可以手动修改它来定制你的 AI 助手。

下面是一个典型的配置文件内容，我给每一项都加了中文注释，方便大家理解：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "$schema": "https://opencode.ai/config.json",
  "theme": "opencode",
  "autoupdate": true,
  "model": "claude/claude-3-5-sonnet-20241022",
  "small_model": "claude/claude-3-5-haiku-20241022",
  "provider": {
    "claude": {
      "name": "Claude Official",
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      },
      "models": {
        "claude-3-5-sonnet-20241022": {
          "name": "Claude 3.5 Sonnet"
        },
        "claude-3-5-haiku-20241022": {
          "name": "Claude 3.5 Haiku"
        },
        "claude-3-opus-20240229": {
          "name": "Claude 3 Opus"
        }
      }
    }
  },
  "plugin": [
    "oh-my-opencode@latest"
  ]
}

⚙️ 核心配置参数说明

参数项 说明 示例/默认值
theme 终端交互的主题颜色 opencode (默认), dark, light
autoupdate 是否自动检查并更新 OpenCode true
model 默认使用的主模型 (编程能力最强) claude/claude-3-5-sonnet-20241022
small_model 小型模型 (用于快速任务) claude/claude-3-5-haiku-20241022
provider 自定义模型提供商配置 这里配置了 Claude 官方源
plugin 启用的插件列表 ["oh-my-opencode@latest"]

⚙️ 核心配置参数说明

参数项 说明 示例/默认值
theme 终端交互的主题颜色 opencode (默认), dark, light
autoupdate 是否自动检查并更新 OpenCode true
model 默认使用的主模型 (编程能力最强) K+/claude-opus-4-5-20251101
small_model 小型模型 (用于快速任务) K+/claude-haiku-4-5-20251001
provider 自定义模型提供商配置 包含 Minimax, Gemini, Claude 中转等
plugin 启用的插件列表 ["oh-my-opencode@latest"]

🔌 Provider 配置详解

Provider 用途 包含模型示例
minimax 国内模型，备用或特定场景 MiniMax-M2.1
gemini Google 模型，长文本能力强 gemini-3-pro-preview, gemini-2.0-flash
K+ Claude 中转服务 (主力) Claude Opus, Sonnet 5, Haiku
google Google 官方 CLI 集成 Antigravity 系列, Gemini CLI 系列

Oh My OpenCode 配置

修改配置文件来启用插件。

  1. 打开 ~/.config/opencode/config.json，在 plugin 数组中添加 "oh-my-opencode@latest"。
  2. 创建 ~/.config/opencode/oh-my-opencode.json 进行详细配置。

这种方式的好处是，你可以精确控制每一个 Agent 使用的模型，实现 “好钢用在刀刃上” —— 用最强的模型做架构，用最快的模型做搜索。
2. 启用/禁用插件：按需开启 git-plugin 或 docker-plugin。

Oh My OpenCode 进阶配置：模型分流

Oh My OpenCode 最强大的功能之一，就是可以将不同的任务分发给不同的模型。

比如，我们可以让 Oracle (架构师) 使用最聪明的 Claude Opus，而让 Explore (搜索员) 使用最快最便宜的 Claude Haiku。

在 ~/.config/opencode/oh-my-opencode.json 中，我们可以这样配置（附详细注释）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    "oracle": {
      "model": "claude/claude-3-opus-20240229"
    },
    "prometheus": {
      "model": "claude/claude-3-opus-20240229"
    },
    "atlas": {
      "model": "claude/claude-3-opus-20240229"
    },
    "metis": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "momus": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "librarian": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "explore": {
      "model": "claude/claude-3-5-haiku-20241022"
    },
    "multimodal-looker": {
      "model": "claude/claude-3-5-sonnet-20241022"
    }
  },
  "categories": {
    "ultrabrain": {
      "model": "claude/claude-3-opus-20240229"
    },
    "visual-engineering": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "artistry": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "quick": {
      "model": "claude/claude-3-5-haiku-20241022"
    },
    "writing": {
      "model": "claude/claude-3-5-sonnet-20241022"
    },
    "unspecified-low": {
      "model": "claude/claude-3-5-haiku-20241022"
    },
    "unspecified-high": {
      "model": "claude/claude-3-5-sonnet-20241022"
    }
  }
}

为了方便大家理解，我把每个 Agent 和 Category 的作用整理成了表格：

🤖 专家 Agent 配置

Agent 名称 角色定位 推荐模型 选择理由
Oracle 预言家/架构师 Claude 3 Opus 负责复杂推理和架构设计，必须用最强的��型来保证决策质量。
Prometheus 规划者 Claude 3 Opus 负责任务拆解和整体规划，需要极强的逻辑思维能力。
Atlas 地图绘制者 Claude 3 Opus 负责代码库的深度理解和导航，Opus 的长上下文和理解力不可或缺。
Metis 智慧女神 Claude 3.5 Sonnet 负责意图识别和策略制定，Sonnet 3.5 在理解力和速度之间有很好的平衡。
Momus 审查者 Claude 3.5 Sonnet 负责代码审查和质量把控，需要敏锐的洞察力。
Librarian 图书管理员 Claude 3.5 Sonnet 负责查阅外部文档和搜索，Sonnet 3.5 足够聪明且响应迅速。
Explore 探索者 Claude 3.5 Haiku 负责代码搜索和定位，需要极快的速度来遍历大量文件，Haiku 是性价比之选。
Multimodal 视觉观察者 Claude 3.5 Sonnet 负责看图和视觉任务，Sonnet 系列的视觉能力一直很强。

📂 任务分类配置

任务分类 (Category) 适用场景 推荐模型
ultrabrain 极度烧脑的任务，逻辑密度极大 Claude 3 Opus
visual-engineering 前端、UI/UX、CSS 样式调整 Claude 3.5 Sonnet (审美更好)
artistry 需要创造性、非传统方案的任务 Claude 3.5 Sonnet
quick 简单任务、改错别字、小修小补 Claude 3.5 Haiku (秒回，省钱)
writing 编写文档、文案、注释 Claude 3.5 Sonnet
unspecified-low 未分类的简单兜底任务 Claude 3.5 Haiku
unspecified-high 未分类的复杂兜底任务 Claude 3.5 Sonnet

通过这套配置，我们实现了一个完美的 AI 组合拳：Opus 负责思考，Sonnet 负责干活，Haiku 负责跑腿。既保证了输出质量，又最大程度地节省了 Token 消耗和等待时间。

使用体验

安装配置好后，怎么用呢？

在你的项目目录下，直接输入：

1
opencode

或者使用 Oh My OpenCode 的别名（如果有的话）。

进入交互界面后，你可以直接用自然语言给它下指令：

“帮我分析一下 src 目录下的代码结构”
“在 current 目录下创建一个 React 组件”
“解释一下这个报错是什么原因”

它会根据你的指令，自动规划任务，甚至直接帮你修改代码文件。

使用界面

Oh My OpenCode 特有功能

配置好环境只是第一步，Oh My OpenCode 真正的强大之处在于它内置的一系列 “黑科技”。

1. 🚀 自动化工作流 (Hooks)

Oh My OpenCode 内置了 20+ 个自动化钩子 (Hooks)，能让 OpenCode 变得更聪明、更主动。

  • **自动修复 (Auto-Fix)**：当执行命令报错时，它会自动分析错误日志，并尝试给出修复建议，甚至直接修复。
  • **上下文管理 (Context Management)**：自动分析你的项目结构，智能加载相关文件到上下文中，不再需要你手动 @file 一个个添加。
  • Git 增强：在 commit 前自动检查代码规范，甚至帮你自动写 Commit Message。

2. 🧩 MCP 协议集成 (Model Context Protocol)

这是 Anthropic 推出的一个非常强大的协议，Oh My OpenCode 做了深度集成。简单来说，就是让 AI 能 “连接一切”。

  • 连接 GitHub：直接让 AI 读取 GitHub 上的 Issue、PR，甚至搜索代码库。
  • 连接数据库：配置好 MCP 后，AI 可以直接查询你的本地或远程数据库，帮你写 SQL。
  • 连接浏览器：内置 Playwright MCP，让 AI 可以控制浏览器进行测试、截图、抓取数据。

3. 🧠 专家 Agent 协同

除了前面配置的 Oracle、Metis 等，Oh My OpenCode 还引入了 “任务分类” (Categories) 的概念。

你可以通过 task() 命令明确指定任务类型，从而唤起最专业的 Agent：

  • **task(category="visual-engineering")**：唤起前端专家，它会更关注 UI/UX 细节，写出的 CSS 更漂亮。
  • **task(category="ultrabrain")**：唤起逻辑专家 (Opus)，专门解决算法难题或复杂的架构设计。
  • **task(category="quick")**：唤起快手 (Haiku)，专门处理改错别字、简单重构等小任务，速度飞快。

4. 🛠️ 常用命令别名

为了提高效率，Oh My OpenCode 封装了一系列快捷命令：

  • **/refactor**：智能重构当前文件，它会先分析依赖关系，确保重构不会破坏现有功能。
  • **/gen-docs**：自动为当前模块生成 README.md 和接口文档。
  • **/explain**：用人话解释当前复杂的代码逻辑。
  • **/test**：自动为当前文件生成单元测试，并尝试运行。

    结语

折腾了一圈，发现 OpenCode + Oh My OpenCode 的组合确实能提升不少效率，尤其是对于一些重复性的 CRUD 工作，或者需要快速了解陌生代码库的时候。

当然，AI 目前还不能完全替代程序员，但它绝对是一个非常给力的 “副驾驶”。

犯二青年

犯二青年

一个平淡的开发者~

26
5
50
TOC
  1. 1. 前言
  2. 2. 什么是 OpenCode？
  3. 3. 环境准备
  4. 4. 安装步骤
    1. 4.1. 1. 安装 OpenCode 核心
  5. 5. OpenCode 基础配置
    1. 5.1. Oh My OpenCode 配置
    2. 5.2. Oh My OpenCode 进阶配置：模型分流
  6. 6. 使用体验
  7. 7. Oh My OpenCode 特有功能
    1. 7.1. 1. 🚀 自动化工作流 (Hooks)
    2. 7.2. 2. 🧩 MCP 协议集成 (Model Context Protocol)
    3. 7.3. 3. 🧠 专家 Agent 协同
    4. 7.4. 4. 🛠️ 常用命令别名
  8. 8. 结语
NOTICE

保持好奇，刻意练习，每日精进！

CATEGORYS
TAGS
AI API签名 Agent Charles Chrome ChromeDP ChromeDriver Docker Desktop EFK ElasticSearch ElasticSearch Dump Elasticsearch Filebeat Git Golang IPTV Jenkins Kibana Linux MySQL OpenCode PhpStorm SSL Swoole UDP Ubuntu Xdebug deploy gRPC git hyperf k8s k8s教程系列 mysqldump php-cs-fixer sql supervisord web逆向 并发编程 开发小技巧 微服务 效率工具 数据库备份 数据库迁移 数据迁移 海南电信 薅羊毛 证书 踩坑日记 运维技巧