跳转到内容

快速开始

快速开始

5 分钟内让 Oh My OpenAgent 运行起来。两种安装方式 — 让代理安装,或者自己动手。

前置条件

  • 已安装并配置 OpenCode
  • 至少拥有一个 LLM 订阅并具有 API 访问权限(Claude、ChatGPT、Kimi、GLM 等)

安装

方式 A:代理辅助安装(推荐)

复制以下提示词并粘贴到你的 LLM 代理(Claude Code、AmpCode、Cursor 等):

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

代理将:

  • 下载并安装 oh-my-opencode
  • opencode.json 中注册插件
  • 设置默认配置

方式 B:手动安装

按照 安装指南 逐步操作。

首次运行:ultrawork

安装完成后,立即尝试 ultrawork:

ultrawork

或者使用更短的别名:

ulw

一个词激活所有代理。它们不会停止,直到任务完成。

推荐订阅

Oh My OpenAgent 与以下订阅配合良好(非合作关系,个人推荐):

订阅价格说明
ChatGPT$20/月稳定的多代理体验
Kimi Code$0.99/月超高性价比,限时优惠价
GLM 编码计划$10/月适合 GLM 模型访问

如果你有按 token 计费的访问权限,Kimi 和 Gemini 模型非常经济实惠。

验证安装

运行内置的诊断命令:

bunx oh-my-opencode doctor

它会检查:

  • opencode.json 中的插件注册
  • 配置文件有效性
  • 模型可用性和 API 密钥
  • 环境设置

上下文注入

Oh My OpenAgent 自动向每个会话注入上下文:

  • AGENTS.md — 分层项目上下文(参见 /init-deep
  • README.md — 项目概览
  • 条件规则 — 根据文件类型、代理或任务阶段自动激活

遥测

默认通过 PostHog 启用匿名遥测。它使用哈希化的安装标识符 — 不会使用你的原始主机名。

禁用方法:

export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1

详见 隐私政策

卸载

要移除 Oh My OpenAgent:

  1. 移除插件条目,从 opencode.json 中:
# 使用 jq
jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
  ~/.config/opencode/opencode.json > /tmp/oc.json && \
  mv /tmp/oc.json ~/.config/opencode/opencode.json
  1. 移除配置文件(可选):
rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
  ~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
  .opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
  1. 验证移除opencode --version — 插件不应再出现。

后续步骤

  • 代理系统 — 了解代理如何协作
  • 工具 — 探索 Hashline、LSP、MCP
  • 功能 — Ralph Loop、Todo Enforcer 等