# opencode-quickstart

**Repository Path**: coxio/opencode-quickstart

## Basic Information

- **Project Name**: opencode-quickstart
- **Description**: AI 编程宝藏组合 OpenCode + Oh My OpenCode 完整上手攻略
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-01-21
- **Last Updated**: 2026-03-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opencode-quickstart

OpenCode 安装与配置

安装 OpenCode 非常简单，支持多种方式：

macOS / Linux 用户推荐：

curl -fsSL https://opencode.ai/install | bash
Windows 用户选择：
```sh
# 使用 Chocolatey
choco install opencode

# 或使用 Scoop
scoop bucket add extras
scoop install extras/opencode
```
通用 npm 方式：
```sh
npm install -g opencode-ai
```
也支持 pnpm、yarn、bun：
```sh
pnpm install -g opencode-ai
bun install -g opencode-ai
yarn global add opencode-ai
```
安装完成之后，输入 `opencode` 进入程序，接下来你就可以开始使用了。

如果你有自己的 LLM 提供商，可以自定义认证配置：
```sh
opencode auth login
```
系统提供了多个认证选项：

- Anthropic → Claude Pro/Max
- OpenAI → ChatGPT Plus/Pro
- Google → OAuth with Antigravity
- ...
认证完成后，按提示把 LLM 提供商配置好，就可以直接在终端里使用了。

什么是 Oh My OpenCode

Oh My OpenCode 是 OpenCode 的插件，通过多个专业子智能体并行协作，模拟真实开发团队的工作方式。该方案已在生产环境中验证，累计消耗约 24,000 美元的 Token，具备较高的实战成熟度

智能体团队架构
Oh My OpenCode 包含 7 个专业子智能体，各自负责不同任务：

智能体名称
角色
核心职责
调用方式
Sisyphus
主协调器
负责整体任务规划、工作分派和结果整合
默认激活
Oracle
架构师
架构设计、代码审查、策略分析
@oracle
Librarian
研究员
文档检索、代码研究和实现示例
@librarian
Explore
探索者
快速代码库探索和模式匹配
@explore
Frontend UI/UX Engineer
前端工程师
前端开发与 UI/UX 设计
自动调用
Document Writer
文档撰写者
生成 README、API 文档及技术指南
自动调用
Multimodal Looker
多模态分析师
PDF、图像及图表分析
自动调用
工作原理
Oh My OpenCode 的任务执行流程如下：

用户输入任务
    ↓
Sisyphus（主协调器）解析任务并制定执行计划
    ↓
Sisyphus 将任务分派给相应的专业子智能体
    ↓
子智能体在后台并行执行各自任务
    ↓
Sisyphus 汇总各子智能体的输出
    ↓
生成最终结果
整个过程为全自动化。用户只需输入任务描述，系统会根据任务类型自动调度相应的子智能体完成工作，无需额外干预。

Oh My OpenCode 安装
安装 Oh My OpenCode 前需要先安装 OpenCode。安装命令如下：
```sh
# 使用 npx 安装
npx oh-my-opencode install

# 或使用 bunx（推荐，更快）
bunx oh-my-opencode install
```
虽然官方说用一行命令就能完成安装，但我建议你先安装 bun，再执行 npx 来安装，否则可能会报错。

在安装过程中，Oh My OpenCode 会提供交互式配置引导，主要包括以下步骤：

- 选择所使用的模型提供商
- 配置对应的 API 密钥
- 设置各子智能体使用的模型
如果你什么都没有，一直选 No 就行了：