OpenCode 是一个开源的 AI 编程代理工具，旨在帮助开发者提高编码效率，支持多种使用场景和模型。

什么是 OpenCode

OpenCode 是一个 100% 开源的 AI 编程代理，它可以通过终端、桌面应用程序和主流 IDE（如 VS Code）与 AI 交互，完成代码相关任务。它的主要功能包括帮助开发者理解代码库、编写新功能、重构代码和修复 Bug 等。

核心特点

多模型支持：OpenCode 支持 75+ 种大语言模型（LLM），包括 OpenAI、Anthropic、Google 等多个提供商，用户可以根据需求选择合适的模型。

灵活的使用方式：用户可以在终端、桌面应用或 IDE 中使用 OpenCode，适应不同的开发环境。

上下文感知：OpenCode 能够自动分析项目结构，生成 AGENTS.md 文件，帮助更好地理解项目。

隐私优先：作为开源工具，OpenCode 强调用户隐私，用户可以选择本地模型，避免数据泄露。

0x00001-安装：

opencode 需要 Node.js 22 +

在命令行输入如下命令，版本号大于 22 即可：

node -v

如果已经安装，并且版本正确可以继续下一步。(如果需要安装或升级，则可到 https://nodejs.org/zh-cn/download 下载并安装最新版本的 Node.js。)

使用命令行安装opencode

npm i -g opencode-ai@latest

除了命令行工具，opencode 还提供了插件和桌面端。

桌面端

对于毫无开发经验的产品经理或普通人，使用桌面版是最好了。毕竟能用鼠标，整个操作简单很多。后面操作也会以桌面端为例。推荐安装！

下载地址：https://opencode.ai/download

在 OpenCode Desktop (Beta) 下，选择操作系统对应的安装包下载。

插件安装

对于还是需要看代码的程序员，则在 IDE 插件市场，搜索选择 opencode 安装。

订阅大模型编程套餐

OpenCode 比较自由，普通的大模型 API 也能使用。不过还是推荐支持 Coding Plan 的大模型。毕竟编程工具的使用量很大，一般的 API 可能很快就被消耗光。

国内推荐使用 GLM 大模型或 MiniMax 大模型的 Coding Plan 套餐。买哪个套餐自行决定。也可以都订阅一个月尝试，后面再取消。可以从最便宜的套餐开始，需要再升级。

MiniMax

Starter 29元/月，Plus 49元/月，Max 119元/月。订阅地址：

👉 立即参与： https://platform.minimaxi.com/subscribe/coding-plan

https://platform.minimaxi.com/subscribe/coding-plan?code=12mvdDWWWo&source=link

GLM

Lite 40元/月，Pro 200元/月，Max 400元/月，目前首月半价。订阅地址：https://bigmodel.cn/glm-coding

API Key 获取

订阅套餐后，可进入官网复制 API Key。以下以 MiniMax 国内站为例。

进入官网，登录后，进入账户管理，点击左侧菜单“订阅管理”下方的 Coding Plan。

此时出来的页面，便能看到 API Key 了。

点击“重置并复制”即可。

开始使用

OpenCode 是以项目为单位进行开发的，选择从一个文件夹或者新建一个文件夹开始都可以。

OpenCode 也会基于你系统的语言，展示界面，如果没有出现中文，可以在设置中进行修改。

另外，设置里提供了 10多个主题供选择，对不喜欢黑色界面的，可以试试其他主题。

接入模型

opencode 接入模型比 Claude code简单。

进入项目界面之后，在对话框，点击当前的模型，会弹出模型选择窗。

opencode 内置了60多个大模型提供商，点击“查看全部供应商”，能看到国内的供应商，除了刚刚提及的 GLM 和 MiniMax，还包括 阿里巴巴、Deepseek、Z.AI 、月之暗面等等。

大部分情况下，你只需要填入 上一步 从供应商那边复制 api key即可。（MiniMax 注意区分国内国外站）

配置完成，在对话框正常对话，有返回，配置就成功了！

基本操作

Agents

目前有两个 Agent 和 SubAgent：

Build，默认 Agent，阅读编辑处理文件时使用Plan，计划 Agent，帮你规划复杂任务General，通过 @general 调用，帮你研究复杂问题，执行多步骤任务。Explore，通过 @explore 调用，帮你做简单的查找、阅读代码，回答问题。

工具

opencode 没有把工具分那么细，skills 和 commands 也是工具的一种。它们统一都是使用 /具体工具 的方式调用。

安装 skills/commands，有两种方法：

方法一、把 skills 文件夹的内容复制到 .opencode/skills，或 .opencode/commands 下；

方法二、使用 skills/commands 官方提供的方法，或官方提供的对话信息提交给 opencode。

在这里推荐一个专门给 OpenCode 做的开发用的库：https://github.com/code-yeongyu/oh-my-opencode

命令行

支持输入 ! 切换到命令行模式，此时直接输入 shell 命令，能触发执行。

也可以新增一个 终端窗口，更方便操作。

其他的使用方法，可以参考官方文档：https://opencode.ai/docs