OpenCode:开源版 Claude Code,支持多模型与远程终端
OpenCode 是一个 100% 开源的 AI 编程智能体,可以在终端、桌面应用或 IDE 里使用。它最大的特点是完全不绑定任何一家模型提供商,Claude、GPT、Gemini、DeepSeek 甚至本地模型都能用,支持 75+ 个 LLM provider。
核心特性
- 完全开源:代码全在 GitHub 上,想怎么改就怎么改
- 不绑定模型:支持主流大模型及本地部署方案
- 内置 LSP 支持:能自动识别项目语言,加载对应的语言服务器
- TUI 极致体验:专为终端用户设计,交互流畅
- 客户端/服务端架构:支持远程控制,电脑跑后端,手机或轻薄本操控前端
安装方式
官方推荐一键脚本,各平台包管理器也都支持:
curl -fsSL https://opencode.ai/install | bash
其他安装途径包括:
# macOS / Linux brew install opencode
# Windows (Chocolatey) choco install opencode
# Windows (Scoop) scoop bucket add extras && scoop install extras/opencode
# npm/pnpm/yarn npm install -g opencode-ai
# Docker docker run -it --rm ghcr.io/anomalyco/opencode
桌面应用目前处于 Beta 阶段,支持 macOS(Intel/Apple Silicon)、Windows 和 Linux(deb/rpm)。IDE 插件也已上线,可直接在编辑器中调用。
快速开始
进入项目目录,运行 opencode 即可启动。首次使用建议先运行 /init 命令,让 OpenCode 分析你的项目,自动生成一个 AGENTS.md 文件。这个文件能帮助 Agent 更好地理解项目结构和编码规范,建议提交到 Git 仓库。
两种内置模式
OpenCode 内置了两种工作模式,按 Tab 键切换:
- Build 模式(默认):拥有全权限,可以读写文件、执行命令
- Plan 模式:只读模式,只做分析和规划,不会动你的代码
Plan 模式特别适合探索不熟悉的代码库,或者先让 AI 出方案再手动执行。此外还有一个 @general 子智能体,可以处理复杂搜索和多步骤任务。
配置模型
OpenCode 支持的模型提供商非常多,包括 Anthropic、OpenAI、DeepSeek、Google Vertex AI、Ollama、LM Studio 等。配置 API Key 很简单,直接在界面里运行 /connect,选择 provider 输入 Key 即可。Key 会保存在 ~/.local/share/opencode/auth.json。
CLI 高级用法
非交互模式
不想打开 TUI?直接命令行问问题,非常适合写脚本或自动化:
opencode run "Explain the use of context in Go"
opencode run --model anthropic/claude-3.5-sonnet --file ./src/main.py "帮我优化这段代码"
远程控制
这是 OpenCode 最实用的设计之一。你可以在服务器上启动 headless 服务:
# 在服务器上
opencode serve --port 4096 --hostname 0.0.0.0
然后在另一台机器(甚至手机)上远程连接:
# 在本地
opencode attach http://10.20.30.40:4096
这意味着你可以让一台高性能服务器跑 OpenCode 后端,自己用轻薄本甚至 iPad 远程操控。对于需要在服务器上编译或测试的场景非常有用。
Web 界面与会话管理
不喜欢终端?还有 Web 界面:
opencode web
会话管理也很完善,支持列出、导出导入会话,方便分享或备份:
opencode session list
opencode export <sessionID>
opencode import session.json
GitHub 集成
OpenCode 还能直接当 GitHub Agent 用!在仓库里安装后,它会设置 GitHub Actions 工作流,自动处理 issue、PR 等任务。
opencode github install
MCP Server 集成
MCP(Model Context Protocol)是扩展 AI 智能体工具能力的协议。OpenCode 原生支持 MCP,配置起来超简单。
添加本地 MCP Server
在 opencode.json 配置文件里添加:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"my-local-mcp": {
"type": "local",
"command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
"enabled": true
}
}
}
添加远程 MCP Server
远程服务器也能用,比如接入 Sentry 来查 bug:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"sentry": {
"type": "remote",
"url": "https://mcp.sentry.dev/mcp",
"oauth": {}
}
}
}
配置完后认证一下,然后就可以在对话里用了:
opencode mcp auth sentry
Show me the latest unresolved issues in my project. use sentry
Agent Skills:自定义技能
Skills 是 OpenCode 的杀手级功能,你可以定义可复用的技能,让 Agent 在特定场景下自动加载。这非常适合团队协作,把常用的代码规范、发布流程封装成 Skill。
创建一个 Skill
在项目里创建 .opencode/skill/<name>/SKILL.md,例如 .opencode/skill/git-release/SKILL.md:
--- name: git-release description: Create consistent releases and changelogs license: MIT compatibility: opencode metadata: audience: maintainers workflow: github --- ## What I do - Draft release notes from merged PRs - Propose a version bump - Provide a copy-pasteable `gh release create` command ## When to use me Use this when you are preparing a tagged release. Ask clarifying questions if the target versioning scheme is unclear.
权限控制
可以在 opencode.json 里控制哪些 Skill 可用,支持通配符:
{"permission":{"skill":{"pr-review":"allow","internal-*":"deny","experimental-*":"ask","*":"allow"}}}
OpenCode Zen
如果你懒得折腾各种模型 API,官方还搞了个 OpenCode Zen 服务。Zen 是官方精选了一批专门针对编程智能体优化过的模型,测试过了才放进来。你只需要充值,按用量付费,不用自己去各个平台申请 API。
命令速查表
| 命令 | 作用 |
|---|---|
Tab | 切换 Build/Plan 模式 |
/init | 初始化项目 |
/connect | 配置 API Key |
/models | 查看可用模型 |
/share | 分享当前会话 |
/undo | 撤销上一步修改 |
@ | 模糊搜索项目文件 |
@general | 调用通用子智能体 |
| 命令 | 作用 |
|---|---|
opencode run "prompt" | 非交互模式运行 |
opencode serve | 启动 headless 服务 |
opencode attach <url> | 连接远程服务 |
opencode web | 启动 Web 界面 |
opencode stats | 查看用量统计 |
opencode mcp add | 添加 MCP 服务器 |
opencode github install | 安装 GitHub Agent |
总结
OpenCode 是目前比较成熟的开源编程智能体。相比闭源的竞品,它的优势在于完全开源、不绑定厂商、支持模型极多,且具备 TUI 交互体验、MCP 生态扩展能力以及 Skills 团队协作功能。虽然桌面应用还在 Beta 阶段,但整体势头很猛,值得开发者尝试。


