用 AI 写代码的痛点到一定程度会变：不再是"写得快不快"，而是"数据出不出域、模型绑不绑定、哪天权限收紧"。OpenCode 作为开源编码代理，终端界面、桌面应用、IDE 扩展三种形态都有，且自带可用的大模型配置路径，是目前做"可控 Plan B"成本最低的选择之一。
安装：四条命令任选其一
基于 Node.js 生态，四条安装路径按自己环境挑一条：
npm i -g opencode-ai # 有 Node/npm 的最常见路径
bun add -g opencode-ai # 用 bun 的更快
brew install anomalyco/tap/opencode # macOS
paru -S opencode # Arch Linux
装完验证：opencode --version 有版本号输出，终端输入 opencode 能看到交互界面即成功。国内网络拉包慢，先给 npm 配镜像源再装，能省不少时间。
模型切换与免费额度
终端里 /models 命令列出可用模型，标注 free 的可以直接白嫖——MiniMax M2.5、Nemotron 系列等都在列表里。切换模型不用重启会话，当前对话上下文延续。这一点对多模型对比很友好：同一份代码问题，切模型重问一遍，回答质量的差异一目了然。
配置自有模型：两种接入方式
OpenCode 支持接自己的 API Key（OpenAI 兼容协议），也支持本地模型（Ollama 等）。企业内网合规场景走本地模型路线：数据不出域，模型能力换可控性。
以 OpenAI 兼容协议接入为例，配置文件里三行就够：给 provider 起个名字、填 base_url、写 model 名。最高频的报错就出在 base_url 末尾的 /v1——多写一层路径或漏掉它，请求直接 404，表现却常常像是密钥无效；先核对路径再怀疑密钥，能省掉大半排查时间。配置改完不要直接上多步任务，先用一条单轮对话验证连通性，把问题隔离在连接层，再谈工作流整合。
工作流整合：从工具到流程
单工具价值有限，OpenCode 的价值在流程整合：配合 Git 做检查点（每个 Agent 任务开始前先 commit，出问题随时回退）；配合脚本跑自动化测试（Agent 改完代码立刻验证）；配合 cc-switch 这类切换工具管理多套模型配置。三条搭起来，就是一个"开源、可审计、模型不绑定"的最小工作流。
验收与边界
装完做四步验收：交互界面正常打开、模型列表能加载、一个真实小任务（写个脚本）完整跑通、断网验证本地模型路径不受影响。也要认清边界：开源工具的 Agent 能力和商业产品有差距，复杂多步任务的成功率偏低；自带免费模型的能力档位也和旗舰有距离。它的定位是"可控的基础盘"，不是"最强编码助手"——明确这个预期，才不会装完就失望。
评论0