在 AI 辅助编程工具层出不穷的今天，我们见识过 GitHub Copilot 的补全能力，也体验过 Claude Code 的强大。但如果你正在寻找一款**完全开源、不绑定特定模型提供商、且专注于终端体验（TUI）**的编程 Agent，那么 OpenCode 绝对值得你一试。
本文将带你了解 OpenCode 的核心特色，并手把手教你如何安装和使用这款强大的开源编程助手。
什么是 OpenCode？
OpenCode（项目地址：github.com/anomalyco/opencode）是一个开源的 AI 编程 Agent。它的定位与 Claude Code 非常相似，但有几个关键的区别，使其成为开发者手中的利器：
完全开源：你拥有完全的控制权，代码透明。
模型中立（Provider Agnostic）：虽然官方推荐其 OpenCode Zen 服务，但你完全可以使用 OpenAI、Claude、Google Gemini 甚至本地运行的 LLM 模型。随着模型价格的下降和能力的提升，这种灵活性至关重要。
极致的终端体验（TUI）：由 Neovim 用户和 terminal.shop 的创作者构建，它为终端用户提供了极致的交互体验。
开箱即用的 LSP 支持：具备语言服务器协议支持，理解代码更精准。
1. 安装指南
OpenCode 提供了多种安装方式，覆盖了 macOS、Linux and Windows。
方法一：一键脚本（macOS / Linux 推荐）
这是最快的安装方式：
Bash
curl -fsSL https://opencode.ai/install | bash
方法二：使用包管理器
如果你习惯使用包管理器，可以选择对应平台的命令：
macOS / Linux (Homebrew):
Bash
# 推荐使用官方 Tap 以获取最新更新 brew install anomalyco/tap/opencodeWindows (Scoop):
PowerShell
scoop bucket add extras scoop install extras/opencodeWindows (Choco):
PowerShell
choco install opencodeNPM / Node.js:
Bash
npm i -g opencode-ai@latest # 或者使用 bun/pnpm/yarnArch Linux:
Bash
paru -S opencode-bin
桌面版客户端（Desktop App）
如果你不喜欢在终端中操作，OpenCode 还提供了处于 Beta 阶段的桌面端应用，支持 macOS、Windows 和 Linux。你可以直接从其 GitHub Releases 页面下载。
2. 核心概念：双 Agent 模式
OpenCode 的强大之处在于它内置了两种不同角色的 Agent，你可以根据当前的任务需求，通过 Tab 键快速切换。
🛠️ Build Agent (构建模式)
默认模式。
权限：拥有完全的访问权限，可以读写文件、运行命令。
适用场景：日常开发、写代码、修复 Bug、重构等需要实际修改项目的任务。
📋 Plan Agent (规划模式)
只读模式。
权限：默认禁止文件编辑，运行 Bash 命令前会询问权限。
适用场景：阅读陌生代码库、分析问题、制定开发计划、探索代码结构。它就像一个安全的研究员，只看不乱动。
此外，还有一个 @general 子 Agent，用于处理复杂的搜索和多步骤任务。
3. 快速上手使用
安装完成后，在你的项目根目录下运行以下命令即可启动：
Bash
opencode
初始化与配置
初次运行时，OpenCode 可能会引导你进行简单的配置（如选择模型提供商）。由于它是模型中立的，你可以配置自己的 API Key（如 OpenAI Key 或 Anthropic Key），也可以使用 OpenCode 提供的服务。
交互演示
启动后，你会进入一个交互式的终端界面。
提问与指令：直接用自然语言输入你的需求，例如：“分析一下 src 目录下的代码结构” 或 “给登录页面增加一个重置密码的按钮”。
切换模式：按下
Tab键，观察界面指示器的变化，在 Build 和 Plan 之间切换。建议先用 Plan 模式分析思路，再切到 Build 模式执行代码。文件编辑：当 OpenCode 提议修改代码时，它会展示 Diff（差异对比）。确认无误后，它会自动应用更改。
4. 进阶技巧
上下文感知：OpenCode 能够读取你当前项目的文件。在提问时，不必每次都复制粘贴代码，直接引用文件名或函数名，它通常能自动找到相关上下文。
LSP 加持：利用其内置的 LSP 支持，它可以更准确地进行代码跳转和引用查找，减少“幻觉”代码的产生。
结合本地模型：对于注重隐私的开发者，尝试配置本地 LLM（如通过 Ollama），虽然速度或能力可能不及顶尖云端模型，但能实现完全离线的 AI 编程。
总结
OpenCode 是目前开源界最令人兴奋的 AI 编程工具之一。它不仅免费开源，而且在设计理念上非常贴合开发者的真实工作流。无论你是想寻找 Claude Code 的免费替代品，还是想体验一个真正懂终端的 AI 助手，OpenCode 都值得你安装体验。
项目地址：https://github.com/anomalyco/opencode