OpenCode：开源版 Claude Code 体验与配置指南

远程控制

这是设计最巧妙的一点。可以在服务器上启动 headless 服务：

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

然后在本地或其他设备连接：

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

这意味着你可以用轻薄本甚至 iPad 操控后台的高性能服务器进行编译和测试。

Web 界面

如果不习惯终端，也可以启动 Web 版本：

opencode web

会话管理

# 列出所有会话
opencode session list

# 导出会话（JSON 文件或分享链接）
opencode export <sessionID>
opencode import session.json
opencode import https://opncd.ai/s/abc123

统计消耗

查看 Token 用量和费用：

opencode stats
opencode stats --days 7 --models

GitHub 集成

在仓库内安装可直接作为 GitHub Agent 使用：

opencode github install

这将设置 Actions 工作流，自动处理 Issue 和 PR。

MCP Server 集成

MCP（Model Context Protocol）允许扩展智能体的工具能力。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

实用示例

• Context7：搜索技术文档。
• Grep by Vercel：搜索 GitHub 代码库。

Agent Skills：自定义技能

Skills 允许定义可复用的工作流，让 Agent 在特定场景下自动加载规范。

创建 Skill

在项目 .opencode/skill/<name>/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.

权限控制

在 opencode.json 中控制哪些 Skill 可用，支持通配符：

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

OpenCode Zen

如果不想自行配置 API，官方提供 Zen 服务。精选针对编程优化的模型，充值后按量付费，价格透明且支持余额自动充值和消费限额设置。

常用命令速查

总结

OpenCode 是目前体验较好的开源编程智能体之一。相比闭源竞品，它在模型选择的灵活性、开源可控性以及 TUI 交互体验上优势明显。虽然桌面应用尚在 Beta 阶段，但其完整的 MCP 生态和 Skills 功能已能满足大多数开发者的进阶需求。

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

官网：https://opencode.ai

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