上周帮一个做前端的朋友试了台新电脑,他装了一堆插件——Copilot要$10/月,Cursor要$20/月,Windsurf更贵。

我跟他说:你花这些钱干啥?有个免费的工具,功能比这些都强。

他不信。结果装上之后,他沉默了。

今天就来聊聊这个工具——OpenCode

🤔 OpenCode 是啥?

一句话:终端里的AI程序员助手,能读懂你的代码、改文件、跑命令、写测试。

你可能听过 Claude Code——OpenAI 的竞品叫 Codex。而 OpenCode 是这三个里面唯一开源的,GitHub 上狂揽 6万+ Star

🔥 为什么它比付费工具香?

免费。开源。无广告。支持75+模型。

没错,它不需要你绑定信用卡,不需要你付费订阅,直接用。

来看看它的核心优势:

模型自由切换 —— Claude、GPT、Gemini、DeepSeek、Ollama本地模型,想用哪个用哪个

终端原生 —— 不装插件不装IDE,终端里敲一行命令就能用

真正的AI编程 —— 不是代码补全,是直接帮你写功能、改bug、跑测试

Web界面可选 —— 不习惯终端?跑个Web UI在浏览器里用

免费模型内置 —— 不配API Key也能用,内置免费模型开箱即用

📦 三步安装,5分钟搞定

说实话,安装过程简单到我都觉得不好意思写教程。

第一步:安装 Node.js(如果有的话跳过)

nodejs.org 下载 LTS 版本,一路下一步就行。

Mac 用户也可以用 brew:

brew install node

第二步:安装 OpenCode

npm i -g opencode-ai@latest

一行命令,等个十几秒就装好了。

第三步:配置模型

装好后跑一下:

opencode auth login

它会引导你选择模型供应商(Anthropic、OpenAI、OpenRouter等),按提示操作就行。

或者你懒得配——直接用内置免费模型:

opencode run '你好,请回复OK' --model opencode/big-pickle

没配任何API Key,照样能跑。你猜怎么着?这几个免费模型还挺能打的。

💻 核心用法:三种模式随你选

模式一:一句话搞定(推荐新手)

这是最简单的用法。进到你的项目目录,一行命令:

cd your-project
opencode run '给用户注册接口加上重试逻辑,并写好测试'

然后你就可以去倒杯咖啡了。OpenCode 会自动:

1️⃣ 读取你的项目代码
2️⃣ 理解需求
3️⃣ 修改文件
4️⃣ 跑测试验证

回来一看,活干完了。

模式二:交互式TUI(进阶玩家)

不想一句话结束?想跟AI来回讨论?

opencode --model opencode/big-pickle

终端会进入一个交互界面,你可以像聊天一样跟AI讨论需求。

常用快捷键:

按键 功能
Tab 切换 Agent(build/plan)
Ctrl+P 命令面板
Ctrl+X M 切换模型
Ctrl+C 退出

模式三:Web界面(懒人福音)

终端看着头晕?开个Web界面:

opencode serve --hostname 0.0.0.0 --port 9791

然后浏览器打开 http://localhost:9791,就像用网页版ChatGPT一样写代码。

🎯 真实场景:它能帮你干啥?

说个我自己的经历。

上周写一个Python爬虫项目,卡在一个BUG上整整两小时。试了各种方法都不行。

后来跑了一句:

opencode run '爬虫在第3页报412错误,帮我分析原因并修复'

30秒后,它告诉我:B站搜索API需要特定的UA头和Referer,它帮我加上了。

我两小时没解决的问题,它30秒搞定。

这不是个例。以下是它最擅长的场景:

🔧 修BUG —— 描述问题,它帮你定位+修复
🏗️ 写功能 —— 告诉它需求,它帮你实现
🧪 写测试 —— “给这个函数写单元测试”,一步到位
📝 代码审查 —— “review这段代码的安全问题”
🔄 重构代码 —— “把这段函数重构成更清晰的结构”

⚔️ 和付费工具比,差在哪?

我知道你在想什么:免费的能有付费的好用?

先看对比:

方案 费用 自建模型 自动化/脚本 大型项目
OpenCode 免费 ✅ 任意API ✅ 极强 ⭐⭐⭐
Cursor $20/月 ❌ 仅自家 ❌ 弱 ⭐⭐⭐⭐⭐
Copilot $10/月 ❌ 仅GitHub ❌ 弱 ⭐⭐⭐⭐
Claude Code API按量 ❌ 仅Anthropic ✅ 强 ⭐⭐⭐

看到了吧?OpenCode 的杀手锏不是”便宜”,而是”自由”。

它能接你自己的 NewAPI、Ollama本地模型、任何OpenAI兼容的接口。在内网NAS上跑也没问题。

说实话,对于大部分中小型项目(1万行代码以内),OpenCode 完全够用。只有超大型项目(10万行+)才需要 Cursor 那种强索引能力。

🚀 进阶玩法:5个提效技巧

用了一段时间后,我总结了几个让效率翻倍的技巧:

技巧1:喂文件给它

不确定AI能不能看到相关文件?手动指定:

opencode run '优化这个函数的性能' -f src/utils.py -f tests/test_utils.py

-f 把相关文件喂给它,准确率直接拉满。

技巧2:显示思考过程

想看AI是怎么想的?加 --thinking

opencode run '重构这段代码' --thinking

会显示AI的推理过程,帮你理解它为什么这么改。

技巧3:强制指定模型

日常用免费模型,复杂任务切付费模型:

# 日常任务:免费模型
opencode run '写个工具函数' --model opencode/big-pickle

# 复杂推理:Claude
opencode run '分析这段架构的性能瓶颈' --model openrouter/anthropic/claude-sonnet-4

技巧4:创建项目规则

在项目根目录放一个 AGENTS.md 文件,写上你的编码规范:

# AGENTS.md
- 使用 Python 3.11+
- 遵循 PEP8 规范
- 函数必须写 docstring
- 测试覆盖率 > 80%

以后每次OpenCode在这个项目里工作,都会自动遵守这些规则。

技巧5:Web UI + code-server 分屏

最爽的工作流:

左侧开 code-server 看代码、审阅diff
右侧开 OpenCode Web UI 专注AI编码
底栏终端跑 pytest / git

三屏联动,效率拉满。

❓ 常见问题

Q:安装报错怎么办?

最常见的原因是 Node.js 版本太低。确保 Node.js ≥ 18(推荐22 LTS)。跑 node -v 检查一下。

Q:免费模型够用吗?

日常写代码、改BUG、写测试完全够。但复杂架构分析还是建议用 Claude Sonnet。免费模型的推理能力确实差一些。

Q:能在 Windows 上用吗?

能。Windows、Mac、Linux 都支持。Windows 建议用 WSL2,体验最好。

Q:NAS 上能跑吗?

能,但要注意内存。建议给 OpenCode 限制4G内存上限,防止内存泄漏影响其他服务。


📌 一句话总结

OpenCode = 免费 + 开源 + 75+模型 + 终端原生

不想花 $20/月 用 Cursor 的程序员,这是你最好的选择。

⭐ GitHub 6万Star,去Star一下

安装命令:npm i -g opencode-ai@latest


关注公众号”实用软技”

在公众号窗口里回复关键字
“软件”
即可免费获取更多实用工具推荐!

觉得有用?点个在看👇

https://www.88531.cn/?p=54281

www.npspro.top互联侠客
软师傅 » 程序员都在偷偷用的AI编程神器,免费开源,GitHub狂揽6万Star

最TOP的Docker,软路由,虚拟机等学习资料

立即查看 了解详情