OpenCode 是近期热度最高的 AI 编程工具，它的最大优势是有开箱即用的免费模型，通过简单配置，还能免费接入 Gemini 3 Pro 、Claude 4.5 Opus 等顶级编程模型。OpenCode 可以看作是一个开源版的 Claude Code ，几乎具备了 Claude Code 的一切功能，而且对中国用户友好，不会遇到 Claude Code 里面限速、封号等一系列麻烦的事情。在 OpenCode 里面，有几个可以免费使用的主流模型，非常适合小白上手 AI 编程，可以随便造随便玩，还可以用它练习 Agent Skills 、MCP 、SubAgent 等高级特性。本期视频是一个 OpenCode 的完整教程，主要介绍 OpenCode 的四种形态，对比其他 AI 编程工具的亮点，还有我们要重点介绍 Oh My OpenCode 这个超强插件，还有等等的一系列高级用法。
OpenCode 有四种形态，分别是命令行、桌面客户端、插件，最后是云端运行环境。
我们先来看命令行。这里我准备用第二种方式，也就是 Node.js 的方式来安装。我们先来到 Node.js 的首页，在这里根据自己的操作系统下载对应的安装包，把 Node.js 安装一下。opencode 就可以直接启动了，进入这个页面，打个招呼，这样就完全配置成功了，非常简单。
接下来我们来看客户端版的安装。在这个页面点击下载客户端，然后一路点击下一步完成安装。
https://opencode.ai/zh/download
打开以后，选择一个文件夹作为项目文件夹，就可以直接开始使用了。OpenCode 的客户端并不是一个完整的 IDE ，它只有基础的对话框功能，而且目前处于 Beta 测试版，我试用下来 bug 还是比较多的，所以本期视频我们主要还是以命令行版本为例进行操作。
接下来我们来看插件版的安装。使用插件版的 OpenCode 的前提是需要先把命令行版的安装好。这里我以 VS Code 为例，我们打开 VS Code ，在左侧的 extensions 搜索 OpenCode ，然后我们找到这个 OpenCode 插件，点击安装。Ctrl+Shift+P 打开命令面板，敲这个命令 open opencode，回车，这样就以插件的形式打开了 OpenCode 。Ctrl+Alt+K，把这些代码直接快捷地粘贴到 OpenCode 的聊天窗口里面，这就是插件的全部功能了。
最后一个云端运行环境，我们放到视频的最后面再看。
OpenCode 最棒的是内置了一些免费的模型。我们敲命令来到软件，进来以后，输入命令 /models，后面带 Free 标记的，都是一些可以免费使用的模型。
接下来，我们把另外一个好用的编程模型 GPT Codex 也接入到 OpenCode 里面。就在前几天，OpenAI 跟 OpenCode 官宣进行了合作，我们可以直接在 OpenCode 里面使用 ChatGPT Codex 的编程套餐。在爬爬虾之前的这期视频里面：
https://www.bilibili.com/video/BV1wm4UzfEbr/
详细地介绍了订阅方法。我们来到 OpenCode ，输入这个命令 /connect，回车，这里选到 OpenAI ，选择 ChatGPT Pro/Plus 。/models，这样就可以选到 ChatGPT 的几个模型了。
除了上面这几种接入 AI 的方式，输入 /connect 命令，可以查找到 75 种 AI 的接入方式，几乎囊括了所有的模型供应商。 比如我们可以找到 OpenRouter ，需要我们填写一个 OpenRouter 的 API Key 。我们来到 OpenRouter 的官网，
https://openrouter.ai/workspaces/default/keys
点击 Get API Key ，创建一个，把这个 Key 复制一下，填写到 OpenCode 里面回车。 一个 OpenRouter 就能接入市面上几乎所有类型的大模型，而且国内用户也可以很方便地获取额度。可以说我们只要接入了 OpenRouter ，就可以使用几乎一切的大模型。
我找了一个之前常用的经典测试案例来测试一下。这里 OpenCode 的表现有几个亮点。首先在开始之前，它会反向询问我一些问题，比如说只是要代码样例，还是一个完整可以运行的程序？有哪些功能是必须实现的？调用哪个 Gemini 模型？然后环境变量是怎么保存的？
第二个亮点，就是命令行版的代码比对界面，我觉得是所有命令行类的编程工具里面做的最好的。
OpenCode 里面重点突出了一个叫做 session 的概念。我们每次跟 AI 开启的一个新的对话，就是一个全新的 session 。session 可以后台运行，而且可以多个 session 并行运行。比如这是我们刚才生成的你画我猜的游戏网站，这里我想增加两个功能。首先我想让画笔可以调整颜色，第二个功能我想增加一个计时器，如果作画超过 20 秒，游戏就失败了。我们先输入第一个需求，增加一个计时器，在第一次落笔的时候进行计时，如果超过 20 秒，游戏就失败了，开始。在这个任务的执行过程中，我们可以输入 /new 命令，创建一个新的 session ，然后开始我们的第二个需求。第二个需求是画笔可以调节颜色。我们输入命令 /sessions，就可以看到我们触发的 session ，前面一个打转的符号，表示它正在后台运行。
输入 /share 命令，可以把这个 session 的对话记录分享成一个网页。网页的地址已经复制进了粘贴板，我们把地址粘贴进浏览器，就可以看到这个 session 里面跟 AI 的对话记录，包括它是怎么进行文件修改的。/unshare 就可以取消分享，之前的链接也就变得不可用了。输入命令 /export，就可以把对话记录导出成一个文件。
刚才我又进行了两次对话，先让他把画笔默认改成红色，然后把这个提示删除。OpenCode 还有一个亮点功能，就是它的时间线，或者说是检查点。我们输入命令 /timeline 回车，可以看到这个 session 里面的跟 AI 的对话记录。revert 功能，把代码跟聊天内容一起回退到这次对话之前的状态。我们可以回到这个时间点，再重新进行修改。
在上期视频里面，我们介绍了 agent skills 的基础概念以及其目录结构。我们可以把 skill 理解成带目录的说明书，每个文件夹都对应一个 skill ，也就是一个技能包。一个 Claude Code 中的 skill 迁移到 OpenCode 里面非常的简单，我们只需要把目录里面的 .claude 替换成 .opencode 就可以了。.opencode 的文件夹，进来以后再新建一个 skills 文件夹，然后就可以把这 3 个技能直接复制进来。 这样我们的项目就拥有了那 3 个技能。我们右键在终端打开，输入 opencode 启动起来，我问他你有哪些 skills ，这里给出了完整回答。
接下来我们来看 MCP 的配置方法。OpenCode 里面有两种 MCP ，我们在文档里面可以找到，一个是 local 的方式，也就是通过本地命令来执行；还有一个 remote 的方式，也就是远程调用。我们先以这个 shadcn 为例来把它配置一下。我们先来到 OpenCode 的配置文件夹 C:\Users\你的用户名\.config\opencode，找到这个配置文件 opencode.json。shadcn。类型的话是本地，然后 command 这里填写命令 npx，后面是 shadcn@latest，把这一段复制过来。最后这里还有一个 mcp，我们打个逗号添加上，enabled 表示启动，下面没有环境变量，这样一个本地的 MCP 就配置完成了。
接下来我们再看一个远程调用的案例，我们就以这个 context7 MCP Server 为例。我们回到 OpenCode 的文档站，在下面找到这个远程调用的案例，把这一段复制一下，打个逗号，粘贴到配置文件里面来。remote，远程调用。URL 我们把 context 7 的 URL 复制一下，粘贴过来。在 header 里面我们填上 context7 的这一串，粘贴过来。这里它需要一个 API Key ，我们可以来到 Context7 的官网创建 API Key ，把这个 Key 复制一下，填写到配置文件里面。context7。我们重启一下 OpenCode ，输入命令 /mcp，就可以看到我们刚才配置的两个 MCP 。这也就是本地还有远程调用两种 MCP 的配置方式。
Oh My OpenCode 是 OpenCode 上一个最火的编程插件，它本质上就是一系列的工具加 MCP 加编程 agent 的组合捆绑包。比如在工具方面，它集成了 LSP 高级版，可以通过编程语言的语法和语义，帮助 AI 快速理解和定位代码； AST 工具，可以通过代码的语法树进行关联搜索； look at 工具，借助多模态大模型的视觉能力，帮助理解图片还有 PDF 等信息；还有像 delegate task 、background task 这些 agent 任务分配和后台调度工具。
插件还内置了 3 个 MCP Server：websearch 用于网络搜索，context7 用于获取最新的文档，grep_app 用来在 Github 仓库快速搜索代码。
插件还内置了 7 大编程智能体，分别是西西弗斯，他是主智能体，用来规划和调度任务；先知，用来做架构设计、代码评审等等；图书管理员，用来查阅文献；探索者，用来进行网络搜索；还有前端工程师、文档编写者，还有多模态等等。插件给每个智能体都分配了一个最适合它工作的大模型。比如前端工程师，使用前端能力最强的 Gemini 3 Pro 模型；主 agent 使用的是 Claude Opos 4.5 。据说这是作者花了 24,000 美元的 TOKEN ，找到最适合的 AI 编程团队。
好，我们把这个插件安装一下。在它的 GitHub 首页，这里有一段提示词，就是 install 开头的这一段，我们把它整个复制下来。C:\Users\你的用户名\.config\opencode，在这里面有一个 oh-my-opencode.json 的配置文件。这里定义的是 Oh My OpenCode 七大智能体所用的模型，我们可以根据自己的需要来进行调节。
这个插件主要有几种用法。首先我们可以敲 @，然后挑选一个智能体给我们干活。还有一个用法就是输入这个魔法词 ulw，也就是 Ultra work 。输入这个魔法词以后，Oh My OpenCode 就会尽可能的调用它的一切潜能，把任务分配给几个智能体，并且并行运行，由这个主智能体西西弗斯进行居中调度。这里他询问我要什么样的网页，我们大体填一下需求，然后开始。我们看到，他把任务拆分成了一个 Todo List ，然后同时开启了三个后台任务，并行执行。
Oh My OpenCode 还有一个重要玩法就是，我们输入这个命令 /rough-loop，就是拉尔夫循环。这个模式可以强制 AI 长时间的循环，对一个非常难的任务进行持续工作。比如我可以要求它，使用 SpringBoot 4 的最新标准重构整个项目，然后直到所有的测试用例都通过。它可以循环连续运行好几个小时，直到最终的任务完成。
刚才我们介绍了命令行、桌面版还有插件等运行环境，接下来我们看云端运行环境。这里我以 GitHub 举例，它的主要功能是，当我们在 GitHub 上面输入 /opencode，OpenCode 就可以在 GitHub 云端进行工作，比如可以为我们解释问题、自动修复问题，并且创建 PR 等等。这里有一个安装方式，我们来试一下。
首先第一步先把项目上传到 GitHub 上面，这里还是刚才那个宠物商店的应用。点击这里的 source control –> publish branch ，这里我选择 public ，把这个项目变成一个 GitHub 上面的公开仓库。
比如，某个用户可能会在 issue 里提一个 bug ，说顶部导航栏 find a pet 跟 adopt now 功能重复，应该去掉这个 find a pet，就是这两个功能重复。/opencode，调出 OpenCode 功能，让 OpenCode 把这个 bug 修复一下。我们提交这个评论。
接下来我们再介绍 OpenCode 的几个其他的重要功能。这些功能其实在之前的 Claude Code 还有 Codex 视频里面已经进行过介绍了，这里我们再快速的过一下。
首先第一个命令 /init。这个命令可以让 AI 通读整个项目文件夹，然后把它学到的关于整个项目的知识生成一个 AGENTS.MD 这个文件。这个文件就作为整个项目的系统提示词，可以帮助 AI 快速的了解项目。
下一个重要命令 /compact，用来压缩之前对话的上下文，把之前的对话提炼成一个简洁的摘要，来释放模型的上下文窗口。
除了这些内置的 / 命令以外，我们也可以创建自己的命令。我们来到 OpenCode 的配置文件夹，在这里面可以新建一个 command 的文件夹。在这里面就可以以 Markdown 文件的形式来定义自定义命令。build 或者 plan 模式，下面的命令，在下面的描述里面写清楚这个命令是做什么用的。配置完自定义命令，我们可以在 OpenCode 里面 / 命令的名字，这样就可以运行我们的自定义命令。
下一个功能可以定制智能体。OpenCode 里面预设了 plan 跟 build 两种智能体，我们也可以创建新的。我们来到 OpenCode 的配置文件夹，在这里面可以新建一个 agent 文件夹。primary，也就是主智能体。定义成主智能体以后，我们可以按 Tab 键，直接显式地切换到这个智能体进行工作，而 SubAgent 只能在后台由 AI 自动调度执行。
好，这就是本期视频的全部内容了。感谢大家点赞支持，我们下期再见。
这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.