anomalyco/opencode · 上手攻略
- 仓库：anomalyco/opencode
- 链接：https://github.com/anomalyco/opencode
- 分类：AI Agent · 编码工具
- 作者：Tom
- 更新：2026-08-04
是什么
OpenCode 是一个开源 AI 编码 Agent，由 anomalyco 开发，支持 macOS / Linux / Windows，可在终端运行也可使用桌面 GUI。它内置两种 Agent 模式（build / plan），通过 Tab 键切换；支持多 LLM 后端（OpenAI、Anthropic、Google、本地 Ollama 等），另有 Scout 子 Agent 负责外部文档研究。2025 年社区热度极高，是仅次于 Claude Code 的开源 Coding Agent 选项。
官方提供包管理器安装、YOLO 一键安装、桌面应用下载等多渠道安装方式，生态完整。
解决什么问题
- Claude Code 闭源且有订阅门槛：OpenCode 完全开源，可自托管、可审计代码，适合企业和个人不想被绑定在单一平台。
- 需要一个开箱即用的终端 Agent：不需要 VS Code 扩展、不需要复杂配置，装完在终端直接用。
- 多后端灵活切换：可以同时支持 OpenAI、Anthropic、Google、本地 Ollama，根据任务和成本灵活选择。
快速安装
YOLO（一行命令，最快）
curl -fsSL https://opencode.ai/install | bash
安装路径优先级：$OPENCODE_INSTALL_DIR > $XDG_BIN_DIR > $HOME/bin > $HOME/.opencode/bin。
Homebrew（macOS/Linux，推荐）
# 最新版（推荐）
brew install anomalyco/tap/opencode
# 官方 formula（更新较慢）
brew install opencode
npm / bun / pnpm / yarn
npm i -g opencode-ai@latest
# 或
bun add -g opencode-ai
pnpm add -g opencode-ai
yarn global add opencode-ai
Windows
scoop install opencode
# 或
choco install opencode
Arch Linux
sudo pacman -S opencode # 稳定版
paru -S opencode-bin # AUR 最新版
桌面应用
直接从 releases 或 opencode.ai/download 下载对应平台的安装包。
# macOS
brew install --cask opencode-desktop
# Windows
scoop bucket add extras && scoop install extras/opencode-desktop
核心用法
启动（终端）
opencode
# 指定工作目录
opencode /path/to/project
两种内置 Agent（Tab 切换）
| Agent | 模式 | 权限 | 适合场景 |
|---|---|---|---|
build |
默认 | 完整文件读写 + bash 执行 | 新功能开发、重构 |
plan |
只读 | 默认拒绝文件修改、执行 bash 前询问 | 代码探索、架构分析 |
切换方式：对话中按 Tab 键。
调用子 Agent
# 在消息中 @general 调用通用子 Agent（处理复杂多步搜索）
@general帮我找到这个项目里所有使用过时 API 的文件
配置文件
OpenCode 配置文档见 opencode.ai/docs，支持通过 opencode.json 或环境变量配置 LLM 后端、Agent 行为等。
本地模型（Ollama）
# 启动 Ollama
ollama serve
ollama pull llama3.2
# OpenCode 中选择 Ollama 后端（具体配置路径见官方文档）
典型适用场景
- 开源项目贡献：想给开源项目提 PR，但不想装沉重的 IDE；OpenCode 终端直用，读完代码直接改。
- 多后端实验：同时评估 GPT-4o 和 Claude-4 在同一任务上的表现，OpenCode 配置切换比 Claude Code 更灵活。
- 预算敏感用户：本地跑 Ollama + OpenCode 完全免费，不需要订阅 Claude Pro。
- 企业审计：可自托管、可审计源码，适合有合规要求的企业环境。
- 快速探索陌生代码库：用 plan 模式只读分析，不需要 Agent 有写权限，安全探索。
坑与注意
- 安装前移除旧版本：官方提示 v0.1.x 之前的旧版需要先卸载，否则可能有冲突。
- Ollama 后端功能受限：有报告指出使用 Ollama 托管模型时无法编辑文件（类似问题 Codex 也有），建议生产任务用云端 API。
- Agent 上限 bug：OpenCode 运行时目前只注册约 119 个 Agent（issue #27988），大量 Agent 安装会被静默丢弃——这是上游问题，OpenCode 自身在修复中。
- GUI vs CLI 行为差异：桌面版和终端版在权限控制、文件编辑确认方面行为略有不同，请注意区分。
- 模型成本差异大：用 GPT-4o 和 Claude Opus 的 API 成本差距达 10 倍以上，选后端时注意成本控制。
与同类对比
| 工具 | 类型 | 优势 | 劣势 |
|---|---|---|---|
| OpenCode | 开源 Agent | 完全开源、多后端、可审计、社区活跃（20+ 语言 README） | 生态比 Claude Code 窄 |
| Claude Code | 官方闭源 | 深度 Anthropic 集成、成熟生态、/plan 等丰富功能 | 闭源、需 Pro 订阅 |
| OpenAI Codex | 官方端侧 | OpenAI 嫡系、轻量 | 闭源、功能相对单一 |
| Aider | 开源 CLI | 支持更多模型、本地优先 | 无内置 Agent 人格体系 |
| Cursor | GUI IDE | 强大的 autocomplete、 composer | 主要是 IDE 插件，非独立 Agent |
一句话结论
OpenCode 是目前最成熟的完全开源 AI 编码 Agent，支持终端和桌面双界面、多 LLM 后端，适合想摆脱闭源工具绑定、自托管或低成本实验的开发者——桌面版开箱即用，Homebrew 一条命令装好，比 Claude Code 更轻、更透明。
最小可跑命令（macOS/Linux 示例）： ```bash
安装（最简 YOLO 方式）
curl -fsSL https://opencode.ai/install | bash
启动
opencode
或用 Homebrew
brew install anomalyco/tap/opencode && opencode
指定工作目录
opencode ~/my-project
硬件需求：x86_64 或 ARM64，无特殊 GPU 要求（走 API 模式）
CUDA: 无要求（LLM 调用走 API；本地 Ollama 模式需 GPU）
```
来源：GitHub README（dev 分支，含 20+ 语言 README）、官方文档、MorphLLM OpenCode vs Claude Code 对比 (July 2026)、Hacker News discussion (July 2025)。
不确定处：OpenCode 当前精确版本号未在 README 显式标注，建议 opencode --version 确认；plan 模式的具体权限边界（如是否允许 grep -r 等只读命令）建议首次使用前实测；agent 注册上限 bug 修复进度以 issue #27988 为准。