OpenCode：145K星的开源AI编程Agent，Claude Code的最佳平替

你是不是也受够了？

写代码写到凌晨两点，debug一个接口返回值的问题翻了三天日志还没头绪；接手别人的项目，看着满屏的utils.js和helpers.ts完全不知道从哪看起；每次想用AI辅助写代码，不是被Claude Code的订阅价格劝退，就是怕代码上传到别人服务器不安全。如果你有这些困惑，今天介绍的OpenCode可能会让你眼前一亮。

OpenCode是什么？

OpenCode是一个完全开源的AI编程Agent，在终端里就能跑，号称Claude Code的开源平替。目前在GitHub上已经收获了145K+的星标，日增525星，是目前最火的开源编程Agent之一。它支持75+种LLM提供商，内置两种工作模式（开发+分析），而且你可以在终端里直接用它聊天、写代码、搜索代码库——甚至还有桌面版。

核心功能一览

• 全开源、不锁供应商：代码完全开源，不绑定任何大模型厂商。你可以用OpenAI、Anthropic、Google，也可以用本地模型，甚至通过代理服务接入国产模型
• 两种内置Agent模式：build模式拥有完整权限，能直接改代码、跑命令；plan模式是只读的，默认拒绝修改文件，运行bash命令前还会先问你——适合分析代码、做方案规划
• 两个子Agent：general子Agent处理复杂搜索和多步任务，可以并行执行多项工作；explore子Agent快速搜索代码库，找文件、找关键词、回答代码结构问题
• 内置LSP支持：原生集成语言服务协议，代码补全、跳转定义、查引用这些IDE级别的功能在终端里也能用
• 终端原生TUI界面：由Neovim爱好者和terminal.shop团队打造，在终端里就能获得接近IDE的交互体验
• 客户端/服务器架构：可以在服务器上跑OpenCode，从手机App远程驱动，TUI前端只是诸多客户端之一
• 桌面版应用（Beta）：如果你不习惯终端，还有macOS、Windows、Linux桌面版可用
• 一键初始化：运行/init命令，自动分析项目并生成AGENTS.md文件，帮助AI更好地理解你的代码结构
• @文件搜索：在对话中输入@可以模糊搜索项目中的文件，直接引用到上下文中
• 多平台安装支持：npm、brew、scoop、choco、pacman、Docker……几乎你能想到的包管理器都支持

安装步骤（手把手教程）

macOS安装

推荐方式（Homebrew Tap，始终最新版）：

brew install anomalyco/tap/opencode

如果你更习惯用官方Homebrew formula（更新频率稍低）：

brew install opencode

用npm安装：

npm install -g opencode-ai@latest

一键安装脚本（最快）：

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

Linux安装

Debian/Ubuntu等（npm方式）：

npm install -g opencode-ai@latest

Arch Linux（官方仓库）：

sudo pacman -S opencode

Arch Linux（AUR最新版）：

paru -S opencode-bin

通用一键安装：

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

Docker方式：

docker run -it --rm ghcr.io/anomalyco/opencode

Nix方式：

nix run nixpkgs#opencode
# 或者用最新dev分支：
nix run github:anomalyco/opencode

Windows安装

推荐方式（WSL，性能和兼容性最好）：

在WSL终端中安装后使用体验最佳。先安装WSL，然后按上面的Linux方式安装即可。

Chocolatey：

choco install opencode

Scoop：

scoop install opencode

npm：

npm install -g opencode-ai@latest

Mise：

mise use -g opencode

桌面版安装

如果你不习惯终端，OpenCode也提供桌面版（目前Beta阶段）：

macOS：

brew install --cask opencode-desktop

或从发布页下载：

• Apple Silicon芯片：opencode-desktop-darwin-aarch64.dmg
• Intel芯片：opencode-desktop-darwin-x64.dmg

Windows：

scoop bucket add extras
scoop install extras/opencode-desktop

或下载opencode-desktop-windows-x64.exe

Linux：

提供.deb、.rpm和AppImage格式，从发布页下载。

⚠️ 如果你之前安装过0.1.x版本的OpenCode，请先卸载旧版本再安装新版。

安装目录说明

安装脚本会按照以下优先级选择安装路径：

1. $OPENCODEINSTALLDIR — 自定义安装目录
2. $XDGBINDIR — 符合XDG标准的路径
3. $HOME/bin — 用户二进制目录（如果存在）
4. $HOME/.opencode/bin — 默认备用路径

示例：

OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash

使用方法

1. 基础用法：配置和启动

安装完成后，首先要配置你的AI模型提供方。进入你的项目目录，然后启动OpenCode：

cd /path/to/your/project
opencode

首次使用，你需要配置API密钥。在TUI界面中输入：

/connect

然后选择你想要的模型提供方。OpenCode官方推荐使用OpenCode Zen——这是团队精心挑选和测试过的模型列表，省得自己研究哪个模型好用。

如果你习惯用环境变量的方式，也可以直接设置：

export ANTHROPIC_API_KEY=你的密钥     # Claude
export OPENAI_API_KEY=你的密钥         # OpenAI
export GOOGLE_API_KEY=你的密钥         # Gemini

2. 初始化项目

进入项目后，运行：

/init

OpenCode会自动分析你的项目结构，生成一个AGENTS.md文件。这个文件帮助Agent理解项目的编码风格、目录结构和常用模式。建议把这个文件提交到Git，这样整个团队都能受益。

3. 两种模式切换

在OpenCode的TUI界面中，按Tab键可以在两种Agent之间切换：

• build模式：默认模式，拥有完整权限，可以修改文件、执行bash命令、创建新文件——适合让AI直接帮你开发
• plan模式：只读模式，默认拒绝文件修改，执行bash命令前会征得你的同意——适合让AI做代码审查、方案分析

此外，你还可以在消息中使用@general来调用通用子Agent处理复杂多步任务，或用@符号模糊搜索项目文件并引用。

4. 进阶用法：代码分析

在plan模式下，你可以直接问代码相关的问题：

这个项目的认证逻辑是怎么实现的？
@src/auth/login.ts 这段代码有什么潜在问题？

@键可以模糊搜索并引用文件到对话中，非常方便。

5. 进阶用法：自定义Agent

在项目的opencode.json中，你可以自定义Agent的行为、模型选择和工具权限。例如给plan模式配置不同的模型，或者创建自己的专属Agent来处理特定任务。

6. 进阶用法：远程驱动

得益于客户端/服务器架构，你可以在开发机上运行OpenCode Server，然后从手机或平板远程连接操作——比如在地铁上用手机给家里的开发机下指令，到家就能看到代码已经改好了。

实际场景举例

跟同类工具对比

为什么选OpenCode？

1. 真正的自由：不限模型厂商，不限部署方式，代码全部透明可审计
2. 安全性最高：支持本地模型，代码完全不出网，企业合规首选
3. plan模式是杀手锏：做代码审查和分析时不怕AI乱动代码，其他工具都没有这个功能
4. 可持续性：大模型会持续迭代、价格会持续下降，供应商中立意味着你不会被锁定
5. 终端党的最爱：由Neovim和terminal.shop团队打造，TUI体验远超一般CLI工具

小结

OpenCode凭借145K+星的开源透明度、75+模型供应商支持和独特的build/plan双Agent模式，成为Claude Code最强开源替代。如果你厌倦了被单一厂商锁定，或者想在终端里获得IDE级别的AI编程体验，OpenCode值得一试。

👉 项目地址：https://github.com/anomalyco/opencode 👉 官网：https://opencode.ai 👉 文档：https://opencode.ai/docs