项目介绍
OpenCode 是开源编程代理,可以在项目目录中读取代码、解释结构、修改文件并调用开发工具。它适合把需求转换成可检查的代码改动,使用效果同时取决于模型、项目上下文和验证方式。
安装程序与连接模型是两个步骤。程序能够启动,不代表已经有可用额度;选择托管模型、本地模型或其他提供商后,还要确认认证方式、模型名称和实际调用是否成功。
核心功能
| 功能 | 说明 |
|---|---|
| 理解代码 | 在项目目录中查找入口、调用链和已有实现。 |
| 模型连接 | 选择模型提供商并验证实际请求。 |
| 代码修改 | 围绕明确任务编辑文件并提供可检查的差异。 |
| 工具执行 | 运行项目命令,并根据构建或测试结果继续处理。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | AI 与开发 |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装与运行
在自己的开发电脑准备 Node.js,并进入一个已备份或已提交 Git 的小项目。
1. 安装和初始化
npm install -g opencode-ai
opencode --help
opencode
2. 第一次使用
按首次启动界面连接自己的模型供应商,先让它解释一个文件,再要求只修改一个明确范围的问题。查看 diff 和运行项目已有检查后再提交,模型连接成功不代表项目测试通过。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。