导读：阿里巴巴近期开源AI代码审查助手OpenCodeReview，本文为它的使用指南。

引言

2026 年，AI 编程工具已经从”要不要用”变成了”用哪个”。Stack Overflow 最新调查显示，84% 的开发者正在使用或计划采用 AI 编程工具，GitHub 上超过 51% 的新代码由 AI 生成或辅助完成。

在这个拥挤的赛道中，一款名为 OpenCode 的开源工具正在迅速崛起——143,000+ GitHub Stars、75+ AI 模型支持、完全开源（MIT 协议）、终端原生。它由阿里巴巴 Anomaly Innovations 团队打造，用 Go 语言编写，承诺在提供强大 AI 编程能力的同时，绝不存储你的代码。

本文将从安装配置、核心功能、实际使用场景、与主流工具的对比等角度，深度评测 OpenCode 是否值得你切换。

OpenCode 是什么？

OpenCode 不是一个让你粘贴代码的聊天机器人，而是一个真正的 Agentic 编程助手——它能理解你的项目结构，自动读取文件、编写代码、运行命令、执行测试，并在每一步等待你的审批。

架构上，OpenCode 采用客户端/服务器模式。后端负责 AI 模型通信、工具执行和会话存储（本地 SQLite），前端可以是终端 TUI、桌面应用或 IDE 扩展。这意味着你可以在笔记本上跑后端，用手机终端远程操控——灵活度拉满。

GitHub 仓库

https://github.com/alibaba/open-code-review

Stars: 143,000+ ，许可协议: MIT ，使用价格: 免费。

两个内置 Agent

OpenCode 内置两个 Agent，按 Tab 键切换：

• Build（默认）：拥有全部工具权限——读写文件、执行 Shell 命令、搜索代码库。这是主力开发 Agent，适合日常编码和重构。
• Plan（只读）：只分析不修改。适合在动手前审查方案，或者探索不熟悉的代码库。
  
  

此外，你还可以通过 Markdown 配置文件创建自定义 Agent，比如一个只提反馈不改代码的 Review Agent，用于代码审查工作流。

安装与配置：5 分钟上手

OpenCode 的安装极其简单，几乎所有主流平台都有对应的安装方式。

macOS（推荐 Homebrew）：

brew install opencode

Linux（通用安装脚本）：

curl -fsSL https://opencode.ai/install | bash

Arch Linux（AUR）：

yay -S opencode-bin

Windows（Chocolatey / Scoop）：

choco install opencode

# 或者使用：

scoop install opencode

npm（跨平台）：

npm install -g opencode-ai@latest

Docker（完全隔离）：

docker run -it -v $(pwd):/app anomalyco/opencode:latest

安装完成后，进入项目目录运行初始化：

cd /path/to/your/projectopencode init

这会分析你的项目结构并生成 AGENTS.md 文件，告诉 OpenCode 你的技术栈、编码规范、重要文件路径。把这个文件提交到 Git，全团队共享相同的 AI 上下文。

连接 AI 模型

OpenCode 最独特的地方在于它的模型灵活性。运行 opencode 进入终端界面，使用 /models 命令查看和切换模型。

我们有三种选择：

方式一：完全免费模型（零成本入门）

OpenCode 内置了多个免费模型，无需任何 API Key：

opencode models

当前可用的免费模型包括：

方式二：自带 API Key

连接 Anthropic、OpenAI、Google、Groq 等 75+ 提供商：

opencode auth login

或直接设置环境变量：

export ANTHROPIC_API_KEY="sk-ant-your-key-here"export OPENAI_API_KEY="sk-your-key-here"export GOOGLE_API_KEY="your-google-key"

方式三：100% 本地模型（最高隐私）

对于医疗、金融、政府等合规场景，代码绝不出机器：

# 先安装 Ollama

ollama pull codellama:13bollama pull qwen2.5 -coder:7b

# 在 opencode.json 中配置

{  "model": "ollama/qwen2.5-coder:7b"}

通过 opencode.json 配置文件，你可以对不同项目指定不同模型：

{"$schema": "https://opencode.ai/config.json","model": "anthropic/claude-sonnet-4-20250514","providers": {"anthropic": {"apiKey": "env:ANTHROPIC_API_KEY"},"openai": {"apiKey": "env:OPENAI_API_KEY"}},"theme": "opencode","instructions": ["docs/", "README.md"]}

提示：env: 前缀让 OpenCode 从环境变量读取敏感信息，避免在配置文件中明文存储 API Key。

核心功能实测

1. LSP 集成：像 IDE 一样理解代码

OpenCode 集成了 Language Server Protocol，这意味着它能获得与 VS Code 同等水平的代码智能——类型推断、引用查找、诊断信息。AI 在修改代码时不再是”盲改”，而是有完整的语义理解。

具体能获取的信息：

• 函数签名和类型信息
• 所有引用位置（Find All References）
• 编译错误和警告（Diagnostics）
• 代码符号列表（Document Symbols）

这对于大型项目尤其重要。当你让 AI “重构这个模块”时，它能精确定位所有调用方，避免漏改。

2. 多会话并行：真正的并行工作流

OpenCode 是目前唯一支持多会话并行的 CLI 工具。你可以同时运行：

• 会话 1：修复 Bug A
• 会话 2：开发功能 B
• 会话 3：Review 所有改动

每个会话独立维护上下文，互不干扰。按 /sessions 在它们之间切换。会话数据存储在本地 SQLite 数据库中，关掉终端也能恢复。

3. Undo/Redo：不依赖 Git 的安全网

/undo 和 /redo 命令让你可以即时撤销或重做 AI 的编辑，无需 git reset。这是 Agentic 工作流的重要安全保障——AI 改错了？一键回退。连续误操作？/redo 恢复。

4. MCP 集成：连接你的数据世界

OpenCode 原生支持 Model Context Protocol（MCP），可以连接数据库、API、文件系统等外部服务：

{"mcp": {"postgres": {"type": "local","command": ["npx", "-y", "@modelcontextprotocol/server-postgres","postgresql://localhost:5432/mydb"]},"filesystem": {"type": "local","command": ["npx", "-y", "@modelcontextprotocol/server-filesystem","/path/to/allowed/dir"]}}}

配置后，你可以直接在对话中让 AI 查询数据库、分析表结构、甚至根据数据生成代码。

5. 非交互模式：脚本化和 CI 集成

除了进入 TUI 交互使用，OpenCode 还支持单次命令模式：

# 给项目添加单元测试

opencode -p "给 src/utils/ 目录下的所有函数添加单元测试"

# 自动代码审查

opencode -p "审查 src/api/ 目录的安全漏洞，重点关注 SQL 注入和 XSS"

# 理解代码

opencode -p "解释 lib/auth.js 的完整认证流程，画出时序图"

# 生成文档

opencode -p "为 src/models/ 目录下的所有数据模型生成 API 文档"

这非常适合集成到 CI 流水线中，自动化代码审查和测试生成。

6. 自定义命令：团队规范自动化

创建可复用的 Prompt 模板，作为 Markdown 文件存储在项目中：

# commands/code-review.md

请审查以下代码变更，关注：

1. SQL 注入风险

2. XSS 漏洞

3. 敏感信息泄露（密钥、Token、密码）

4. 错误处理是否完整

5. 是否有未处理的边界情况

只提反馈，不修改代码。按严重程度排序。

团队成员在 PR 时运行：

opencode -p "@commands/code-review.md 审查本次 PR 的所有变更"

7. 自动压缩上下文

当对话接近模型上下文窗口的 95% 时，OpenCode 会自动压缩会话，将早期消息总结为摘要。你也可以手动触发 /compact。这让长时间的开发会话不会因上下文溢出而中断。

实际使用场景

场景一：接手遗留代码

面对一个没有文档的旧项目？用 Plan Agent 安全探索：

> 分析这个项目的完整架构，列出所有 API 端点、数据模型、

> 中间件链和关键依赖关系。不要修改任何文件。

Plan 模式只读不写，你会得到一份结构化的项目地图，比手动翻代码快得多。

场景二：跨文件重构

需要重命名一个被 20 个文件引用的函数？

> 把 authenticateUser 重命名为 validateAndAuthenticate，

> 更新所有引用位置，确保所有现有测试仍然通过。

OpenCode 通过 LSP 找到所有引用，逐一修改，然后运行测试验证——全程不需要你手动操作。万一改错，/undo 一键回退。

场景三：新人入职引导

把 AGENTS.md 配置好，新同事 clone 项目后运行：

> 我是新加入的开发者，请帮我理解这个项目的核心业务流程

AI 基于 AGENTS.md 和实际代码给出针对性回答，比 README 更动态、更具体。

场景四：多任务并行开发

[会话 1]> 修复 login 模块的 token 过期 bug

[会话 2]> 给 user service 添加分页查询功能

[会话 3]> 审查今天所有改动的安全问题

三个会话独立运行，按 /sessions 切换，效率翻倍。

OpenCode vs 主流工具对比

维度	OpenCode	Claude Code	GitHub Copilot	Cursor
类型	终端 + 桌面 + IDE 扩展	终端 CLI	IDE 扩展	AI 原生 IDE
价格	免费 （MIT 开源）	$20+/月	$10-19/月	$20/月
模型灵活性	75+ 提供商 ，完全 BYOK	仅 Claude	有限（Claude、GPT）	支持多种
最高隐私级别	100% 本地 （Ollama）	代码发送到 Anthropic	代码发送到 GitHub/MS	代码发送到 Cursor
开源	MIT
LSP 支持	完整		（IDE 上下文）	（IDE 内）
多会话并行	独有
Undo/Redo	/undo /redo	仅 Git		检查点系统
MCP 支持	完整		有限	有限
IDE 集成	VS Code、JetBrains、Neovim、Zed、Emacs	仅 CLI	所有主流 IDE	自有 IDE

谁应该用 OpenCode？

适合你，如果：

• 对代码隐私有严格要求（医疗、金融、政府、法律行业）
• 团队 50+ 人，SaaS 订阅费是一笔可观开支
• Neovim / Emacs / 终端编辑器的重度用户
• 需要多 Agent 并行工作，一个 Bug 修复 + 一个功能开发同时进行
• 不想被单一 AI 提供商锁定，希望随时切换

可能不适合你，如果：

• 追求开箱即用、零配置——GitHub Copilot 更直接
• 需要极深度的复杂代码推理——Claude Code + Opus 4.6 目前仍领先
• 更喜欢可视化 GUI 体验——Cursor 的 IDE 体验更好
• 团队缺乏 DevOps 经验，不熟悉本地模型管理

总结

OpenCode 不是 Copilot 的”平价替代品”，而是一个更自由、更开放的选择。它的核心竞争力在于：

1. 完全开源：MIT 协议，代码可审计、可修改、可商用
2. 模型自由：75+ 提供商 + 免费模型 + 本地模型，永不锁定
3. 隐私至上：本地模型 + 本地 SQLite 存储，代码绝不出机器
4. 灵活架构：终端、桌面、IDE 扩展三端统一
5. 多会话并行：目前唯一支持该特性的 CLI 工具

如果你厌倦了每月为 AI 编程工具付费，或者对代码隐私有刚需，花 5 分钟装好 OpenCode，跑一次 opencode init，你可能会发现：原来不花钱也能享受一流的 AI 编程体验。

（编辑注：此文为较早时间所写，可能与当前阿里开源的版本略有不同，请各位注意甄别）

作者：小灰灰

来源：

https://www.tinyash.com/blog/opencode-open-source-terminal-agent/