产品界面
来自官网与产品公开页的实拍截图
OpenCode 是什么
OpenCode 是一个开源的 AI 编程智能体,核心场景在终端:你把它放进一个项目目录,用自然语言描述任务,它会读取代码、分析上下文、修改文件并执行命令,最终把改动直接落在仓库里。
与 IDE 插件式助手不同,OpenCode 更接近"独立的编程同事":它拥有终端 UI、会话历史和多文件操作能力,并且不绑定特定模型。开发者可以接入 OpenAI、Anthropic,也可以把模型指向任意 OpenAI 兼容端点,包括自建服务和各类 API 平台。
核心能力与主要功能
- 终端智能体:在项目目录直接启动,识别仓库结构、语言栈和任务上下文。
- 多文件编辑:一次任务可跨多个文件新增、修改和重构代码,并展示变更差异。
- 命令执行:可运行测试、构建与 git 命令,把结果反馈给模型继续决策。
- 任意模型后端:支持 OpenAI 兼容接口,方便接入官方 API、自建模型或聚合平台。
- 会话持久化:历史会话可恢复,长任务可以中断后续跑,不丢失上下文。
- 开源可审计:源码公开,提示词、工具调用和权限边界透明,适合安全敏感环境。
模型接入与配置
OpenCode 默认配置官方模型商,也支持通过环境变量指向任意兼容端点。对国内开发者来说,常见组合是把模型地址指向 OpenAI 兼容的中转站或自建网关,从而在终端里使用 DeepSeek、Qwen 等模型。
# 配置模型端点示例
opencode config set model openai/gpt-4o
opencode config set base_url https://api.example.com/v1接入不同模型时,要注意模型是否支持工具调用和长上下文:编程 Agent 依赖工具调用完成文件读写,上下文长度则决定它能一次性理解多少代码。
适合谁使用
终端开发者:习惯命令行工作流,希望 AI 直接参与提交前的小修小改。
多模型玩家:想对比不同模型在真实代码任务上的表现,或把成本更低的模型接进日常开发。
安全敏感团队:需要审计 AI 行为、限制命令权限,或把模型切换到私有部署。
自动化场景:把 OpenCode 嵌入 CI 或脚本,用 AI 生成补丁、跑测试并输出结果。
安装与快速上手
先安装 Node.js 工具链,然后通过 npm 全局安装:
npm install -g opencode-ai进入项目目录后运行 opencode,配置好模型 Key 即可开始对话。示例任务可以是"修复登录接口的鉴权漏洞"或"给这个函数补充单元测试",Agent 会先浏览相关文件,再给出修改计划并逐步执行。
首次使用建议先在测试仓库中验证,确认它对工具调用和文件权限的处理符合预期,再投入日常项目。
与 IDE 助手的区别
IDE 助手擅长边写代码边补全,适合鼠标键盘交替操作的图形界面;OpenCode 则把整个仓库作为上下文,通过自然语言驱动多文件改动,更适合"下达任务、审查差异、提交代码"的流程。
它没有编辑器自带的光标级补全体验,但胜在轻量、可脚本化和模型无关。配合 git diff 审查,OpenCode 可以作为团队里的 AI 结对编程成员,也可以成为自动化流水线中的代码处理单元。
官网直达
想亲自上手体验,直接从官方入口出发:
常见问题
OpenCode 是免费的吗?
工具本身开源可免费使用,模型调用费用由你接入的模型服务商按实际用量收取。
只能接官方大模型吗?
不是,支持 OpenAI 兼容端点,可以接入自建服务、聚合平台或本地推理服务。
它会在项目里自动执行命令吗?
会,但命令执行受配置与权限约束,建议在测试仓库中先确认行为再使用。
适合大型项目吗?
适合,但要选择上下文足够长的模型,并把任务拆成可审查的小步骤以获得更好结果。