现在越来越多团队希望把 AI 直接搬进日常编码流程,而不是只在网页里聊天。但很多“编程助手”要么绑定特定厂商、要么只给建议不落地,真正能读写文件、跑命令、连续完成任务的本地智能体并不多。开发者想要的是一个可以装在终端里、随开随用、且数据留在自己机器上的编码伙伴。

OpenCode 正是为此而生:一个开源的命令行编程智能体(coding agent)。它本身不绑定任何模型,你可以用自己的 API Key 或本地模型驱动它。它把“让 AI 写代码”这件事从玩具变成了可嵌入工作流的真实工具。

项目基本信息

信息项详情
项目名称OpenCode
GitHub地址https://github.com/anomalyco/opencode
项目描述开源的命令行编程智能体,可接入任意模型
作者anomalyco
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-25

一、项目介绍

OpenCode 是一个在终端中运行的编程智能体,能读取和编辑文件、执行命令、维护多轮上下文,并支持可插拔的模型层。它提供命令行、TUI 以及桌面端(Beta)多种界面,核心定位是“本地优先”——你的对话与代码上下文都留在自己机器上,而不是上传到某个云端服务。

二、核心优势

  • 模型无关:OpenAI、Anthropic、Google 以及本地 Ollama 等都能接入,不被厂商锁定。
  • 本地优先:对话与上下文留在本地,隐私可控。
  • 多界面:命令行、TUI、桌面端(Beta)三选一。
  • 开源 MIT:可自托管、可改写、可审计。

三、适用场景

  • 日常代码生成、重构与补全。
  • 在私有代码库中做检索、理解与批量修改。
  • 团队统一接入自有模型,控制成本与合规边界。

四、安装教程

# 一键安装(推荐)
curl -fsSL https://opencode.ai/v2/install | bash

# 或走包管理器
npm i -g @opencode/cli@latest      # Node 环境
brew install anomalyco/tap/opencode-v2 # macOS / Linux
mise use -g opencode               # 任意 OS

常见报错:旧版本(0.1.x 之前)需先卸载再装;Node 版本过低会报 engine 错误,建议 Node 20+。桌面端在 macOS 用 brew install --cask opencode-desktop。

五、使用示例

启动并进入交互式会话:

opencode

在会话里直接描述任务,例如让它在当前仓库新增一个 CLI 子命令,它会自行读取相关文件、编辑并运行测试。示意输出:

> 给项目加一个 opencode lint 子命令
✓ 已读取 src/cli.ts
✓ 已创建 src/commands/lint.ts
✓ 运行测试:32 passed

(实际输出取决于你的代码库与所接模型。)

六、常见问题

  • Q:能完全离线用吗? A:接本地模型(如 Ollama)时可以;纯云端模型需要网络。
  • Q:和 Cursor / Copilot 有什么区别? A:OpenCode 是开源、模型无关的终端智能体,不锁定厂商。
  • Q:桌面端稳定吗? A:当前标注为 Beta,命令行版本更稳定。

七、总结

如果你想要一个不被厂商绑定、能真正在终端里干活的编程智能体,OpenCode 值得一试。MIT 协议、跨平台、模型自由切换,是从“AI 聊天”走向“AI 干活”的务实选择。