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

也可在 IDE 中直接安装插件。

快速开始

进入项目目录，运行 opencode 启动：

cd /path/to/project
opencode

首次使用建议先运行 /init 命令，让 OpenCode 分析项目，自动生成 AGENTS.md 文件：

/init

该文件帮助 OpenCode 理解项目结构和编码规范，建议 commit 到 Git。

两种内置 Agent

OpenCode 内置两种 Agent，用 Tab 键切换：

1. Build 模式（默认）：全权限，可读写文件、执行命令
2. Plan 模式：只读模式，仅分析和规划，不修改代码

Plan 模式适合：

• 探索不熟悉代码库
• 先规划再动手的工作流程
• 让 AI 出方案但不执行

还有 @general 子智能体，可处理复杂搜索和多步骤任务。

配置模型

OpenCode 支持多种模型提供商，包括：

• Anthropic（Claude）
• OpenAI（GPT）
• DeepSeek
• Google Vertex AI
• Ollama（本地模型）
• LM Studio
• llama.cpp
• Groq
• Together AI
• Fireworks AI
• OpenRouter

配置 API Key 直接在界面运行：

/connect

选择 provider 输入 API Key。Key 保存在 ~/.local/share/opencode/auth.json。

CLI 命令详解

非交互模式：脚本自动化

命令行直接提问：

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

Web 界面

opencode web

自动打开浏览器操作。

会话管理

# 列出所有会话
opencode session list

# 导出会话
opencode export <sessionID>

# 导入会话
opencode import session.json
opencode import https://opencode.ai/s/abc123

统计消耗

opencode stats
opencode stats --days 7 --models

GitHub 集成

在仓库里安装：

opencode github install

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

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

实用 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"}}}

MCP 管理命令

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

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

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

# 登出
opencode mcp logout my-oauth-server

Agent 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/<name>/SKILL.md
• 全局级：~/.config/opencode/skill/<name>/SKILL.md
• Claude 兼容：.claude/skills/<name>/SKILL.md

权限控制

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

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

OpenCode Zen：付费服务

官方提供 OpenCode Zen 服务，精选针对编程智能体优化过的模型。充值按用量付费，无需自行申请 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 那种原生集成的流畅度
• 入门需自行配置 API Key

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

官网：https://opencode.ai

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