OpenCode：开源版 Claude Code，支持多模型与远程终端

OpenCode 支持的模型提供商非常多，文档里列了 30 多个，包括 Anthropic、OpenAI、DeepSeek、Google Vertex AI、Ollama 等。配置 API Key 超简单，直接在界面里运行：

/connect

选择你要用的 provider，输入 API Key 就完事了。Key 会保存在 ~/.local/share/opencode/auth.json。

CLI 命令详解

OpenCode 的 CLI 功能非常强大，远不止一个 opencode 命令。

非交互模式：脚本自动化利器

不想打开 TUI？直接命令行问问题：

opencode run "Explain the use of context in Go"

这个太适合写脚本/自动化了。还可以指定模型、附加文件：

opencode run --model anthropic/claude-3.5-sonnet --file ./src/main.py "帮我优化这段代码"

远程控制：服务器 + TUI 分离

这是我觉得最骚的设计。你可以在服务器上启动一个 headless 服务：

# 在服务器上
opencode serve --port 4096 --hostname 0.0.0.0

然后在另一台机器（甚至手机）上远程连接：

# 在本地
opencode attach http://10.20.30.40:4096

这意味着什么？你可以让一台高性能服务器跑 OpenCode 后端，自己用轻薄本甚至 iPad 远程操控。对于需要在服务器上编译/测试的场景，简直不要太爽。

Web 界面

不喜欢终端？还有 Web 界面：

opencode web

会自动打开浏览器，通过 Web 界面操作 OpenCode。

会话管理

# 列出所有会话
opencode session list

# 导出会话（方便分享或备份）
opencode export <sessionID>

# 导入会话（支持 JSON 文件或分享链接）
opencode import session.json
opencode import https://opncd.ai/s/abc123

统计消耗

想知道自己用了多少 token、花了多少钱？

opencode stats
opencode stats --days 7 --models # 按模型统计最近 7 天

GitHub 集成

OpenCode 还能直接当 GitHub Agent 用！在仓库里安装：

opencode github install

这会设置 GitHub Actions 工作流，让 OpenCode 自动处理 issue、PR 等任务。

MCP Server 集成

MCP（Model Context Protocol）是 Anthropic 搞的协议，用来给 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

实用 MCP 示例

官方文档给了几个实用例子：

Context7 - 搜索技术文档：

{"mcp":{"context7":{"type":"remote","url":"https://mcp.context7.com/mcp"}}}

使用：Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7

Grep by Vercel - 搜索 GitHub 代码：

{"mcp":{"gh_grep":{"type":"remote","url":"https://mcp.grep.app"}}}

不确定怎么实现某个功能？让它帮你在 GitHub 上搜代码示例！

MCP 管理命令

# 添加 MCP 服务器（交互式）
opencode mcp add

# 列出所有已配置的 MCP
opencode mcp list

# 调试 OAuth 问题
opencode mcp debug my-oauth-server

# 登出
opencode mcp logout my-oauth-server

Agent Skills：自定义技能

这是 OpenCode 的另一个杀手级功能：Skills。你可以定义可复用的技能，让 Agent 在特定场景下自动加载。

创建一个 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.

Skill 存放位置

OpenCode 会从这些位置查找 Skill：

• 项目级：.opencode/skill/<name>/SKILL.md
• 全局级：~/.config/opencode/skill/<name>/SKILL.md
• Claude 兼容：.claude/skills/<name>/SKILL.md（方便从 Claude Code 迁移）

权限控制

可以在 opencode.json 里控制哪些 Skill 可用：

{
  "permission": {
    "skill": {
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask",
      "*": "allow"
    }
  }
}

支持通配符，比如 internal-* 可以匹配所有 internal- 开头的 Skill。这个功能太适合团队协作了！你可以把常用的代码规范、发布流程、Code Review 检查清单都封装成 Skill，团队成员直接复用。

OpenCode Zen：懒人福音

如果你懒得折腾各种模型 API，官方还搞了个 OpenCode Zen 服务。Zen 是什么？就是官方帮你精选了一批专门针对编程智能体优化过的模型，测试过了，好用的才放进来。你只需要充值 20 刀，按用量付费，不用自己去各个平台申请 API。

说白了就是"交钱省心"模式。关键是：

• Zero markup（无加价），价格透明
• 余额到 5 刀自动充值 20 刀
• 设置每月消费限额，不怕超支

不过得说一句，如果你已经有各家的 API Key，直接用就行，Zen 不是必须的。

命令速查表

CLI 命令：

和 Claude Code 对比

总结

OpenCode 是我目前用过最舒服的开源编程智能体。不只是"能用"，而是功能真的很全：

• CLI 非交互模式方便写脚本
• 服务器/客户端分离支持远程控制
• 完整的 MCP 生态可以无限扩展能力
• Skills 让团队协作变得丝滑
• GitHub Agent 直接替代部分 DevOps 工作

优点：

• 完全开源，不绑定任何厂商
• 支持模型多到离谱
• TUI 交互体验极佳
• MCP、Skills 等高级功能齐全
• 客户端/服务端架构灵活

不足：

• 桌面应用还是 Beta，可能有 bug
• 没有 Claude Code 那种原生 Claude 集成的流畅度
• 入门需要自己配置 API Key（其实也不算缺点）

4.6 万 Star 的项目，500 多个贡献者，这势头很猛。喜欢折腾的朋友，强烈建议试试。

项目地址：https://github.com/anomalyco/opencode

官网：https://opencode.ai

文档：https://opencode.ai/docs