opencode 起手式

opencode 是一个TUI终端开发工具，与它相似的工具对比如下

项目	开源	主要形态	模型支持灵活性	上下文/大项目处理	Agent自主能力（多步规划执行）	权限/安全控制	价格/成本模式	最大亮点（2026年初）	明显短板/痛点	最适合人群
OpenCode	是	终端TUI（最美观）+桌面版	★★★★★ (75+提供商+本地+OpenRouter)	★★★★☆	★★★★☆	中等（可配置，可yolo）	完全免费+自带Key	模型最自由、TUI最丝滑、迭代最快、社区爆炸	偶尔小bug、极致稳定性略逊Claude Code	追求自由度、多模型切换、终端美学的开发者
Claude Code	否	终端TUI + VSCode官方扩展	★☆☆☆☆ (仅Anthropic自家)	★★★★★	★★★★★	★★★★★（最严格、最安全）	Pro/Max订阅+$17~100+/月	Claude推理最强、体验最官方、最稳、最少幻觉	完全锁死Anthropic、贵、不能换模型	Claude重度用户、追求最强单模型+安全感的团队
Aider	是	纯终端CLI（极简）	★★★★☆ (主流都支持)	★★★★☆	★★★★☆	★★★★☆（非常透明、可控）	免费+自带Key	Git整合最深、最适合长期迭代大项目、repomap神器	UI最丑（基本没TUI）、上手门槛稍高	Git重度用户、喜欢极简+深度Git工作流的极客
iFlow CLI	是	终端CLI + 多Agent生态	★★★★☆ (免费国产模型为主+OpenAI兼容)	★★★★☆	★★★★½ (多SubAgent协作)	★★★☆☆（有yolo模式，很激进）	基本免费（平台赠送额度）	免费强模型（Kimi/K2、Qwen3、DeepSeek等）、多Agent+市场插件生态、CI集成好	主要偏中文生态、英文体验稍弱、权限较松	想0成本用国产顶级模型、喜欢多Agent协作、做CI自动化的人

另外 opencode 还有

• 优秀的中文教程 opencode 中文教程
• 当前免费模型 Grok Code Fast 1、 Big Pickle、GLM 4.7、MiniMax M2.1
• 支持 Superpowers 插件

Superpowers 插件 是目前 AI 编码代理领域最受欢迎、最有影响力的技能框架之一，由开发者 obra（fsck.com 作者）创建，主要目标是为编码代理（coding agents）提供一套完整、可组合、可复用的软件开发工作流和方法论。

它最初是为 Claude Code 设计的，后来扩展支持 OpenCode 和 OpenAI Codex 等平台，成为跨平台的事实标准技能库（截至2026年初，GitHub 星数已超过 15k+）。

缺点

• 插件、MCP安装比较麻烦，没有一键安装
• GUI客户端（不依赖终端）不成熟

一、准备

1.1 安装

参考 安装：5 分钟搞定

说明

• 通过curl安装命令客户端名叫opencode-cli
• 通过 备用安装方式npm、pnpm、bun、yarn 安装后客户端名叫 opencode （这种较多）

1.2 安装插件

推荐安装 Superpowers 插件，借鉴开源社区在工程实践中的优秀规范经验

# 克隆仓库到指定位置
mkdir -p ~/.config/opencode/superpowers
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers

#创建插件目录并建立软链接（让 OpenCode 能发现它）
mkdir -p ~/.config/opencode/plugin
ln -sf ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js ~/.config/opencode/plugin/superpowers.js

# 重启 OpenCode（最重要一步！）。退出当前 opencode 会话，然后重新打开即可

验证方案，启动 opencode 终端后问一句："do you have superpowers?" 应该明确回答有

1.3 安装MCP

• web 搜索插件 mcp-fetch 特点不用FQ，缺点不能搜github
• context7 提供最新API查询
• app.grep 提供文件内容搜索

通过编辑 ~/.config/opencode/opencode.json 文件可以实现MCP服务安装，大概如下

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fetch": {
      "type": "local",
      "command": [
        "bun",
        "x",
        "fetch-mcp@latest"
      ],
      "enabled": true,
      "timeout": 60000,
      "environment": {
        "PLAYWRIGHT_BROWSERS_PATH": "0",
        "FETCH_MCP_HEADLESS": "true"
      }
    },
    "context7": {
      "type": "local",
      "command": ["bun", "x", "@upstash/context7-mcp", "--api-key", "你的 API_KEY"],
      "enabled": true
    }, 
    "grepapp": {
      "type": "remote",
      "url": "https://mcp.grep.app",
      "enabled": true
    }
  }
}

1.4 首个提问

对于新项目以下提问可以引导你实施，提升工作效率

英文版

I want to start a new project: [简单一句话描述项目]

Please follow your full Superpowers workflow from the beginning:
1. Start with brainstorming and design refinement
2. Use git worktrees for isolation
3. Break everything into small testable tasks
4. Strictly follow RED-GREEN-REFACTOR for every change
5. Do two-stage reviews between tasks

中文版

我想启动一个新项目：[在此用一句话描述项目]

请从头开始遵循您的完整 Superpowers 工作流程：
1. 从头脑风暴与设计优化开始
2. 使用 git worktrees 进行隔离开发
3. 将所有工作拆分为可测试的小任务
4. 对每个更改严格遵循 RED-GREEN-REFACTOR 循环
5. 在任务间执行两阶段代码评审

说明git worktrees隔离开发时，AI会将某个功能块创建为独立目录进行实现，待实施检验完成后会提醒你将代码其合并到当前项目。

二、界面操作说明

2.1 多项选择界面

在和AI对话过程中，有时需要我们一次选择确定多个事项，opencode 会显示这样的界面

它的操作方法是

1. 先用↑/↓定位你要选择的条目，再按回车键Enter确定选中
2. 然后通过→切换到下一个待选卡片继续选中。可以使用←回到之前选择的卡片上重选
3. 在最后一个卡片Submit上输入Enter后将提交整个选择结果