上周帮一个做前端的朋友试了台新电脑,他装了一堆插件——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 的程序员,这是你最好的选择。
安装命令:npm i -g opencode-ai@latest
关注公众号”实用软技”
在公众号窗口里回复关键字
“软件”
即可免费获取更多实用工具推荐!
觉得有用?点个在看👇
https://www.88531.cn/?p=54281
创作不易,用心坚持,请喝一怀爱心咖啡!继续坚持创作~~
