Skip to content

第1课 · 安装 OpenCode Desktop

本节要点

  • OpenCode Desktop 下载与安装
  • 项目文件夹的概念
  • 免费 AI 模型选择
  • 零配置上手:无需登录,双击即用

1. 为什么选择 OpenCode

优势说明
开源免费不需要付费订阅
支持国内外所有大模型国内模型直接接入,不需要梯子
安装简单桌面版双击安装,终端版一条命令
无需登录打开就能用

2. 下载与安装

步骤一:打开官网

在浏览器搜索 OpenCode,进入官网后点击 Download

opencode 官网

下载页面提供三个版本:

版本说明
桌面版(Desktop)推荐新手使用,图形界面,双击安装
终端版(Terminal)在终端中运行,适合进阶用户
扩展版VS Code 等编辑器插件

步骤二:下载安装包

根据你的系统选择:

  • Windows:下载 .exe 安装包
  • Mac:下载 .dmg 安装包

步骤三:安装

双击安装包,按提示完成安装。

💡 安装过程中不需要任何配置,一路下一步即可。


3. 打开项目文件夹

安装完成后,打开 OpenCode,会看到一个选择项目文件夹的界面。

什么是"项目"?

可以理解为一个工作空间——就像你做审计项目时的项目文件夹:

你选择的文件夹/
├── 你放进去的数据文件(Excel、PDF 等)
├── AI 生成的工具代码
├── AI 生成的结果文件
└── ...
  • 你需要的数据可以放进去
  • AI 生成的产物也会在里面
  • 做好权限隔离——AI 只能操作这个文件夹,读其他地方会询问你

什么是"会话"?

每次你打开 OpenCode 开始一段对话,就是一个会话(Session)

你可以把它理解为一个聊天窗口——就像微信里和不同人的聊天记录:

  • 每个会话是独立的,互不干扰
  • 关掉 OpenCode 后,会话历史会保留,下次打开还能接着聊
  • 在同一个项目中可以创建多个会话,比如一个做数据清洗、一个做底稿分析
  • 如果 AI 跑偏了,可以直接开一个新会话重新开始

💡 实际使用中,一个大任务用一个会话就行。做完关掉,下次有新任务再开新的。

操作

  1. 新建一个文件夹(比如叫 Excel合并工具
  2. 在 OpenCode 中选择这个文件夹
  3. 进入对话界面

4. 选择 AI 模型

进入对话界面后,可以看到可用的模型列表。

OpenCode 默认提供免费模型,无需任何配置即可使用:

模型说明
MIMO 2.5小米出品,免费
DeepSeek V4 Flash FreeDeepSeek 出品,免费

免费模型每天有约 200 次调用额度,尝鲜和学习完全够用。

💡 如果需要更稳定的服务,可以接入自己的 API Key(DeepSeek、GLM 等),后续课程会介绍。


5. 开始第一次对话

选择模型后,就可以直接输入文字和 AI 对话了:

  1. 在输入框中输入你的需求(也可以用语音输入)
  2. AI 会自动帮你完成
  3. 不需要说"请",直接说需求就行

⚠️ 安装与常见问题

Windows 安装提示"无法打开"

右键安装包 → 属性 → 勾选"解除锁定"(如果有的这个选项)→ 重新双击安装。

Mac 提示"无法验证开发者"

  1. 系统偏好设置 → 安全性与隐私
  2. 点击"仍要打开"
  3. 或者在终端执行:xattr -cr /Applications/OpenCode.app

免费额度用完了怎么办

  • 可以第二天再继续(额度每天重置)
  • 或者接入自己的 API Key,按量付费(DeepSeek 等国内模型非常便宜)
  • 后续课程会详细介绍如何配置 API

想用终端版本

如果后续想用终端版(功能更强大),可以在终端执行:

bash
# Mac
brew install opencode

# 或者用 npm
npm install -g opencode

6. 关键收获

TIP

OpenCode Desktop 的核心体验:双击安装 → 选个文件夹 → 选个免费模型 → 开始对话。全程不需要注册账号、不需要配置、不需要梯子。


下一步

安装好 OpenCode 后,进入第2课动手做你的第一个效率工具吧!

© 2025 逆行的狗