OpenCode零基础教程完整版

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 的版本node-v解释检查 node.js 的版本是否安装成功npm-v解释检查 npm 的版本是否安装成功看到版本号就说明都安装成功了。3.4 切换 npm 的安装源但是在安装 OpenCode 之前提醒一下npm 包管理的下载资源一般都是国外的资源由于网络的问题下载会比较慢有时候因为网络的问题无法访问。所以用这种方式之前需确保网络能访问 npm 源推荐切换国内源避免安装慢。命令如下npmconfigsetregistry https://registry.npmmirror.com解释将安装源切换为国内的淘宝镜像服务器速度比国外官方快 10~50 倍4. OpenCode 安装OpenCode 的官网https://opencode.ai/zhOpenCode 有终端界面、桌面应用、网页端及 IDE 扩展在这里推荐大家使用终端界面可以单独使用也可以在各种 IDE 和编辑器中直接嵌入使用。4.1 安装终端界面安装命令npmi-gopencode-ai我们再验证一下 opencode 的版本一样的方法输入opencode-v看到版本号说明我们安装好了 OpenCode。4.2 打开 OpenCode在终端中输入opencode就能启动 OpenCode 了。启动后你会看到这样的界面 OpenCode 已启动 你現在使的是什么模型 介绍 big-pickle 模型4.3 简单使用 - 认识工作区打开 OpenCode 后你会看到终端界面分成了几个区域对话区显示你和 AI 的对话代码区显示生成的代码工具区显示执行结果5. OpenCode 的常见指令学会下面这些指令你就能玩转 OpenCode 了5.1 启动 OpenCodeopencode解释直接在终端上输入 opencode启动 OpenCode 的终端界面默认操作的路径是终端当前所在的路径建议大家打开 OpenCode 的顺序在电脑上找到合适的路径在当前路径下打开终端在终端上启动 OpenCode或者也可以指定的工作目录启动 OpenCode例如opencode /path/to/project5.2 退出 OpenCode/exit退出 OpenCode。别名/quit、/q5.3 切换模型/models列出可用模型可以在这里切换当前使用的模型。5.4 连接供应商/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 - 初始化项目/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 - 开始新会话/new当我们和 OpenCode 进行了多轮交流后已经产生了一些上下文信息这些上下文就是 Agent 的记忆可能会影响接下来的新的交流的时候可以使用/new指令开启一个新的会话。5.8 /sessions - 历史会话/sessions列出历史会话并在会话之间切换。5.9 文件引用 - 可以使用在消息中引用文件。这会在当前工作目录中进行模糊文件搜索然后自动阅读文件内容执行任务。使用场景 这样方便我们第一次给 OpenCode 比较复杂的描述时输入不方便的问题可以将需求信息写到文档中直接 文件按照文件执行任务。 也可以让 OpenCode 学习工作目录下的其他文件只要 文件名就行 也可以从文档中提取重要的信息5.10 bash 命令 - !以!开头的消息会作为 shell 命令执行。!ls-la命令的输出会作为工具结果添加到对话中。5.11 卸载 OpenCodeopencode uninstall卸载 OpenCode 并删除所有相关文件。打开终端执行命令然后选择 Yes 就卸载了。5.12 其他命令OpenCode 还有一些其他的命令大家可以自行学习/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启动 OpenCode6.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 GCCcompilers, linker, assemblerGDBdebuggerGNU Makestandard build toolCMake with Ninjabuild systembusybox-w32standard unix utilities, including shVimpowerful text editorUniversal Ctagssource navigationCcachecompiler 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 OpenCode9.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.json11. 重磅编辑和编译的区别很多同学经常混淆编辑和编译这里单独讲解一下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按CtrlShiftB编译按F5调试。方式二直接敲命令gcc main.c-omain.exe# 编译./main.exe# 运行11.5 给初学者的建议 就像学车先学手动挡敲命令搞清楚原理再学自动挡配 JSON以后更省事强烈建议加上 c_cpp_properties.json因为它能帮你发现低级错误总结这篇文章带大家从零开始学会了✅ 认识 OpenCode 是什么✅ 安装 Node.js✅ 安装 OpenCode✅ 使用 OpenCode 的各种指令✅ 一键/手动搭建 C/C 开发环境✅ 安装和使用 VS Code✅ 在 VS Code 中启动 OpenCode 写代码✅ 自动生成编译调试配置✅ 搞清编辑和编译的区别希望对大家有帮助有问题评论区见都看到这儿了还不点个赞 教程会持续更新记得关注