最近把我的 AI 编程工作流从单纯的 Copilot 切换到了 Opencode,配合国产大模型 MiniMax 和 Google 的 Gemini,体验简直飞起。
我一直觉得在大模型网页端、IDE 和终端之间来回切换(Alt-Tab)特别割裂。虽然 IDE 里的 Copilot 很好用,但它更像是一个补全工具,而不是一个真正理解我整个项目的”编程搭子”。
我想要的是一个能直接在 Terminal 里跑的、懂我整个项目的、还能帮我执行命令的 Agent。Opencode 就是这么个东西,而且它的界面是用 Bubble Tea 写的,颜控狂喜。
为什么是 Opencode?
市面上 AI 编程工具那么多,为什么选它?几个理由:
- 原生终端体验:它直接运行在 CLI 里,不用离开我熟悉的 Zsh 环境。
- 配置即文档:它的配置文件直接就是 Markdown,既是配置也是文档,这个设计真的太戳我了。
- 模型中立:不像 Copilot 绑定 OpenAI,Opencode 想接谁就接谁。我可以把便宜好用的 MiniMax 用来做日常任务,把更聪明的 Gemini 用来处理复杂逻辑。
安装与配置
1. 安装
macOS 用户直接 brew 一把梭:
brew install opencode
或者直接用安装脚本:
curl -L https://opencode.ai/install.sh | sh
2. “双模”配置:性价比之选
这是我目前觉得最舒服的配置方案:MiniMax + Gemini 双持。
在项目根目录新建一个 opencode.md(没错,就是 markdown 文件)。
---
# 默认使用高性价比的 MiniMax
provider: minimax
model: MiniMax 2.5
api_key: your-minimax-api-key
# 需要更强逻辑时切换到 Gemini(注释掉上面,解开下面)
# provider: google
# model: gemini-2.0-flash
# api_key: your-gemini-api-key
---
# Project Context
这里写一些项目的背景信息,Opencode 会把它作为 System Prompt。
比如:这是一个基于 Jekyll 的个人博客,主要使用 Ruby 和 Liquid 模板。
风格要求:口语化、多用第一人称。
为什么这么配?
- MiniMax 2.5:中文理解能力极强,生成代码速度快,价格还便宜,用来写写这篇博客或者改改简单的脚本绰绰有余。
- Gemini 2.0 Flash:当遇到特别复杂的逻辑重构,或者需要超长上下文(Context Window)的时候,切换到 Gemini 会更稳。
玩转 Oh My Opencode
Opencode 最让我惊喜的是它的 Skill 生态。这玩意儿有点像 Zsh 的 “Oh My Zsh”,社区贡献了很多好用的技能包。
运行命令安装 Skills:
opencode skills install
我最常用的几个 Skill:
- git-master:这个真的是神器。
- 以前写 commit message 还要绞尽脑汁,现在直接让它根据 diff 生成原子化的 commit。
- 处理 git conflict 的时候,它能给出非常合理的建议。
- frontend-ui-ux:前端救星。
- 我这种后端写 CSS 经常痛苦面具,用了这个 skill,直接描述”我要一个 3D 风格的卡片组件”,它生成的 CSS 质量出奇的高。
- dev-browser:
- 可以让 Agent 控制浏览器去查阅文档、抓取网页内容。比如遇到一个报错,直接让它去 StackOverflow 搜一下解决方案回来告诉我。
避坑指南(实战心得)
虽然 Opencode 很强,但用起来还是有一些”坑”需要注意:
1. Context 不是万能的
不要指望它能读懂你硬盘里的所有文件。Opencode 虽然能感知项目结构,但具体的代码文件,最好还是通过 /add 命令显式地加到上下文里。
经验:把相关文件 /add 进去,它的智商直接提升 50%。
2. 善用 Plan Mode
Opencode 有两种模式:直接执行(Build)和计划模式(Plan)。 一开始我图省事,直接让它改代码,结果有时候它会改得面目全非。 建议:稍微复杂点的任务,先用 Plan Mode,让它列出”首先干什么,然后干什么”,确认无误了再让它动手,这样稳很多。
3. Prompt Engineering 依然重要
虽然是 Agent,但你给的指令越清晰,它干活越利索。
- ❌ “帮我改一下这个 bug”
- ✅ “作为一个 Ruby 专家,帮我分析
_config.yml里的 permalink 配置,为什么会导致文章链接 404?”
总结
Opencode + MiniMax/Gemini 的组合,让我找回了当年配置 Vim 时的那种掌控感。它不是一个黑盒的 IDE 插件,而是一个可以深度定制、就在手边随时待命的 CLI 伙伴。
特别是当你用自然语言在终端里指挥它重构代码、提交 Git 的时候,那种”人机合一”的感觉,真的谁用谁知道。推荐大家试试!