一个人 + AI = 财务审计团队

主题

第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

桌面版打开很慢、一直卡住怎么办 ​

桌面版第一次打开特别慢，可能卡住十几分钟甚至闪退，这是正常的——尤其是用网盘下载的旧版本安装包，版本比较旧，OpenCode 更新时会反复占用导致卡顿。

解决方法（群友彭程验证）：

  1. 先关掉桌面版，改用终端版启动一次，让它把版本升级到最新（网盘包通常是 15.x，需要升级到 17.x 以上）
  2. 升级完之后，桌面版再打开就正常了
  3. 如果只是第一次慢，也可以等一会儿，或者关掉重新打开，第一次跑完后续就快了

💡 小建议：桌面版第一次很慢是常态（群友 SUMMER 反映能卡 10 来分钟）。急用的话，直接从终端版进去，速度更快也更稳定。

桌面版用着用着突然登不上 / 整个卡住怎么办 ​

桌面版第一次能正常打开，但用了一段时间后突然登录失败、输入没反应、或者整个界面卡死——这在 Windows 桌面版上比较常见。

解决方法（按顺序试）：

  1. 装最新版：去 opencode.ai 重新下载安装最新版本覆盖安装，很多卡死是旧版本的 bug
  2. 用另一个 AI 工具修：如果 OpenCode 自己动不了，可以打开另一个 AI 工具（比如 Workbuddy，有 3 次免费额度）让它帮你修；或者用 OpenCode 的终端版来修桌面版
  3. 还不行就重装：控制面板卸载 OpenCode → 重新安装 → 把之前的 skills 文件夹复制回去就行，插件不用重装

💡 群友经验：Windows 桌面版的稳定性确实不如终端版（群友反映终端版问题少、还更流畅）。如果桌面版反复出问题，建议直接转用终端版——参考上面的「想用终端版本」。

升级到 1.17.10 后报错/崩溃怎么办（Windows） ​

2026 年 6 月下旬，OpenCode 桌面版和终端版自动升级到 1.17.10 后，部分 Windows 用户遇到崩溃、输入 / 斜杠命令时闪退，或启动时报 bun 相关错误。

原因：1.17.10 在 Windows 上的兼容性有问题，不是你自己电脑坏了。

解决方法（群友验证）：回退到 1.17.9

终端版回退：在终端执行下面这条命令（Windows 用 PowerShell，Mac 用 Terminal）：

bash
npm install -g opencode-ai@1.17.9 --registry https://registry.npmmirror.com

装好后输入 opencode --version 确认版本号是 1.17.9，再启动就正常了。

桌面版回退：

  1. 卸载当前的桌面版
  2. 去 OpenCode 官网或应用下载站找 1.17.9 的旧版本安装包重新安装
  3. 安装后先断网再打开桌面版，避免它自动更新回 1.17.10；或者在设置里关闭自动更新

如果找不到旧版本安装包，可以先用终端版 1.17.9顶着，功能和桌面版基本一致。

⚠️ 注意：这个问题是 1.17.10 特定版本导致的，后续版本修复后就不用再回退了。先用 1.17.9 顶着，等官方发新版再升级。

安装进度条卡住十几分钟不动 ​

有同学反馈双击安装包后，进度条停留很久（十几分钟）都没有进展。这通常不是电脑坏了，而是安装程序在后台下载/解压更新包。

解决方法：

  1. 先等 20-30 分钟，不要反复取消重装（重装会从头再来）
  2. 如果一直不动，杀掉进程重新安装一次
  3. 还是不行的话，跳过桌面版，先装终端版：npm install -g opencode 或 npm install -g opencode-ai，从终端启动更稳定

用 warp 终端时内存占用飙升到 90%+ ​

Windows 用户反馈：在 warp 终端里运行 OpenCode，不跑任务就占 4G 内存，复杂任务直接冲到 90% 以上触发 Windows 保护关闭 warp。

原因：warp 终端本身较重的 UI 框架 + OpenCode 的会话缓存叠加，在部分 Windows 电脑上容易爆内存。

解决方法：

  • 不用 warp，换系统自带的 PowerShell 或 Windows Terminal
  • 如果已经爆内存，杀掉 warp 和 OpenCode 进程，重新用 PowerShell 启动
  • 长期方案：复杂任务建议用终端版 opencode 命令，比桌面版 + 第三方终端更省资源

安装插件后报错、闪退、功能异常怎么办 ​

安装插件后，OpenCode 可能出现启动报错、输入 / 命令闪退、模型列表消失、U 盘/文件夹权限被改等奇怪问题。

终极重置大法（群友验证）：

  1. 完全退出 OpenCode
  2. 找到配置文件 opencode.jsonc，直接删除或重命名
    • Windows：C:\Users\你的用户名\.config\opencode\opencode.jsonc
    • Mac：~/.config/opencode/opencode.jsonc
  3. 重新打开 OpenCode，配置文件会自动重建

⚠️ 插件不是必须的！ nigo 原话：删掉配置文件、不装插件，OpenCode 一样能用。等熟悉了再慢慢装插件。

6. 关键收获 ​

TIP

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

下一步 ​

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

© 2025 逆行的狗