词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
界面与基础操作
💡 一句话总结：掌握 @引用文件、!执行命令、/斜杠命令，你就能驾驭 OpenCode。
📝 课程笔记
学完你能做什么
@ 引用项目中的文件! 执行 系统命令/ 调用斜杠命令你现在的困境
什么时候用这一招
🎒 开始前的准备
确保你已经完成以下事项：
核心思路
TUI 界面导览
┌─────────────────────────────────────────────────┐
│ OpenCode v1.0.0 Build 模式 │ ← 状态栏/头部
├─────────────────────────────────────────────────┤
│ │
│ AI: 你好！有什么我可以帮你的？ │ ← 对话区
│ │
├─────────────────────────────────────────────────┤
│ > 随便问点什么... │ ← 输入区
└─────────────────────────────────────────────────┘| 区域 | 作用 |
|---|---|
| 状态栏/头部 | 显示版本、当前模式（Plan/Build）、Token 用量 |
| 侧栏 | 会话列表（宽屏自动显示，窄屏隐藏） |
| 对话区 | AI 回复和你的消息历史 |
| 输入区 | 你输入消息的地方（不同模式有不同提示） |
session.toggle.sidebar 命令手动切换随便问点什么...输入 shell 命令...总结评论...session.toggle.header 即可切换:::
核心操作三件套
| 符号 | 作用 | 示例 |
|---|---|---|
@ | 引用文件 | @src/main.ts 这个文件做了什么 |
! | 执行命令 | !ls -la 查看目录 |
/ | 斜杠命令 | /help 查看帮助 |
跟我做
第 1 步：启动 OpenCode 并进入项目
在项目目录下启动，AI 才能看到你的代码文件。
第 2 步：让 AI 介绍自己
验证基础对话功能正常。
你好，请简单介绍一下你自己第 3 步：用 @ 引用文件
这是 OpenCode 最强大的功能——让 AI 直接读取你的文件。
@package.json 这个文件描述了什么项目💡 搜索补全
@ 后会看到 Agent 列表（如 @explore）和文件夹。继续输入文件名的部分内容（如 @pack），才会搜索并显示匹配的具体文件，用方向键选择后按 Enter 确认。第 4 步：用 ! 执行命令
让 AI 能看到命令的执行结果。
!ls -la帮我查看当前目录有哪些文件第 5 步：用 / 调用斜杠命令
斜杠命令是 OpenCode 的内置功能入口。
/help| 命令 | 作用 |
|---|---|
/help | 查看帮助 |
/new | 新建会话 |
/models | 切换模型 |
/theme | 切换主题 |
/exit | 退出 |
💡 界面自定义命令
session.toggle.sidebar - 切换侧栏显示session.toggle.header - 切换头部显示第 6 步：学会常用快捷键
快捷键能让你操作更快。
| 快捷键 | 作用 |
|---|---|
| Tab | 切换 Plan/Build 模式 |
| Ctrl+C | 中断当前操作 |
| Ctrl+L | 清屏 |
| Ctrl+X | Leader 键（前缀键） |
| Ctrl+X N | 新建会话 |
| Esc | 取消/返回 |
检查点 ✅
全部通过才能继续
@文件名 能引用到项目文件!命令 能执行系统命令/help 能看到帮助信息踩坑提醒
| 现象 | 原因 | 解决 |
|---|---|---|
@ 后没有文件补全 | 不在项目目录下 | cd 到项目目录重新启动 |
! 命令报权限错误 | OpenCode 拦截了危险命令 | 确认命令安全后按 y 允许 |
| 快捷键不生效 | 终端劫持了按键 | 检查终端设置，或换一个终端 |
本课小结
1.
2.
@ 引用、! 执行、/ 命令）3.
下一课预告
下一课我们学习 如何复制内容。 你会学到： 为什么 Ctrl+C 不能复制 Win/Mac 如何用鼠标复制 怎样复制 AI 的长代码
修改于 2026-05-31 05:44:10