如果你最近在终端里看到同事敲了一行 opencode ,命令行瞬间变成一整个AI编程工作台——没错,这就是今天要聊的 OpenCode。它是一个跑在终端里的开源AI编程助手,定位和 Claude Code 很像,但核心区别在于它不绑定任何一家模型厂商,OpenAI、Anthropic、Google、本地 Ollama 随便接。这篇文章我不打算念官方 README,而是想把我从安装、配模型、折腾 Skills、接入 VSCode/JetBrains,到真正让它替我改 Bug 的完整过程写一遍,中间踩过的坑和排查思路也一并放出来。
这篇文章适合三类人:一是用腻了编辑器里对话面板、想直接在项目目录里干活的人;二是本地有 Ollama、想用开源模型离线跑的人;三是团队想统一一套终端AI工具、避免各用各的插件越搞越碎的人。如果你只是偶尔问几句代码片段,可能用不太上它,因为它的核心价值在于“长时间驻留在项目里,把读代码、改文件、跑命令、看报错这个闭环串起来”。
1. OpenCode到底是什么:它解决的痛点和它的定位
1.1 为什么我会从IDE插件换到终端AI助手
我最早用AI编程助手是从IDE里的对话侧边栏开始的,写接口、问语法确实方便,但用久了就发现一个很别扭的问题:上下文是割裂的。你在这边跟助手聊了三轮,它理解的是编辑器里打开的那几个文件,可真正决定Bug原因的,往往是日志、运行参数、甚至另一个服务返回的数据。IDE插件很难把这些全部喂给模型,所以它经常给出“看起来合理、实际跑不通”的建议。
后来换到终端类AI助手,才算把“让AI真正干活”这件事跑通。终端里天然就能执行命令、读文件、跑测试、看报错,AI可以直接在项目里做诊断,而不是靠猜。OpenCode就是这类工具里我用下来比较顺手的一个:启动快,交互直接,模型随便换,能干到哪一步完全取决于你怎么给它下指令。
1.2 OpenCode跟Claude Code这类工具比,特点在哪
先说个对比,方便你判断它适不适合自己:
| 维度 | OpenCode | Claude Code | Cursor |
|---|---|---|---|
| 模型绑定 | 完全开放,任何OpenAI兼容API都能接 | 基本绑定Anthropic | 偏自家订阅+模型代理 |
| 界面形态 | 纯终端TUI,另有桌面版和IDE插件 | 纯终端 | 整包IDE |
| 开源情况 | 开源,可自审可二开 | 闭源 | 闭源 |
| Skills机制 | 支持,可安装社区Skills | 有类似能力 | 无明确Skills体系 |
| 本地模型 | 通过Ollama接入很方便 | 支持但不如OpenCode灵活 | 支持有限 |
我选它的核心原因有三个:一是开源,代码可以自己审,数据传到哪、配置存哪都透明;二是模型不锁死,哪天某个模型涨价了或者变慢了,换一个provider就行,不用换工具;三是团队好统一,配置文件和Skills都可以入库,新人拉下来一条命令就能用。
2. 安装OpenCode:覆盖macOS/Linux/Windows的完整流程
2.1 macOS和Linux的一键安装与包管理器
macOS和Linux最省事的是官方一键安装脚本:
curl -fsSL https://opencode.ai/install | bash
装完默认会放到 ~/.opencode/bin 下,如果你的 shell 没有自动把路径加进 PATH,就手动加一下。我用的 zsh,在 ~/.zshrc 里加了这一行:
export PATH="$HOME/.opencode/bin:$PATH"
然后 source ~/.zshrc ,再跑 opencode --version 验证。Linux 上如果你用的是 Debian/Ubuntu 或 CentOS 这类发行版,同样用上面的脚本就行,没有额外的系统依赖,这个比较省心。
如果你偏好包管理器,Homebrew 用户也可以直接装:
287



被折叠的 条评论
为什么被折叠?



