OpenCode 的使用教程 - 零基础版
📍 这是一个零基础教大家上手 OpenCode 的教程，会持续更新，大家记得一键三连，方便随时能找到。
这个教程不仅仅教大家的 OpenCode 的安装和使用，同时会使用 OpenCode + VS Code + w64devkit 来搭建一个 C/C++ 的开发环境。
先来认识一下 OpenCode
什么是 OpenCode？
🤔 你可能会问："OpenCode 到底是个啥？"
简单说，OpenCode 就是一个 AI 编程助手。它就像你身边的一个程序员朋友，你可以用大白话跟它交流，让它帮你写代码、查问题、改 bug。
官方定义是：OpenCode 是开源 AI 编程代理（编程助手/编程智能体），提供终端界面、桌面应用、网页端和 IDE 扩展等多种使用方式。
你可以这样理解：以前你遇到不会的编程问题，可能要去百度、翻文档、问学长。现在有了 OpenCode，直接问它就行！
OpenCode 能帮你做什么？
📍 编程代理能做什么呢？
编程代理通过内部配置的大语言模型来理解我们的自然语言，帮我们做一些程序开发的辅助工作。比如：
- 📖 代码阅读与理解 - 分析代码库结构、理解代码逻辑
- ✍️ 编写和修改代码 - 添加功能、修复 bug、重构代码
- 🔍 搜索与定位 - 在大型代码库中快速找到相关文件和代码
- ▶️ 执行命令 - 运行 git、npm、python、gcc 等开发工具
- 🐛 调试问题 - 定位问题根源并提供修复方案
- 👀 代码审查 - 检查代码质量、提出改进建议
- 🗺️ 项目探索 - 了解陌生项目的架构和依赖
而且 OpenCode 内置免费模型，也可以连接任意提供商的任意模型，包括 MiniMax、GLM、Claude、GPT、Gemini 等。
目前 OpenCode 的 npm 下载量已经有 1210W+，可见编程代理的使用已经非常普遍！
为什么要用 OpenCode？
📍 选择工具的理由：
在 AI 时代，编程学习的方式也要跟得上时代。过去我们学 C/C++ 用的是 VS 2022/VS 2026，现在 AI 编程代理越来越好用，我们可以选择 VS Code + gcc + OpenCode 的搭配来学习 C/C++ 编程。
因为在 AI 时代，未来程序员的工作中很可能离不开编程代理，它会是很好的工作伙伴。
OpenCode 是开源界对 Claude Code 的平替，选择它的理由：
- 🌏 开源 - 不需要科学上网，普通人都能使用
- 🎨 语法高亮 - 默认支持 LSP（语言服务器协议），终端代码看得舒舒服服
- 💰 免费模型 - 有提供免费的模型接入，使用成本低
- 🔄 自由切换 - 支持 75+ 的模型
- 📚 一通百通 - 学会 OpenCode，可以轻松上手 Claude Code 等其他编程代理
整个教程需要安装 4 个软件
在开始之前，先了解一下我们要安装什么：
- Node.js - OpenCode 运行需要的运行环境
- OpenCode - 本教程的主角，AI 编程助手
- w64devkit - C/C++ 编译工具包（包含 gcc、gdb 等）
- VS Code - 代码编辑器
3. Node.js 的安装
3.1 官网下载 Node.js
现在下载和安装 Node.js，找到官网下载地址：https://nodejs.org/zh-cn/download
我这里下载的是 v24 的版本。
3.2 安装 Node.js
双击安装包，开始安装，一路 next 就可以了，中途可以自行调整安装路径。
3.3 检查 Node.js 是否安装成功
3.3.1 检查 node.js 和 npm 的版本
打开终端，输入下面的命令检查 node 和 npm 的版本：
bash
node -v解释：检查 node.js 的版本，是否安装成功
bash
npm -v解释：检查 npm 的版本，是否安装成功
看到版本号，就说明都安装成功了。🎉
3.4 切换 npm 的安装源
但是在安装 OpenCode 之前，提醒一下：
npm 包管理的下载资源一般都是国外的资源，由于网络的问题，下载会比较慢，有时候因为网络的问题无法访问。所以用这种方式之前，需确保网络能访问 npm 源（推荐切换国内源，避免安装慢）。
命令如下：
bash
npm config set registry https://registry.npmmirror.com解释：将安装源切换为国内的淘宝镜像服务器，速度比国外官方快 10~50 倍
4. OpenCode 安装
OpenCode 的官网：https://opencode.ai/zh
OpenCode 有终端界面、桌面应用、网页端及 IDE 扩展，在这里推荐大家使用终端界面，可以单独使用，也可以在各种 IDE 和编辑器中直接嵌入使用。
4.1 安装
终端界面安装命令：
bash
npm i -g opencode-ai我们再验证一下 opencode 的版本，一样的方法，输入：
bash
opencode -v看到版本号，说明我们安装好了 OpenCode。
4.2 打开 OpenCode
在终端中输入 opencode 就能启动 OpenCode 了。
启动后你会看到这样的界面：
🤖 OpenCode 已启动
你現在使的是什么模型？
介绍 big-pickle 模型4.3 简单使用 - 认识工作区
打开 OpenCode 后，你会看到终端界面分成了几个区域：
- 📝 对话区：显示你和 AI 的对话
- 💻 代码区：显示生成的代码
- 📋 工具区：显示执行结果
5. OpenCode 的常见指令
学会下面这些指令，你就能玩转 OpenCode 了！
5.1 启动 OpenCode
bash
opencode解释：直接在终端上输入 opencode，启动 OpenCode 的终端界面，默认操作的路径是终端当前所在的路径
建议大家打开 OpenCode 的顺序：
- 在电脑上找到合适的路径
- 在当前路径下打开终端
- 在终端上启动 OpenCode
或者也可以，指定的工作目录启动 OpenCode，例如：
bash
opencode /path/to/project5.2 退出 OpenCode
bash
/exit退出 OpenCode。
别名 ：/quit、/q
5.3 切换模型
bash
/models列出可用模型，可以在这里切换当前使用的模型。
5.4 连接供应商
bash
/connect列出 OpenCode 支持的模型供应商，然后选择一个适合自己的，按照自己的需要设置就可以了。
我这里选择 MiniMax Coding Plan，一个月的订阅费用是 29 元，tokens 我目前是足够使用的状态。
当然也可以使用免费的 MiniMax M2.5 Free 的版本。
MiniMax 链接：https://platform.minimaxi.com/subscribe/token-plan
可以选择 MiniMax Coding Plan (minimaxi.com)，要选对国内的服务。
5.5 切换工作模式
Plan 和 Build 是 OpenCode 的两个主 Agent（主代理），在键盘上按 Tab 就可以切换两个模式。
📍 官方介绍：https://opencode.ai/docs/zh-cn/agents/
Plan Agent（规划代理）
- 🔒 只读模式，用于安全地分析和探索代码库
- 📋 专注于需求分析和计划制定
- 📝 分析用户需求，制定详细的开发计划，进行技术选型
- ✍️ 不会直接生成代码
- 🛡️ 执行敏感操作前会请求许可
适合场景：
- 🌱 探索和学习陌生代码库
- 📐 项目规划和技术方案设计
- 🔍 需要安全审查时
Build Agent（构建代理）
- 🔨 拥有完全的系统访问权限
- 💻 专为编码、调试和测试等开发工作设计
- ✍️ 专注于代码实现
- ⚡ 根据 Plan Agent 制定的计划生成代码、调试优化、修复错误
适合场景：
- 🚀 日常开发任务
- 🐛 代码实现和调试
- ✅ 修复错误
这种"先规划、再执行"的设计确保了开发流程的规范性和代码质量的可靠性。
5.6 /init - 初始化项目
bash
/init/init 命令是用来创建和更新 AGENTS.md 文件的。
📍 第一次执行 /init 的时候，扫描你工作目录下的项目及其所有内容，了解项目的用途、项目结构、代码规范、项目类型等，并据此生成一个 AGENTS.md 文件，帮助 OpenCode 更好地做好代理的工作。
如果已有 AGENTS.md 文件，该命令会尝试在其基础上进行补充。
AGENTS.md 的作用：
- 📦 保存项目上下文 - 记录项目结构、构建命令、测试命令等
- 🤖 帮助 AI 快速上手 - 未来新会话时无需重复说明项目信息
- 📝 定义项目规范 - 代码风格、命名约定、错误处理等
在 AGENTS.md 文件中，我们可以根据需要自己加入一些内容，用于定义 AI 在当前工作环境中的行为约定。比如：
- 🤖 定义 AI 的角色定位（如示例中指定为 "C/C++ 程序员"）
- 📏 约束代码风格（注释规范、大括号格式等）
- ✅ 规定交互原则（确认后再执行、删除前需确认等）
OpenCode 还支持从多个位置读取 AGENTS.md 文件，不同的位置有不同的用途：
- 📁 项目级：在项目根目录放置一个 AGENTS.md 文件，用于定义项目特定的规则。这些规则仅在该目录或其子目录中工作时生效。
- 🌍 全局级 ：还可以在
~/.config/opencode/AGENTS.md文件中设置全局规则。这些规则会应用于所有 OpenCode 会话。
当 OpenCode 启动时，会自动加载 ~/.config/opencode/AGENTS.md 文件，将其作为系统级指令注入到对话上下文中。你可以通过修改这个文件来自定义 AI 的行为风格和工作方式。
5.7 /new - 开始新会话
bash
/new当我们和 OpenCode 进行了多轮交流后，已经产生了一些上下文信息，这些上下文，就是 Agent 的记忆，可能会影响接下来的新的交流的时候，可以使用 /new 指令开启一个新的会话。
5.8 /sessions - 历史会话
bash
/sessions列出历史会话，并在会话之间切换。
5.9 文件引用 - @
可以使用 @ 在消息中引用文件。这会在当前工作目录中进行模糊文件搜索，然后自动阅读文件内容，执行任务。
使用场景：
-
💡 这样方便我们第一次给 OpenCode 比较复杂的描述时，输入不方便的问题，可以将需求信息，写到文档中，直接 @ 文件，按照文件执行任务。
-
📚 也可以让 OpenCode 学习工作目录下的其他文件，只要 @ 文件名就行
-
📄 也可以从文档中提取重要的信息
5.10 bash 命令 - !
以 ! 开头的消息会作为 shell 命令执行。
bash
!ls -la命令的输出会作为工具结果添加到对话中。
5.11 卸载 OpenCode
bash
opencode uninstall卸载 OpenCode 并删除所有相关文件。
打开终端，执行命令，然后选择 Yes 就卸载了。
5.12 其他命令
OpenCode 还有一些其他的命令，大家可以自行学习：
bash
/undo # 撤销修改
/redo # 重做修改
/share # 生成当前对话的链接并复制到剪贴板
/theme # 切换主题6. 一键搭建 C/C++ 开发环境
这里有一个 Skill 文件，让 OpenCode 按照这个文件中的提示词去执行，就可以一键下载好 C/C++ 开发工具包，然后配置好 gcc/gdb 等开发环境，并配置好环境变量。
6.1 打开终端
在任意一个 Windows 的文件中，右击鼠标就可以打开终端。
比如：我们想在 D:/dev 的路径下安装开发环境，所以我们在 D 盘创建文件夹叫：dev
如果没有 D 盘，换成 C 盘也可以。
我们在 dev 文件夹中，右击鼠标，然后打开发终端。
6.2 启动 OpenCode
在终端中输入：opencode，启动 OpenCode
6.3 修改默认模型
输入 /models 就可以切换模型模型，切换为：MiniMax M2.5 Free，当然根据自己的情况，也可以切为收费的模型，效果一般会更好。
6.4 执行 Skill 搭建环境
-
下载提供的这个 skill 文件，放在
D:\dev的路径下 -
然后在 OpenCode 中，输入：
@install_w64devkit_skill.md
按照这个 skill 的内容，帮我搭建 C/C++ 开发环境
@install_w64devkit_skill.md 是引用这个文件的内容，来完成任务。
按下回车，配置过程就开始了。
规划任务执行的步骤：
- 📥 选择或者输入安装路径
- ⬇️ 下载安装包
- 📦 解压安装包
- ✅ 验证 gcc 是否正常工作
- 🔧 添加环境变量
- 🔄 在当前终端刷新环境变量，验证 gcc 是否能正常使用
- 🎉 完成总结
6.5 自行验证环境
新打开一个终端。
输入：gcc -v，查看 gcc 的版本
输入：which gcc，查看 gcc 所在的位置
7. 手动配置 C/C++ 开发环境
注：第 6 步成功，可以跳过第 7 步。
7.1 下载 w64devkit 的安装包
w64devkit 的意思是：Windows x64/x86 的 dev(开发) kit（工具包），工具包中包含了下面 9 个工具：
| 工具 | 说明 |
|---|---|
| mingw-w64 GCC | compilers, linker, assembler |
| GDB | debugger |
| GNU Make | standard build tool |
| CMake with Ninja | build system |
| busybox-w32 | standard unix utilities, including sh |
| Vim | powerful text editor |
| Universal Ctags | source navigation |
| Ccache | compiler cache |
下载链接：https://github.com/skeeto/w64devkit/releases（需要科学上网）
大家可以看置顶评论来领取这个资料包。
7.2 安装
双击这个文件，就开始安装，需要选择安装路径，这里我选择安装到 D:\dev 的路径下，然后点击 Extract（提取）。
看到下面的界面，知道安装结束。
7.3 配置环境变量
- 在【开始】中搜索：环境变量，点击【编辑系统环境变量】
- 点击【环境变量】，进入编辑页面，在当前用户的变量中找到 Path，双击进入下一页面，再点击【新建】
- 输入：bin 文件夹的路径（这里要根据你的安装路径来输入）
- 然后点击确定就可以了
- 打开一个新的终端窗口，验证 gcc 的版本和安装位置
8. VS Code 的安装
VS Code 官网：https://code.visualstudio.com/
8.1 下载
点击后，进入下载页面，等待下载成功。
8.2 安装
双击软件，进入安装界面，同意使用协议后，一路【下一步】即可。
安装成功界面。
8.3 汉化
第一次打开的界面是英文的。
在 VS Code 的左边栏选中【扩展】，搜索 chinese，找到简体中文的插件，可以把 VS Code 汉化，点击【install】安装，安装后会看到提示重启，重启后就是汉化后的版本。
点击下面的提示，重启 VS Code。
看到了中文的界面。
到这里 VS Code 就安装好了。
9. VS Code + OpenCode
9.1 打开 VS Code
比如我想在 D:/dev/code 路径下写代码，我们就可以在 D:/dev 路径下新建一个 code 文件夹。
然后进入 Code 文件夹中，右击鼠标打开终端。
接下来在终端中输入：code .，就可以使用 VS Code 打开 D:/dev/code 文件夹来写代码了。
接下来选择【是的，我信任此作者】，让我们的 VS Code 有权限访问该文件夹。
9.2 编写代码
9.2.1 认识一下界面
VS Code 界面主要由以下部分组成：
- 📁 左侧边栏：文件资源管理器
- 📝 中间：代码编辑区
- 📋 底部：终端
9.2.2 让 OpenCode 写代码
打开 VS Code 后，按 Ctrl + `` 组合键，可以在 VS Code 上打开终端。
输入：opencode，回车，就启动了 OpenCode。
让 OpenCode 帮我写一个 C 语言的程序，输入指令：
写一个 C 语言的程序，对10个元素的整型数组初始化为1~10，然后逆序打印数组内容，加上适当的注释，帮助我理解代码OpenCode 就会帮你生成代码！
10. OpenCode 自动生成编译和调试配置文件
在 VScode 上要编译和调试代码，需要安装一个 C/C++ 的插件，如下图，直接安装即可。
我们在 VS Code 上写完 C 语言的代码，想在 VS Code 上对代码进行编译和调试，这里就得配合使用 gcc 和 gdb。
同时我们需要生成编译和调试的配置文件。我们让 OpenCode 自己生产配置文件，我们直接使用。
输入：
我需要对我当前的 C 语言的代码进行编译和调试，请帮我生成编译和调试的配置文件OpenCode 会自动帮你生成 tasks.json 和 launch.json！
11. 重磅！编辑和编译的区别
很多同学经常混淆"编辑"和"编译"，这里单独讲解一下！
11.1 什么是编辑？
编辑 = 打字 + 保存
就像用记事本写日记一样，你写字、修改、保存，这就叫编辑。VS Code 就算什么配置都没有，照样能让你打字、保存文件！
11.2 什么是编译？
你保存了 .c 文件，但电脑根本看不懂！电脑只认识 0 和 1。
这时候就需要**编译器（gcc）**出场：
.c 文件 --（gcc编译）--> .exe 文件11.3 c_cpp_properties.json 是干啥的？
这个文件相当于"拼写检查"：
- ✅ 能让 VS Code 标红报错
- ✅ 能提示你函数怎么用
- ✅ 能让代码高亮更准确
但是！没有它，你依然能写代码！只是编辑器变"傻"了而已。
11.4 两种编译方式
方式一：点按钮（JSON 配置）
配置 tasks.json 和 launch.json，按 Ctrl+Shift+B 编译，按 F5 调试。
方式二：直接敲命令
bash
gcc main.c -o main.exe # 编译
./main.exe # 运行11.5 给初学者的建议
🚗 就像学车：
- 先学手动挡（敲命令）：搞清楚原理
- 再学自动挡（配 JSON）：以后更省事
强烈建议加上 c_cpp_properties.json！因为它能帮你发现低级错误！
总结
这篇文章带大家从零开始学会了：
- ✅ 认识 OpenCode 是什么
- ✅ 安装 Node.js
- ✅ 安装 OpenCode
- ✅ 使用 OpenCode 的各种指令
- ✅ 一键/手动搭建 C/C++ 开发环境
- ✅ 安装和使用 VS Code
- ✅ 在 VS Code 中启动 OpenCode 写代码
- ✅ 自动生成编译调试配置
- ✅ 搞清编辑和编译的区别
希望对大家有帮助！有问题评论区见！
都看到这儿了，还不点个赞？ 👍👍👍
📌 教程会持续更新，记得关注！