Back to Blog

OpenCode：Claude Code 的最佳开源平替

2026-04-26T18:00:00+08:00
OpenCode AI Agent Claude Code 开源 编程工具

我用 Claude Code 大半年了，体验确实好，但它有一个绕不过去的问题——你被锁死在 Anthropic 的生态里。只能用 Claude 模型，只能走 Anthropic 的 API，代码上下文必须过他们的服务器。每月 $20 起步，重度使用 Max 方案 $200/月。对于有数据合规要求的企业，这直接一票否决。

有没有一个工具，能提供接近 Claude Code 的体验，同时给你模型自由、数据主权、成本控制？试了一圈之后，我的答案是 OpenCode。

150K GitHub 星标，850+ 贡献者，650 万月活开发者。MIT 开源，TypeScript 编写，75+ 模型 Provider。这不是一个"能用"的开源玩具，它已经是一个成熟的生产力工具。

本文提纲

  1. OpenCode 是什么
  2. 和 Claude Code 的正面对比
  3. 全平台安装指南
  4. 快速上手：5 分钟跑起来
  5. TUI 界面全解析
  6. 核心架构：为什么它能打
  7. MCP 和 Plugin 扩展

OpenCode 是什么

OpenCode 是 anomalyco 团队开源的 AI 编程 Agent。和 Claude Code 一样，它能直接在终端里读代码、写代码、执行命令、管理项目。不同的是，它不绑定任何一个 LLM Provider。

几个关键数字：

  • 150K GitHub Stars（截至 2026 年 4 月，还在涨）
  • 850+ Contributors
  • 11,000+ Commits
  • 6.5M 月活开发者
  • 75+ LLM Provider 支持
  • MIT 开源协议

OpenCode 提供三种使用方式：

  1. TUI（Terminal UI）——默认模式，在终端里用 Bubble Tea 框架构建的全功能界面。不是 Web 套壳，是原生终端应用。
  2. Desktop App——桌面应用（Beta），macOS / Windows / Linux 全平台支持。
  3. IDE 扩展——VS Code 和 Cursor 都有官方扩展。

你可以把它理解为：Claude Code 的能力 + Android 式的开放自由度。

和 Claude Code 的正面对比

直接看表：

维度 Claude Code OpenCode
开源 否 MIT 协议
价格 $20-200/月 免费（自带 API Key）
模型 仅 Claude 75+ Provider
本地模型 不支持 Ollama 直连
数据出境 必须 可选
TUI 界面 有 有（Bubble Tea）
桌面应用 无 Beta（全平台）
LSP 集成 有 有（自动加载）
MCP 支持 有 有
插件系统 Skills（官方生态） TypeScript 插件 + npm
多会话 有 有（支持并行）
Client/Server 架构 无 有
IDE 集成 VS Code VS Code + Cursor

OpenCode 在三个关键维度上领先：

模型自由度。 Claude Code 只能用 Claude。OpenCode 可以在同一个项目里，用 Claude Opus 做架构设计，切 GPT-5.4 做代码生成，再切本地 Qwen 3.6 处理敏感代码。简单任务用便宜模型，复杂任务用贵模型，API 费用能省 60-70%。

数据主权。 用 Ollama 跑本地模型，代码永远不出你的机器。Claude Code 做不到这一点。

零供应商锁定。 Claude Code 的 Skills 生态是 Anthropic 的护城河。OpenCode 的插件是标准 TypeScript，不绑定任何模型或平台。

Claude Code 赢在开箱即用的丝滑体验——毕竟 Anthropic 自己的模型配自己的工具，优化到位。但如果你想要控制权和灵活性，OpenCode 是更好的选择。

打个比方：Claude Code 是 iPhone，体验好但锁定生态。OpenCode 是 Android，开放、自由、选择权在你。

全平台安装指南

OpenCode 的安装覆盖了所有主流方式，5 分钟内搞定：

macOS：

# 推荐：Homebrew（始终最新）
brew install anomalyco/tap/opencode

# 或官方 formula（更新稍慢）
brew install opencode

# 或一键脚本
curl -fsSL https://opencode.ai/install | bash

Linux：

# 一键脚本
curl -fsSL https://opencode.ai/install | bash

# Arch Linux
sudo pacman -S opencode          # Stable
paru -S opencode-bin             # AUR Latest

# Nix
nix run nixpkgs#opencode

Windows：

# Scoop
scoop install opencode

# Chocolatey
choco install opencode

跨平台通用：

# npm / bun / pnpm / yarn
npm i -g opencode-ai@latest

# mise
mise use -g opencode

# Docker
docker run -it anomalyco/opencode

桌面应用（Beta）：

# macOS
brew install --cask opencode-desktop

# Windows
scoop bucket add extras
scoop install extras/opencode-desktop

或者直接去 GitHub Releases 下载对应平台的安装包。

快速上手：5 分钟跑起来

安装完成后，进入你的项目目录：

cd my-project
opencode

首次启动，OpenCode 会做三件事：

  1. 检测项目结构（语言、框架、依赖）
  2. 初始化 .opencode/ 目录（配置和会话数据）
  3. 提示你选择模型 Provider

配置 API Key 最简单的方式是环境变量：

# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI
export OPENAI_API_KEY="sk-..."

# 或者用 GitHub Copilot 登录（免费额度）
# OpenCode 支持直接用你的 GitHub Copilot 订阅

也可以用配置文件 opencode.json，放在项目根目录：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "api_key": "env:ANTHROPIC_API_KEY"
    },
    "openai": {
      "api_key": "env:OPENAI_API_KEY"
    },
    "ollama": {
      "api_url": "http://localhost:11434/v1"
    }
  },
  "model": {
    "default": "anthropic/claude-sonnet-4",
    "fast": "openai/gpt-4o-mini"
  }
}

配置好之后，TUI 界面直接打开，开始对话。就这么简单。

一个实用技巧：如果你有 GitHub Copilot 或 ChatGPT Plus/Pro 订阅，OpenCode 可以直接用这些账号，不需要额外付 API 费用。登录即用。

TUI 界面全解析

OpenCode 的 TUI 是由 neovim 用户和 terminal.shop 的创造者设计的——终端体验是他们最在意的事。

Session 管理：

  • 每个对话是一个 Session，自动保存
  • 支持多个并行 Session，互不干扰
  • 可以分享 Session 链接给同事（方便协作和调试）

模型切换：

在 TUI 里输入 /model，随时切换当前使用的模型。比如：

  • 复杂重构 → 切到 Claude Opus
  • 快速问答 → 切到 GPT-4o-mini
  • 敏感代码 → 切到本地 Ollama

同一个会话，不同任务用不同模型。

Agent 切换：

按 Tab 键在两个内置 Agent 之间切换：

  • build——默认 Agent，完整读写权限，用于开发
  • plan——只读 Agent，用于分析和探索代码库。不会修改任何文件，执行 bash 前会先问你

plan Agent 特别适合这些场景：接手一个不熟悉的项目、分析代码结构、规划重构方案。

常用快捷键：

快捷键 功能
Tab 切换 Agent（build/plan）
Ctrl+C 中断当前生成
Ctrl+L 清屏
Escape 取消输入
/model 切换模型
/session 管理会话
@general 调用通用子 Agent

核心架构：为什么它能打

OpenCode 的架构设计是它和 Claude Code 拉开差距的地方。

Client/Server 架构。

OpenCode 把后端（Server）和前端（Client）分离开来。TUI 只是其中一个 Client，桌面应用是另一个 Client，IDE 扩展又是一个 Client，甚至你可以在手机上远程驱动本地运行的 OpenCode Server。

这意味着什么？你可以在办公电脑上跑 OpenCode Server，回家后用手机或笔记本连上去继续工作。Claude Code 目前没有这种架构。

Provider 无关。

OpenCode 通过 Models.dev 接入 75+ LLM Provider。包括 Anthropic、OpenAI、Google、DeepSeek、Mistral、Azure、Bedrock、Ollama……你能想到的基本都有。配置一个 Provider 就是一个 API Key 的事。

22 个内置工具。

OpenCode 内置了一套完整的工具链，让 AI 可以直接操作你的代码库：

工具 功能
read 读取文件和目录
write 创建和编辑文件
bash 执行 shell 命令
glob 按模式搜索文件
grep 搜索文件内容
fetch HTTP 请求
patch 应用 unified diff
todoread/todowrite 任务列表管理

更有杀伤力的是 LSP 集成。OpenCode 自动连接项目的 Language Server，AI 能看到类型信息、函数签名、导入路径和诊断结果——不只是原始文本。TypeScript、Python、Go、Rust、Java……只要你的语言有 LSP Server，OpenCode 就能用。

MCP 和 Plugin 扩展

MCP（Model Context Protocol）支持：

配置方式和 Claude Code 类似，在 opencode.json 里添加：

{
  "mcp": {
    "github": {
      "type": "local",
      "command": ["npx", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "env:GITHUB_TOKEN"
      }
    }
  }
}

MCP 工具自动出现在 AI 的工具列表里，和内置工具地位相同。GitHub、PostgreSQL、文件系统、自定义 MCP Server 都可以接入。

一个小提醒：每个 MCP Server 的工具定义会消耗上下文 Token。GitHub MCP Server 一个就吃不少 Token，按需开启。

Plugin 系统：

OpenCode 的插件用标准 TypeScript 或 JavaScript 编写，25+ 生命周期钩子。两种安装方式：

  • 本地文件——放到 .opencode/plugins/（项目级）或 ~/.config/opencode/plugins/（全局）
  • npm 包——在 opencode.json 的 plugin 数组里添加包名

自定义工具更简单——放到 .opencode/tool/ 目录，文件名就是工具名，AI 直接调用。

对比 Claude Code 的 Skills 系统：OpenCode 的插件是标准 TypeScript，不绑定任何特定模型或平台。你的插件在 Claude、GPT、Gemini 上都能用。

对企业团队来说，还有一个关键能力：把 AGENTS.md 提交到版本控制，团队所有成员的 AI 行为保持一致。配合 Server 模式部署共享 OpenCode 服务器，可以集中管理模型路由、成本控制和审计追踪。

如果你一直在用 Claude Code 但觉得被锁定不舒服，或者你想要更灵活的模型选择和成本控制，试试 OpenCode：

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

跑一下，你就知道差距有多小——甚至在某些方面，它已经走在了前面。

作者: itech001
来源: 公众号：AI人工智能时代
主页: https://www.theaiera.cn（每日分享最前沿的AI新闻和技术）

关注公众号，获取更多 AI 技术干货！

Enjoyed this article? Share it with others!