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

主题

第4课 · 安装 OpenCode 终端版（TUI） ​

本节要点 ​

  • 安装 Node.js 运行环境
  • 用一条命令安装 OpenCode TUI（终端版）
  • 终端基础操作：cd、dir 等常用命令
  • 在 TUI 中切换模型、使用 Skills

1. 为什么要装终端版？ ​

前面我们用的 OpenCode Desktop（桌面版），图形界面友好，双击就能用。

终端版（TUI）有什么额外的？

对比桌面版终端版（TUI）
界面图形窗口终端字符界面
安装难度双击安装需要先装 Node.js
插件支持部分全部支持
操作方式鼠标点击键盘快捷键

💡 有一个重要的插件（oh-my-opencode-slim）依赖终端版才能运行，所以终端版必须装。

2. 安装 Node.js ​

OpenCode 终端版通过 npm（Node.js 的包管理器）安装，所以先装 Node.js。

下载 ​

从课程网盘中下载对应系统的安装包：

系统选择文件
Windows下载 .msi 安装包（推荐）；如果安不上，用免安装版
Mac下载 .pkg 安装包

安装 ​

双击安装包，一路下一步，不用改任何设置。

验证安装成功 ​

安装完成后，打开终端：

  • Windows：按 Win + R，输入 cmd，回车
  • Mac：打开"终端"应用

输入以下命令：

bash
node -v

如果显示版本号（如 v20.x.x），说明安装成功。

3. 终端基础命令（小白必读） ​

如果你从没用过终端，这里介绍几个最基本的命令，够用了。

Windows CMD 常用命令 ​

命令作用示例
cd 文件夹路径进入某个文件夹cd C:\Users\桌面\Excel合并工具
cd ..返回上一级文件夹cd ..
dir查看当前文件夹里有什么dir
cls清屏cls
exit关闭终端exit

Mac 终端常用命令 ​

命令作用示例
cd 文件夹路径进入某个文件夹cd ~/Desktop/Excel合并工具
cd ..返回上一级cd ..
ls查看当前文件夹里有什么ls
clear清屏clear
exit关闭终端exit

如何快速进入某个文件夹？ ​

方法一：手动输入路径

bash
cd C:\Users\你的用户名\Desktop\Excel合并工具

方法二：拖拽文件夹（推荐）

  1. 先输入 cd （注意 cd 后面有个空格）
  2. 把目标文件夹从资源管理器直接拖进终端窗口
  3. 按回车

💡 拖拽法最省心，不用手打路径。

盘符切换（Windows） ​

如果需要切换到 D 盘：

bash
D:

直接输入盘符加冒号，回车即可。

4. 安装 OpenCode TUI ​

在终端中执行以下命令（使用国内镜像，下载更快）：

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

⚠️ 注意包名是 opencode-ai，不是 opencode。

如果安装失败 ​

  • 确认 Node.js 已正确安装（node -v 能显示版本号）
  • Windows 用户尝试以管理员身份运行 CMD
  • 网络问题：确认使用了国内镜像地址

也可以让桌面版帮你装 ​

在 OpenCode Desktop 的对话框里直接说：

帮我安装 TUI 版本的 OpenCode，使用国内镜像

它会自动帮你执行安装命令。

5. 启动 OpenCode TUI ​

安装完成后，在终端中输入：

bash
opencode

就会进入 OpenCode 的终端界面。

选择项目目录 ​

启动时会让你选择一个项目目录（家目录）。你可以先用 cd 进入目标文件夹，再执行 opencode。

输入消息 ​

进入后直接输入文字，按回车发送，和桌面版一样。

6. TUI 常用操作 ​

操作快捷键
切换模型/model 然后选择
查看 Skills/skills
退出返回ESC
退出 OpenCode输入 exit 或 Ctrl + C

切换模型示例 ​

  1. 输入 /model
  2. 用方向键选择模型（如 DeepSeek V4 Flash）
  3. 按回车确认

查看 Skills ​

安装插件后，输入 /skills 可以看到已加载的技能列表。

7. 开启 TUI 桌面通知和提示音 ​

把 TUI 放在后台跑长任务时，AI 回复完了你可能不知道——它默认是静音的。

官方配置在 tui.json（或 tui.jsonc）的 attention 字段里，默认全部关闭。

一键开启（对 OpenCode 说） ​

把下面这段话完整复制粘贴给 OpenCode（桌面版或 TUI 都可以），让它精确地帮你写配置文件：

请帮我开启 OpenCode TUI 的通知功能。

  1. 根据我的系统，定位到正确的配置文件：
    • 如果是 Mac：~/.config/opencode/tui.json
    • 如果是 Windows：C:\Users<当前用户名>\AppData\Roaming\opencode\tui.json
  2. 确保父目录存在（不存在则创建）。
  3. 写入以下完整 JSON 内容。如果文件已存在，保留文件里其他所有字段，只覆盖或新增 attention 字段；如果文件不存在，则创建新文件：
json
{
  "$schema": "https://opencode.ai/tui.json",
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true,
    "volume": 0.4
  }
}
  1. 写完后告诉我文件路径，并提醒我重启 OpenCode TUI 生效。

注意：不要修改 attention 以外的任何配置。

配置项含义 ​

json
{
  "attention": {
    "enabled": true,       // 总开关，默认 false
    "notifications": true, // 终端触发桌面通知
    "sound": true,         // 提示音
    "volume": 0.4          // 音量 0.0 ~ 1.0
  }
}

手动找配置文件 ​

如果你习惯自己改：

系统配置文件路径
Mac~/.config/opencode/tui.json
WindowsC:\Users\你的用户名\AppData\Roaming\opencode\tui.json

生效条件 ​

修改完成后，重启 OpenCode TUI 才生效。

💡 提示音只在 TUI 窗口收到回复时触发；如果你把 TUI 最小化到后台，桌面通知会提醒你。

⚠️ 常见问题 ​

输入 opencode 提示"不是内部命令" ​

  • Node.js 没装好，重新安装
  • Windows：关闭 CMD 重新打开再试
  • 终端需要重启才能识别新安装的命令

npm install 速度很慢或卡住 ​

确认命令中包含国内镜像参数：

bash
--registry https://registry.npmmirror.com

Windows PowerShell 能运行，CMD 不能运行（或反过来） ​

Windows 有两个终端：CMD 和 PowerShell。如果你在其中一个能用 opencode，另一个不行，通常是以下原因：

PowerShell 提示"无法加载文件，因为在此系统上禁止运行脚本"：

以管理员身份打开 PowerShell，执行：

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。这条命令允许运行本地脚本，不影响安全性。

CMD 找不到命令但 PowerShell 能用（或反过来）：

重启电脑，让两个终端都刷新 PATH 环境变量。

💡 建议：安装完 Node.js 和 OpenCode 后，重启一下电脑，可以避免大部分路径和权限问题。

Windows 下看 Claude 思考过程乱码 / codex 来回"打架" ​

Windows 用户运行 OpenCode 时，可能出现两个奇怪现象：

  • 看 Claude 思考过程时一堆乱码——屏幕上出现莫名其妙的字符、闪烁、错位
  • codex（OpenAI 命令行工具）和 opencode 来回"打架"——两个工具互相抢占终端，看起来很乱

原因：Windows 系统自带的旧版 PowerShell（Windows PowerShell 5.x）对一些新的终端渲染字符支持不好，导致 opencode 显示异常。

解决方法（群友 Tabe 验证）—— 二选一即可：

方案一：安装最新版 Windows Terminal 并设为默认终端 ​

  1. 下载安装：访问微软官方下载页 https://learn.microsoft.com/zh-cn/windows/terminal/install ，下载 Windows Terminal（也可以直接在 Microsoft Store 搜索 "Windows Terminal" 一键安装）
  2. 设为默认终端：打开 Windows Terminal → 点击顶部下拉箭头 → 设置（齿轮图标）→ 启动 → 把「默认终端应用程序」改为 Windows Terminal → 保存
  3. 重新打开终端，运行 opencode，乱码和"打架"问题都会消失

方案二：升级 PowerShell 到 7 ​

不想换终端软件的话，也可以把系统自带的旧版 PowerShell 升级到 PowerShell 7（最新版）：

  1. 访问 https://learn.microsoft.com/zh-cn/powershell ，下载 PowerShell 7 安装包
  2. 双击安装，一路下一步
  3. 装完后，用 PowerShell 7 启动 opencode——开始菜单里搜 "PowerShell 7"，不再用旧的 "Windows PowerShell"

💡 群友 Tabe 的经验：两种方案都能解决 Windows 下看 opencode 思考过程乱码 + codex 回头打架的问题，任选其一即可。推荐方案一（Windows Terminal），因为它本身就是现代化的终端，复制粘贴、标签页、字体渲染都比系统自带的好用。

Mac 提示权限不足 ​

命令前加 sudo：

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

终端里没法复制粘贴？ ​

Windows 自带的 CMD 和 PowerShell 对复制粘贴的快捷键支持不好，经常出现 Ctrl + V 粘贴不进去的情况。

解决办法：换用 Warp 终端（推荐）

Warp 是一个现代化的终端，操作更人性化，支持鼠标点击、正常的复制粘贴，比系统自带的终端好用很多。

  • 下载地址：课程百度网盘里提供了 Warp 安装包
  • 安装后桌面会有图标，双击就能打开
  • 使用方法和普通终端一样：先用 cd 进入项目文件夹，再输入 opencode 启动

💡 群友冰的反馈：在 OpenCode 界面无法使用复制粘贴的快捷键，换成 Warp 终端后解决。nigo 原话："这个终端好使。"

💡 Windows 用户注意：上方「Windows 下看 Claude 思考过程乱码」一节推荐的 Windows Terminal 也能正常复制粘贴。如果你已经装了 Windows Terminal，就不必再装 Warp 了——Warp 的额外优势是内置 AI 命令补全、命令分组等进阶功能，感兴趣的同学可以试。

不想学终端命令怎么办？ ​

如果你觉得终端命令（cd、dir 等）太难学，可以直接用桌面版——所有操作在桌面版里都能完成，功能一样。

nigo 的建议：

如果你要用终端版本，先必须把常用终端命令学会，不然你不会操作。如果不会操作终端，又不想学，直接用桌面版本，所有操作都可以用桌面版本完成。

终端版的优势主要在于插件支持更全，如果你暂时用不到高级插件，桌面版完全够用。

8. 关键收获 ​

TIP

终端版安装就三步：装 Node.js → 一条 npm 命令装 OpenCode → 输入 opencode 启动。之后安装插件和高级功能都依赖它。

下一步 ​

终端版装好后，进入第5课安装两个增强插件，让 OpenCode 变得更聪明。

© 2025 逆行的狗