第1课 · 安装 OpenCode Desktop
本节要点
- OpenCode Desktop 下载与安装
- 项目文件夹的概念
- 免费 AI 模型选择
- 零配置上手:无需登录,双击即用
1. 为什么选择 OpenCode
| 优势 | 说明 |
|---|---|
| 开源免费 | 不需要付费订阅 |
| 支持国内外所有大模型 | 国内模型直接接入,不需要梯子 |
| 安装简单 | 桌面版双击安装,终端版一条命令 |
| 无需登录 | 打开就能用 |
2. 下载与安装
步骤一:打开官网
在浏览器搜索 OpenCode,进入官网后点击 Download。
下载页面提供三个版本:
| 版本 | 说明 |
|---|---|
| 桌面版(Desktop) | 推荐新手使用,图形界面,双击安装 |
| 终端版(Terminal) | 在终端中运行,适合进阶用户 |
| 扩展版 | VS Code 等编辑器插件 |
步骤二:下载安装包
根据你的系统选择:
- Windows:下载
.exe安装包 - Mac:下载
.dmg安装包
步骤三:安装
双击安装包,按提示完成安装。
💡 安装过程中不需要任何配置,一路下一步即可。
3. 打开项目文件夹
安装完成后,打开 OpenCode,会看到一个选择项目文件夹的界面。

什么是"项目"?
可以理解为一个工作空间——就像你做审计项目时的项目文件夹:
你选择的文件夹/
├── 你放进去的数据文件(Excel、PDF 等)
├── AI 生成的工具代码
├── AI 生成的结果文件
└── ...- 你需要的数据可以放进去
- AI 生成的产物也会在里面
- 做好权限隔离——AI 只能操作这个文件夹,读其他地方会询问你
什么是"会话"?
每次你打开 OpenCode 开始一段对话,就是一个会话(Session)。
你可以把它理解为一个聊天窗口——就像微信里和不同人的聊天记录:
- 每个会话是独立的,互不干扰
- 关掉 OpenCode 后,会话历史会保留,下次打开还能接着聊
- 在同一个项目中可以创建多个会话,比如一个做数据清洗、一个做底稿分析
- 如果 AI 跑偏了,可以直接开一个新会话重新开始
💡 实际使用中,一个大任务用一个会话就行。做完关掉,下次有新任务再开新的。
操作
- 新建一个文件夹(比如叫
Excel合并工具) - 在 OpenCode 中选择这个文件夹
- 进入对话界面
4. 选择 AI 模型
进入对话界面后,可以看到可用的模型列表。
OpenCode 默认提供免费模型,无需任何配置即可使用:
| 模型 | 说明 |
|---|---|
| MIMO 2.5 | 小米出品,免费 |
| DeepSeek V4 Flash Free | DeepSeek 出品,免费 |
免费模型每天有约 200 次调用额度,尝鲜和学习完全够用。
💡 如果需要更稳定的服务,可以接入自己的 API Key(DeepSeek、GLM 等),后续课程会介绍。
5. 开始第一次对话
选择模型后,就可以直接输入文字和 AI 对话了:
- 在输入框中输入你的需求(也可以用语音输入)
- AI 会自动帮你完成
- 不需要说"请",直接说需求就行
⚠️ 安装与常见问题
Windows 安装提示"无法打开"
右键安装包 → 属性 → 勾选"解除锁定"(如果有的这个选项)→ 重新双击安装。
Mac 提示"无法验证开发者"
- 系统偏好设置 → 安全性与隐私
- 点击"仍要打开"
- 或者在终端执行:
xattr -cr /Applications/OpenCode.app
免费额度用完了怎么办
- 可以第二天再继续(额度每天重置)
- 或者接入自己的 API Key,按量付费(DeepSeek 等国内模型非常便宜)
- 后续课程会详细介绍如何配置 API
想用终端版本
如果后续想用终端版(功能更强大),可以在终端执行:
bash
# Mac
brew install opencode
# 或者用 npm
npm install -g opencode6. 关键收获
TIP
OpenCode Desktop 的核心体验:双击安装 → 选个文件夹 → 选个免费模型 → 开始对话。全程不需要注册账号、不需要配置、不需要梯子。
下一步
安装好 OpenCode 后,进入第2课动手做你的第一个效率工具吧!