> [!WARNING]
> **安全警告：冒充网站**
>
> **ohmyopencode.com 与本项目无关。** 我们不运营或认可该网站。
>
> OhMyOpenCode 是**免费且开源的**。请**勿**在声称"官方"的第三方网站下载安装程序或输入付款信息。
>
> 由于该冒充网站设有付费墙，我们**无法验证其分发的内容**。请将来自该网站的任何下载视为**潜在不安全**。
>
> ✅ 官方下载地址：https://github.com/code-yeongyu/oh-my-opencode/releases

> [!NOTE]
>
> [![Sisyphus Labs — Sisyphus 是像你的团队一样编码的智能体。](./.github/assets/sisyphuslabs.png?v=2)](https://sisyphuslabs.ai)
> > **我们正在构建 Sisyphus 的完整产品化版本，以定义前沿智能体的未来。<br />点击[此处](https://sisyphuslabs.ai)加入等候名单。**

> [!TIP]
>
> [![Oh My OpenCode 3.0 正式发布！](./.github/assets/orchestrator-atlas.png?v=3)](https://github.com/code-yeongyu/oh-my-opencode/releases/tag/v3.0.0)
> > **Oh My OpenCode 3.0 正式发布！使用 `oh-my-opencode@latest` 安装。**
>
> 加入我们！
>
> | [<img alt="Discord 链接" src="https://img.shields.io/discord/1452487457085063218?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/PUwSMR9XNk) | 加入我们的 [Discord 社区](https://discord.gg/PUwSMR9XNk)，与贡献者和 `oh-my-opencode` 用户交流。 |
> | :-----| :----- |
> | [<img alt="X 链接" src="https://img.shields.io/badge/Follow-%40justsisyphus-00CED1?style=flat-square&logo=x&labelColor=black" width="156px" />](https://x.com/justsisyphus) | `oh-my-opencode` 的新闻和更新曾在我的 X 账号上发布。<br /> 由于账号被错误封禁，[@justsisyphus](https://x.com/justsisyphus) 现在代为发布更新。 |
> | [<img alt="GitHub 关注" src="https://img.shields.io/github/followers/code-yeongyu?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/code-yeongyu) | 在 GitHub 上关注 [@code-yeongyu](https://github.com/code-yeongyu) 获取更多项目。 |

<!-- <居中展示区域> -->

<div align="center">

[![Oh My OpenCode](./.github/assets/hero.jpg)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)

[![预览](./.github/assets/omo.png)](https://github.com/code-yeongyu/oh-my-opencode#oh-my-opencode)


</div>

> 这是开挂级别的编程——`oh-my-opencode` 实战效果。运行后台智能体，调用专业智能体如 oracle、librarian 和前端工程师。使用精心设计的 LSP/AST 工具、精选的 MCP，以及完整的 Claude Code 兼容层。

# Claude OAuth 访问通知

## TL;DR

> Q. 我可以使用 oh-my-opencode 吗？

可以。

> Q. 我可以用 Claude Code 订阅来使用它吗？

是的，技术上可以。但我不建议使用。

## 详细说明

> 自2026年1月起，Anthropic 以违反服务条款为由限制了第三方 OAuth 访问。
>
> [**Anthropic 将本项目 oh-my-opencode 作为封锁 opencode 的理由。**](https://x.com/thdxr/status/2010149530486911014)
>
> 事实上，社区中确实存在一些伪造 Claude Code OAuth 请求签名的插件。
>
> 无论技术上是否可检测，这些工具可能都能正常工作，但用户应注意服务条款的相关影响，我个人不建议使用这些工具。
>
> 本项目对使用非官方工具产生的任何问题概不负责，**我们没有任何这些 OAuth 系统的自定义实现。**


<div align="center">

[![GitHub 发布](https://img.shields.io/github/v/release/code-yeongyu/oh-my-opencode?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/releases)
[![npm 下载量](https://img.shields.io/npm/dt/oh-my-opencode?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/oh-my-opencode)
[![GitHub 贡献者](https://img.shields.io/github/contributors/code-yeongyu/oh-my-opencode?color=c4f042&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/graphs/contributors)
[![GitHub Forks](https://img.shields.io/github/forks/code-yeongyu/oh-my-opencode?color=8ae8ff&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/network/members)
[![GitHub Stars](https://img.shields.io/github/stars/code-yeongyu/oh-my-opencode?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/oh-my-opencode?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/issues)
[![许可证](https://img.shields.io/badge/license-SUL--1.0-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE.md)

[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/code-yeongyu/oh-my-opencode)

</div>

<!-- </居中展示区域> -->

## 用户评价

> "它让我取消了 Cursor 订阅。开源社区正在发生令人难以置信的事情。" - [Arthur Guiot](https://x.com/arthur_guiot/status/2008736347092382053?s=20)

> "如果 Claude Code 能在 7 天内完成人类 3 个月的工作，那么 Sisyphus 只需 1 小时。它会持续工作直到任务完成。它是一个非常自律的智能体。" — B, 量化研究员

> "用 Oh My Opencode 仅用一天就清理了 8000 个 eslint 警告" — [Jacob Ferrari](https://x.com/jacobferrari_/status/2003258761952289061)

> "我使用 Ohmyopencode 和 ralph loop 在一夜之间将一个 45k 行的 tauri 应用转换成了 SaaS Web 应用。从访谈提示开始，要求它对问题进行评分和建议。看着它工作非常精彩，今早醒来发现网站基本上已经可以运行了！" - [James Hargis](https://x.com/hargabyte/status/2007299688261882202)

> "用了 oh-my-opencode，你再也不会回头了" — [d0t3ch](https://x.com/d0t3ch/status/2001685618200580503)

> "我还没能准确表达出它为什么如此出色，但开发体验已经达到了一个完全不同的维度。" - [苔硯:こけすずり](https://x.com/kokesuzuri/status/2008532913961529372?s=20)

> "这个周末用 open code、oh my opencode 和 supermemory 来构建某种 minecraft/souls-like 怪物游戏。"
> "让它添加蹲伏动画，我去散个午后的步。[视频]" - [MagiMetal](https://x.com/MagiMetal/status/2005374704178373023)

> "你们应该把这个合并到核心代码并招募他。认真的。这真的非常非常非常好。" — Henning Kilset

> "如果你能说服他的话就雇用 @yeon_gyu_kim，这个人彻底革新了 opencode。" — [mysticaltech](https://x.com/mysticaltech/status/2001858758608376079)

> "Oh My OpenCode 真的太疯狂了" - [YouTube - Darren Builds AI](https://www.youtube.com/watch?v=G_Snfh2M41M)

---

## 目录

- [Oh My OpenCode](#oh-my-opencode)
  - [直接跳过阅读本文档](#直接跳过阅读本文档)
    - [这是智能体时代](#这是智能体时代)
    - [🪄 魔法词：`ultrawork`](#-魔法词ultrawork)
    - [给想阅读的人：认识 Sisyphus](#给想阅读的人认识-sisyphus)
    - [追求自主性：认识赫菲斯托斯](#追求自主性认识赫菲斯托斯)
      - [直接安装就行。](#直接安装就行)
  - [安装](#安装)
    - [面向人类用户](#面向人类用户)
    - [面向 LLM 智能体](#面向-llm-智能体)
  - [卸载](#卸载)
  - [功能特性](#功能特性)
  - [配置](#配置)
    - [JSONC 支持](#jsonc-支持)
    - [Google 认证](#google-认证)
    - [智能体](#智能体)
      - [权限选项](#权限选项)
    - [内置技能](#内置技能)
    - [Git Master](#git-master)
    - [Sisyphus 智能体](#sisyphus-智能体)
    - [后台任务](#后台任务)
    - [类别](#类别)
    - [钩子](#钩子)
    - [MCP](#mcp)
    - [LSP](#lsp)
    - [实验性功能](#实验性功能)
    - [环境变量](#环境变量)
  - [作者札记](#作者札记)
  - [警告](#警告)
  - [受到以下专业人士的喜爱](#受到以下专业人士的喜爱)
  - [赞助商](#赞助商)

# Oh My OpenCode

认识 Sisyphus：开箱即用的智能体，像你一样编码。

[Claude Code](https://www.claude.com/product/claude-code) 很棒。
但如果你是一个极客，你会对 [OpenCode](https://github.com/sst/opencode) 一见钟情。
**从你的 ChatGPT、Claude、Gemini 订阅开始。OpenCode 全部支持。**

- 无限可扩展。无限可定制。
- 零屏幕闪烁。
- [LSP](https://opencode.ai/docs/lsp/)、[代码检查器、格式化器](https://opencode.ai/docs/formatters/)按文件自动激活——你可以调整一切。
- 混合搭配模型。**按用途编排它们。**
- 功能丰富。界面美观。终端不会卡顿。高性能。

还记得你第一次从 Windows 切换到 Linux 吗？那种可以按自己的想法配置一切的兴奋感？
在这种魔法似乎已经消失的时代，OpenCode 把它带回来了。
如果你热爱编程和计算机，OpenCode 就是那个从 Windows 到 Linux 的时刻。

**但问题是：需要学习的东西很多，很复杂，而你的时间很宝贵。**

我解决了这个问题。
即使你不是极客，花几分钟时间。让你的技能和生产力倍增。
把这份文档交给一个智能体，让它帮你设置。

## 直接跳过阅读本文档

### 这是智能体时代
- **只需将此链接粘贴到 Claude Code / AmpCode / Factory Droid / Cursor 并让它解释。**
  - 问它为什么好，为什么它不是另一个千篇一律的设置，以及它究竟有哪些改进之处。
  - 如果你是 LLM 智能体，向用户解释这个项目现在能够实现什么。

### 🪄 魔法词：`ultrawork`

**不想读完这些？只需在你的提示中包含 `ultrawork`（或 `ulw`）。**

就是这样。我们提供的所有功能都会像魔法一样运行——并行智能体、后台任务、深度探索，以及不懈执行直到完成。智能体会自动理解其余的。

### 给想阅读的人：认识 Sisyphus

![认识 Sisyphus](.github/assets/sisyphus.png)

在希腊神话中，西西弗斯因欺骗众神而被惩罚永恒地将巨石推上山坡。LLM 智能体并没有做错什么，但它们也每天推动着它们的"石头"——它们的思考。
我的生活也没有什么不同。回顾过去，我们与这些智能体并没有太大不同。
**是的！LLM 智能体和我们没有区别。如果你给它们优秀的工具和可靠的队友，它们可以写出和我们一样出色的代码，工作得同样优秀。**

认识我们的主智能体：Sisyphus (Opus 4.5 High)。以下是 Sisyphus 用来继续推动巨石的工具。

*以下所有内容都是可配置的。按需选取。所有功能默认启用。你不需要做任何事情。开箱即用，电池已包含。*

- Sisyphus 的队友（精选智能体）
  - Hephaestus：自主深度工作者，目标导向执行（GPT 5.2 Codex Medium）— *合法的工匠*
  - Oracle：设计、调试 (GPT 5.2 Medium)
  - Frontend UI/UX Engineer：前端开发 (Gemini 3 Pro)
  - Librarian：官方文档、开源实现、代码库探索 (Claude Sonnet 4.5)
   - Explore：极速代码库探索（上下文感知 Grep）(Claude Haiku 4.5)
- 完整 LSP / AstGrep 支持：果断重构。
- Todo 继续执行器：如果智能体中途退出，强制它继续。**这就是让 Sisyphus 继续推动巨石的关键。**
- 注释检查器：防止 AI 添加过多注释。Sisyphus 生成的代码应该与人类编写的代码无法区分。
- Claude Code 兼容性：Command、Agent、Skill、MCP、Hook（PreToolUse、PostToolUse、UserPromptSubmit、Stop）
- 精选 MCP：
  - Exa（网络搜索）
  - Context7（官方文档）
  - Grep.app（GitHub 代码搜索）
- 支持交互式终端 - Tmux 集成
- 异步智能体
- ...

### 追求自主性：认识赫菲斯托斯

![Meet Hephaestus](.github/assets/hephaestus.png)

在希腊神话中，赫菲斯托斯是锻造、火焰、金属加工和工艺之神——他是神圣的铁匠，以无与伦比的精准和奉献为众神打造武器。
**介绍我们的自主深度工作者：赫菲斯托斯（GPT 5.2 Codex Medium）。合法的工匠代理。**

*为什么是"合法的"？当Anthropic以违反服务条款为由封锁第三方访问时，社区开始调侃"合法"使用。赫菲斯托斯拥抱这种讽刺——他是那种用正确的方式、有条不紊、彻底地构建事物的工匠，绝不走捷径。*

赫菲斯托斯的灵感来自[AmpCode的深度模式](https://ampcode.com)——在采取决定性行动之前进行彻底研究的自主问题解决。他不需要逐步指示；给他一个目标，他会自己找出方法。

**核心特性：**
- **目标导向**：给他目标，而不是配方。他自己决定步骤。
- **行动前探索**：在写一行代码之前，并行启动2-5个explore/librarian代理。
- **端到端完成**：在有验证证据证明100%完成之前不会停止。
- **模式匹配**：搜索现有代码库以匹配您项目的风格——没有AI垃圾。
- **合法的精准**：像大师铁匠一样编写代码——精准、最小化、只做需要的。

#### 直接安装就行。

你可以从 [overview page](docs/guide/overview.md) 学到很多，但以下是示例工作流程。

只需安装这个，你的智能体就会这样工作：

1. Sisyphus 不会浪费时间自己寻找文件；他保持主智能体的上下文精简。相反，他向更快、更便宜的模型并行发起后台任务，让它们为他绘制地图。
2. Sisyphus 利用 LSP 进行重构；这更确定性、更安全、更精准。
3. 当繁重的工作需要 UI 时，Sisyphus 直接将前端任务委派给 Gemini 3 Pro。
4. 如果 Sisyphus 陷入循环或碰壁，他不会继续撞墙——他会召唤 GPT 5.2 进行高智商战略支援。
5. 在处理复杂的开源框架时？Sisyphus 生成子智能体实时消化原始源代码和文档。他拥有完整的上下文感知。
6. 当 Sisyphus 处理注释时，他要么证明它们存在的必要性，要么删除它们。他保持你的代码库整洁。
7. Sisyphus 受他的 TODO 列表约束。如果他没有完成开始的工作，系统会强制他回到"推石头"模式。你的任务会被完成，句号。
8. 老实说，甚至不用费心读文档。只需写你的提示。包含 'ultrawork' 关键词。Sisyphus 会分析结构，收集上下文，挖掘外部源代码，然后持续推进直到工作 100% 完成。
9. 其实，打 'ultrawork' 太费劲了。只需打 'ulw'。就 ulw。喝杯咖啡。你的工作完成了。

需要查找什么？它会搜索官方文档、你的整个代码库历史和公共 GitHub 实现——不仅使用 grep，还使用内置的 LSP 工具和 AST-Grep。
3. 在委派给 LLM 时不用担心上下文管理。我已经处理好了。
    - OhMyOpenCode 积极利用多个智能体来减轻上下文负担。
    - **你的智能体现在是开发团队负责人。你是 AI 经理。**
4. 它不会停止，直到工作完成。
5. 不想深入研究这个项目？没问题。只需输入 'ultrathink'。

如果你不想要这些全部功能，如前所述，你可以只选择特定功能。

## 安装

### 面向人类用户

复制以下提示并粘贴到你的 LLM 智能体（Claude Code、AmpCode、Cursor 等）：

```
按照以下说明安装和配置 oh-my-opencode：
https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
```

或者直接阅读 [安装指南](docs/guide/installation.md)——但我们强烈建议让智能体来处理。人会犯错，智能体不会。

### 面向 LLM 智能体

获取安装指南并按照说明操作：

```bash
curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/docs/guide/installation.md
```

## 卸载

要移除 oh-my-opencode：

1. **从你的 OpenCode 配置中移除插件**

   编辑 `~/.config/opencode/opencode.json`（或 `opencode.jsonc`）并从 `plugin` 数组中移除 `"oh-my-opencode"`：

   ```bash
   # 使用 jq
   jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
       ~/.config/opencode/opencode.json > /tmp/oc.json && \
       mv /tmp/oc.json ~/.config/opencode/opencode.json
   ```

2. **移除配置文件（可选）**

   ```bash
   # 移除用户配置
   rm -f ~/.config/opencode/oh-my-opencode.json

   # 移除项目配置（如果存在）
   rm -f .opencode/oh-my-opencode.json
   ```

3. **验证移除**

   ```bash
   opencode --version
   # 插件应该不再被加载
   ```


## 功能特性

我们拥有众多功能，你会觉得这些功能理所当然应该存在，一旦体验过，就再也回不去了。
详细信息请参阅 [Features Documentation](docs/features.md)。

**概览：**
- **智能体**：Sisyphus（主智能体）、Prometheus（规划器）、Oracle（架构/调试）、Librarian（文档/代码搜索）、Explore（快速代码库 grep）、Multimodal Looker
- **后台智能体**：像真正的开发团队一样并行运行多个智能体
- **LSP & AST 工具**：重构、重命名、诊断、AST 感知代码搜索
- **上下文注入**：自动注入 AGENTS.md、README.md、条件规则
- **Claude Code 兼容性**：完整的钩子系统、命令、技能、智能体、MCP
- **内置 MCP**：websearch (Exa)、context7 (文档)、grep_app (GitHub 搜索)
- **会话工具**：列出、读取、搜索和分析会话历史
- **生产力功能**：Ralph Loop、Todo Enforcer、Comment Checker、Think Mode 等

## 配置

个性鲜明，但可以根据个人喜好调整。
详细信息请参阅 [Configuration Documentation](docs/configurations.md)。

**概览：**
- **配置文件位置**: `.opencode/oh-my-opencode.json` (项目级) 或 `~/.config/opencode/oh-my-opencode.json` (用户级)
- **JSONC 支持**: 支持注释和尾随逗号
- **智能体**: 覆盖任何智能体的模型、温度、提示和权限
- **内置技能**: `playwright` (浏览器自动化), `git-master` (原子提交)
- **Sisyphus 智能体**: 带有 Prometheus (Planner) 和 Metis (Plan Consultant) 的主编排器
- **后台任务**: 按提供商/模型配置并发限制
- **类别**: 领域特定的任务委派 (`visual`, `business-logic`, 自定义)
- **钩子**: 25+ 内置钩子，均可通过 `disabled_hooks` 配置
- **MCP**: 内置 websearch (Exa), context7 (文档), grep_app (GitHub 搜索)
- **LSP**: 带重构工具的完整 LSP 支持
- **实验性功能**: 积极截断、自动恢复等


## 作者札记

**想了解更多关于这个项目背后的理念吗？** 请阅读 [Ultrawork Manifesto](docs/ultrawork-manifesto.md)。

安装 Oh My OpenCode。

我纯粹为个人开发使用了价值 24,000 美元 token 的 LLM。
尝试了每一个工具，把它们配置到极致。但始终是 OpenCode 胜出。

我遇到的每个问题的答案都融入了这个插件。直接安装使用。
如果 OpenCode 是 Debian/Arch，Oh My OpenCode 就是 Ubuntu/[Omarchy](https://omarchy.org/)。


深受 [AmpCode](https://ampcode.com) 和 [Claude Code](https://code.claude.com/docs/overview) 的影响——我已经将它们的功能移植到这里，通常还有改进。我仍在构建。
毕竟这是 **Open**Code。

享受多模型编排、稳定性和其他工具承诺但无法交付的丰富功能。
我会持续测试和更新。因为我是这个项目最执着的用户。
- 哪个模型逻辑最锐利？
- 谁是调试之神？
- 谁写出最好的文字？
- 谁主宰前端？
- 谁拥有后端？
- 哪个模型日常使用最快？
- 其他工具在推出什么新功能？

这个插件是只取其精华。有更好的想法？欢迎 PR。

**不要再为智能体工具的选择而烦恼了。**
**我会进行研究，借鉴最好的，然后发布更新。**

如果这听起来很傲慢，但如果你有更好的答案，请贡献。欢迎你。

我与这里提到的任何项目或模型没有任何关联。这纯粹是个人实验和偏好。

这个项目 99% 是使用 OpenCode 构建的。我测试了功能——我实际上不太会写正确的 TypeScript。**但我个人审查并大量重写了这份文档，所以放心阅读。**

## 警告

- 生产力可能飙升太快。别让你的同事发现。
  - 其实，我会传播这个消息。让我们看看谁会赢。
- 如果你使用 [1.0.132](https://github.com/sst/opencode/releases/tag/v1.0.132) 或更早版本，一个 OpenCode bug 可能会破坏配置。
  - [修复](https://github.com/sst/opencode/pull/5040)在 1.0.132 之后合并——使用更新的版本。
    - 有趣的事实：那个 PR 是借助 OhMyOpenCode 的 Librarian、Explore 和 Oracle 设置发现并修复的。

## 受到以下专业人士的喜爱

- [Indent](https://indentcorp.com)
  - 制作 Spray - 网红营销解决方案、vovushop - 跨境电商平台、vreview - AI 电商评论营销解决方案
- [Google](https://google.com)
- [Microsoft](https://microsoft.com)

## 赞助商
- **Numman Ali** [GitHub](https://github.com/numman-ali) [X](https://x.com/nummanali)
  - 第一位赞助商
- **Aaron Iker** [GitHub](https://github.com/aaroniker) [X](https://x.com/aaroniker)
- **Suyeol Jeon (devxoul)** [GitHub](https://github.com/devxoul)
  - 开启我职业生涯的人，在如何构建出色的智能体工作流方面给了我很深的启发。我学到了很多关于设计伟大系统来构建伟大团队的知识，这些经验对创建这个工具至关重要。
- **Hyerin Won (devwon)** [GitHub](https://github.com/devwon)

*特别感谢 [@junhoyeo](https://github.com/junhoyeo) 制作这张精彩的主图。*
