简介

最近做数字系统作业时，了解了一些 AI 编程工具，发现 OpenCode 是一个提供免费 API 的 AI Agent（智能体），同时安装特别简便，全程无需“魔法”（虚拟专用网络）。虽然它的能力逊色于 Claude Code 和 Codex， 但特别适合零成本体验 AI 编程

如果你恰好对 AI 编程有所兴趣，可以看看我这篇笔记，它可以帮助你大致了解 AI Agent 是干什么的，同时高效地避开安装上的各种坑，以及查阅相关的指令

用途

• 开发各种项目
• 分析文件，数据可视化
• 编写文档、PPT、网站
• 配置和管理电脑

简单地说，它比网页端 AI 更便捷，因为它可以自主访问和操作文件，可以自我调试和迭代工程

一切指令以最新版官方文档为准！（见参考资料）

教程

安装（Windows）

1. 安装 Node.js
   Windows端无法通过终端直接安装 OpenCode，需要先安装 Node.js
   在 Node.js 下载官网安装 .msi 文件后， npm 也会自动安装
2. 打开终端
   快捷键：Win+R $\to$ cmd $\to$ 确定
3. 安装 OpenCode
   在终端中输入

   npm install -g opencode-ai
   

如果想在 VSCode 中运行，还需在扩展商店中安装对应名字的插件

运行

1. 打开终端
2. 切换到目标文件夹

   cd /文件夹路径
   

   或直接打开文件夹，右键$\to$ “在终端中打开”
3. 打开 OpenCode
   在终端中输入

   opencode
   

接入大模型

1. 接入 API
   输入指令

   /connect
   

   推荐 OpenCode Zen（官方精选模型列表），其中包含免费 LLM
   根据指示在网站中创建账户，生成 API Key ，并将其复制到 OpenCode 中

2. 选择模型

   /models
   

   里面带Free标签的免费LLM（如目前更新的 DeepSeek V4 Flash ）

使用技巧

1. 初始化

   /init
   

   OpenCode 会分析该文件夹中的各个文件，并总结出一份 AGENTS.md 文档，以便后续开发

2. 添加附件
   使用 @ +文件名
   通过添加样例文件，AI可以更好地理解你的要求

3. 切换模式
   用 Tab 键切换 Plan 模式和 Build 模式
   Plan 模式不会对文件进行操作，确保 AI 正确理解了你的要求，以免误操作（强烈推荐！）

4. 撤销操作
   如果还是进行了误操作，一般情况可通过以下指令恢复

   /undo
   

5. 分享对话

   /share
   

   可在浏览器中粘贴链接并打开

6. 查看历史对话

   /sessions
   

7. 压缩上下文

   /compact
   

   避免 Token 溢出、速度降低或思维混乱

8. 使用 skills （拓展功能）

   /skills
   

   一般情况下，模型会自己触发调用skills

   💡 skills 可以在模型市场网站中获取（如 skillsmp），并通过终端指令安装

以上就是快速上手 OpenCode 的相关内容，欢迎在评论区补充和讨论！

参考资料

• OpenCode官方文档
• 「从夯到拉」2026年AI编程工具全景测评
• Node.js 与 npm 的安装与配置（详细教程）