人工智能研究
群组类型 大学
活跃于 2 天, 2 時前
GPT4、Claude等人工智能产品的理论（通识面向）与应用研究。
主权个人必看的 OpenCode 教程之第二课（2026版）
-
-
2026 年 1 月 24 日 上午 6:12 #32868
本节课我们将一起探讨如何上手OpenCode，主要分为四个递进的部分，建议按顺序学习：
部分 内容 学完能做什么 一、快速上手 界面认知、核心操作、工作模式 开始使用 OpenCode 完成基本任务 二、效率进阶 复制技巧、会话管理、快捷键 操作效率翻倍，不再被小问题卡住 三、个性定制 规则文件、环境管理 让 AI 永久记住你的偏好 四、速查手册 命令表、快捷键表、排错指南 随时查阅，快速解决问题 💡 一句话理解：
@引用文件、!执行命令、/调用功能——掌握这三板斧，你就能驾驭 。一、快速上手
这一部分帮你在 15 分钟内从零开始使用 OpenCode。
1.1 认识界面
在项目目录下运行
opencode启动后，你会看到一个终端用户界面（TUI）。这个界面由 SST 团队精心打造，分为三个功能区域：┌─────────────────────────────────────────────────────────────────┐ │ OpenCode v1.x.x Build 模式 ⚡ │ ← ① 状态栏 ├─────────────────────────────────────────────────────────────────┤ │ │ │ You: @src/main.ts 这个文件是做什么的？ │ │ │ │ AI: 这是项目的入口文件，主要做了以下几件事... │ ← ② 对话区 │ 1. 初始化配置 │ │ 2. 启动 HTTP 服务器 │ │ ... │ │ │ ├─────────────────────────────────────────────────────────────────┤ │ > 在这里输入你的消息... │ ← ③ 输入区 └─────────────────────────────────────────────────────────────────┘三个区域的作用
区域 位置 功能 你需要关注什么 状态栏 顶部 显示版本号、当前模式、Token 用量 右侧的模式指示器（Build/Plan） 对话区 中间 展示你与 AI 的对话历史 AI 的回复会实时流式显示，支持 Markdown 渲染和代码高亮 输入区 底部 输入消息的地方 支持多行输入、历史记录、自动补全 为什么要在项目目录下启动？
这是一个关键点：OpenCode 会以启动时的目录作为工作根目录。
- 在项目目录启动：
@能引用项目文件，AI 能理解项目结构 - 在随便一个目录启动：AI 看不到你的代码，只能泛泛而谈
# ✅ 正确做法 cd ~/my-project opencode # ❌ 错误做法 cd ~ opencode # AI 能看到你整个 home 目录，但找不到具体项目💡 最佳实践：养成习惯，先
cd到项目目录，再启动 OpenCode。1.2 核心三板斧：@、!、/
这三个符号是 OpenCode 的灵魂。记住它们，你就掌握了 80% 的日常操作。
@ 引用文件——让 AI 看到你的代码
@是 OpenCode 最强大的功能。它让 AI 能够直接读取你的项目文件，而不是让你手动复制粘贴代码。基础用法：
@package.json 这个项目是做什么的？当你输入
@时，OpenCode 会：- 识别出你要引用文件
- 读取文件内容
- 把内容作为上下文发送给 AI
文件选择器：
输入
@后按Tab键，会弹出一个模糊搜索选择器：┌─────────────────────────────────┐ │ 🔍 输入文件名搜索... │ ├─────────────────────────────────┤ │ > src/main.ts │ │ src/utils/helper.ts │ │ src/components/Button.tsx │ │ package.json │ │ tsconfig.json │ └─────────────────────────────────┘用方向键选择，
Enter确认。支持模糊匹配，输入btn就能找到Button.tsx。进阶技巧：
用法 示例 说明 引用特定行 @src/main.ts#L10-25只引用第 10-25 行，适合大文件 引用多个文件 @file1.ts @file2.ts 对比这两个一次引用多个文件进行对比 引用目录 @src/components/引用整个目录结构（不含文件内容） ⚠️ 注意：引用超大文件（几千行）会消耗大量 Token。建议用行号引用只取需要的部分。
! 执行命令——让 AI 看到命令输出
!让你可以在对话中直接执行 shell 命令，命令输出会自动加入 AI 的上下文。基础用法：
!git status执行后，AI 会看到类似这样的输出：
On branch main Your branch is up to date with 'origin/main'. Changes not staged for commit: modified: src/main.ts modified: src/utils.ts现在 AI 知道了你修改了哪些文件，可以给出更精准的建议。
实用场景：
场景 命令示例 AI 能得到什么信息 了解项目结构 !ls -la目录下有哪些文件 查看 Git 状态 !git status哪些文件被修改了 查看最近提交 !git log --oneline -10项目的开发历史 运行测试 !npm test测试结果和报错信息 查看错误日志 !cat error.log具体的错误内容 💡 更自然的方式：你也可以直接用自然语言让 AI 执行命令：
帮我看看当前目录有哪些文件AI 会自动调用 bash 工具执行
ls命令。!是给你直接控制用的，自然语言是让 AI 自主决定。⚠️ 安全机制：
OpenCode 会拦截可能有危险的命令（如
rm -rf）。当检测到危险命令时：⚠️ 该命令可能有风险：rm -rf node_modules 确认执行？[y/N]按
y确认，按n或直接回车取消。这是为了防止 AI 误操作删除重要文件。/ 斜杠命令——OpenCode 的内置功能
/开头的命令是 OpenCode 的内置功能入口，类似于 Slack 或 Discord 的斜杠命令。使用方式：
/help输入
/后会弹出命令列表，可以用方向键选择或继续输入筛选。常用命令一览：
命令 作用 使用场景 /help查看所有命令 忘了有什么命令时 /new新建会话 开始一个新任务 /sessions查看并切换会话 在多个任务间切换 /undo撤销 AI 的操作 AI 改错了代码 /redo重做被撤销的操作 撤销撤多了 /compact压缩对话上下文 对话太长，节省 Token /export导出对话为 Markdown 保存重要对话 /models切换模型 换个模型试试 /themes切换主题 换个界面风格 /init自动生成项目规则文件 让 AI 分析项目并生成配置 别名支持：
很多命令有别名，用哪个都行：
主命令 别名 /new/clear/sessions/resume,/continue/compact/summarize/exit/quit,/q1.3 两种工作模式：Plan 与 Build
OpenCode 有两种内置的工作模式，代表两种不同的工作哲学。理解它们是高效使用 OpenCode 的关键。
模式对比
模式 权限 特点 适用场景 Build（默认） 完全访问 可以读写文件、执行命令、修改代码 日常开发、实际编码 Plan 只读 只能分析和建议，不能修改任何东西 探索代码库、制定方案 切换方式
按
Tab键即可在两种模式间切换。右下角状态栏会显示当前模式。设计哲学
这种设计非常聪明，它解决了一个常见问题：AI 还没理解清楚就开始乱改代码。
推荐工作流：
1. 切换到 Plan 模式（按 Tab） 2. 让 AI 分析代码：分析一下这个模块的架构 3. 讨论方案：我想加个缓存功能，怎么实现？ 4. 满意后切换到 Build 模式（按 Tab） 5. 让 AI 执行：按我们讨论的方案实现💡 为什么叫 “Plan” 和 “Build”？
这借鉴了软件工程的经典思想：先规划，再执行。Plan 模式让你可以放心地让 AI 探索整个代码库，因为它不会意外修改任何文件。当你对方案满意后，再切到 Build 模式执行。
进阶：@general 子代理
除了 Plan 和 Build，OpenCode 还有一个通用子代理，可以用
@general调用：@general 找出所有处理用户认证的 API 端点@general是一个多面手，适合复杂的多步骤任务。它有完整的工具访问权限，可以并行执行多个子任务。1.4 第一次使用：跟我做
现在让我们把上面学的串起来，完成一次完整的使用流程。
步骤 1：启动 OpenCode
cd ~/your-project # 换成你的项目路径 opencode步骤 2：让 AI 认识你的项目
less@package.json @README.md 介绍一下这个项目AI 会读取这两个文件，然后给出项目概览。
步骤 3：用 Plan 模式探索
按
Tab切换到 Plan 模式（看右下角确认）。分析一下 src 目录的代码结构，告诉我主要模块有哪些因为是 Plan 模式，AI 只会分析和报告，不会修改任何文件。
步骤 4：切换到 Build 模式执行任务
按
Tab切换回 Build 模式。帮我在 src/utils 下创建一个 logger.ts，实现一个简单的日志工具AI 会创建文件并写入代码。
步骤 5：验证并撤销（可选）
如果对结果不满意：
/undo文件会被恢复到 AI 修改前的状态。
二、效率进阶
掌握了基础操作后，这一部分帮你提升效率，解决日常使用中的痛点。
2.1 复制的正确姿势
🚨 这是新手最常见的困惑：为什么按
Ctrl+C程序退出了？！为什么 Ctrl+C 不是复制？
这是终端世界和图形界面世界的文化冲突。
在 1970 年代的 Unix 系统中，
Ctrl+C被定义为中断信号（SIGINT），用来终止正在运行的程序。这个约定沿用至今，几乎所有终端程序都遵守。环境 Ctrl+C 的含义 Word、浏览器、VS Code 📋 复制到剪贴板 终端程序（包括 OpenCode） 🛑 发送中断信号 OpenCode 中 Ctrl+C 的实际行为：
当前状态 按 Ctrl+C 的效果 输入框有内容 清空输入框（不退出） 输入框为空 退出 OpenCode AI 正在响应 中断 AI 的响应 这其实很合理：和终端的行为保持一致，程序员会很熟悉。但对于习惯图形界面的用户，确实需要适应。
四种复制方式
OpenCode 提供了多种复制方式，适应不同场景：
方式一：鼠标拖选（最直觉）
操作：用鼠标拖选文字 → 松开 → 完成
没错，就这么简单。你不需要按任何键。在松开鼠标的一瞬间，OpenCode 会自动把选中的内容复制到剪贴板，并显示
Copied to clipboard提示。这是 OpenCode 专门为现代用户设计的”隐藏技能”，Mac 和 Windows 通用。
⚠️ 已知问题：在某些终端（如 Windows Terminal 的特定版本）可能不工作。如果遇到问题，用下面的保底方式。
方式二：键盘快捷键（最快）
操作：
Ctrl+X→ 松开 →Y这会复制 AI 最后一条完整回复到剪贴板。当你只想要 AI 刚说的那段话（比如一大段代码），这比鼠标拖选快得多。
记忆口诀：
Y= Yank，这是 Vim 编辑器中”复制”的术语。方式三：命令复制（最全）
操作：输入
/copy回车这会把整个对话历史（你说的话 + AI 说的话）都复制到剪贴板。适合你想把对话分享给同事或保存到文档的场景。
方式四：系统原生选择（保底）
如果上面的方法都不工作，可以绕过 OpenCode，直接使用终端的原生选择功能：
系统 操作 Mac 按住 Option (⌥)+ 鼠标拖选 →Cmd+CWindows 按住 Shift+ 鼠标拖选 → 右键或Enter这种方式适用于：
- OpenCode 卡死没反应时
- 通过 SSH 远程使用时
- 需要精确复制报错信息时
退出程序的正确姿势
既然
Ctrl+C有可能退出程序，那正确的退出方式是什么？退出方式 性质 推荐度 Ctrl+D优雅退出，触发清理逻辑 ⭐⭐⭐ 推荐 /exit或/quit命令退出 ⭐⭐⭐ 推荐 Ctrl+C（输入框为空时）可能导致 Windows 鼠标乱码 ⚠️ 不推荐 💀 Windows 用户注意：用
Ctrl+C强制退出可能导致鼠标乱码问题。这是因为 OpenCode 开启了鼠标监听模式，强制退出时没来得及关闭，终端会把鼠标坐标当成文字显示。解决方法：关闭终端窗口重新打开。预防方法：用
Ctrl+D退出。2.2 会话管理
为什么需要多个会话？
想象一下这个场景：
你正在修复一个 bug，和 AI 讨论了很久，上下文里全是关于这个 bug 的信息。突然老板让你临时处理另一个紧急任务。你直接在同一个会话里开始新任务，AI 会把两件事的上下文混在一起，给出莫名其妙的回答。
多会话的好处：
优势 说明 隔离上下文 不同任务用不同会话，AI 不会混淆 并行工作 一个会话写代码，另一个会话分析文档 保留历史 重要对话可以保留，随时回看 节省 Token 新会话从零开始，不累计旧上下文 核心操作
你想做什么 命令 快捷键 新建会话 /newCtrl+X → N查看会话列表并切换 /sessionsCtrl+X → L撤销 AI 的操作 /undoCtrl+X → U重做被撤销的操作 /redoCtrl+X → R压缩过长的对话 /compactCtrl+X → C导出对话记录 /exportCtrl+X → X新建会话
/new或按
Ctrl+X → N（先按 Ctrl+X，松开，再按 N）。💡 命名技巧：
/new 重构用户登录模块带上任务名称，日后在会话列表中一眼就能找到。
切换会话
/sessions或按
Ctrl+X → L。会弹出会话列表：┌─────────────────────────────────────────────┐ │ 会话列表 │ ├─────────────────────────────────────────────┤ │ > 重构用户登录模块 (3 条消息) 10分钟前 │ │ 修复支付接口 bug (15 条消息) 1小时前 │ │ 分析项目架构 (8 条消息) 昨天 │ └─────────────────────────────────────────────┘用
↑↓选择，Enter切换。撤销操作（重要！）
/undo这是一个救命功能。当 AI 改错了代码，
/undo可以恢复到修改前的状态。工作原理：
/undo会同时：- 移除对话中的最后一轮（你的消息 + AI 的回复）
- 恢复 AI 修改的所有文件
⚠️ 依赖 Git：
/undo通过 Git 来追踪文件变化。如果项目不是 Git 仓库，只能撤销对话，不能恢复文件。初始化 Git 仓库：
git init git add . git commit -m "init"这样
/undo就能完整工作了。压缩对话
/compact当对话变得很长时，会：
- 消耗大量 Token（费钱）
- AI 可能开始遗忘早期的上下文
/compact会让 AI 总结当前对话的要点，然后清理掉详细的历史消息，只保留摘要。什么时候用 /compact vs /new？
场景 推荐操作 继续当前任务，但对话太长 /compact开始一个完全不相关的新任务 /new当前任务卡住了，想换个思路 /new导出对话
/export将对话导出为 Markdown 文件。适合：
- 保存重要的技术讨论
- 分享给同事
- 存档备查
2.3 快捷键系统
OpenCode 有 60+ 快捷键，但日常只需掌握核心的 15 个。
Leader 键机制（必须理解）
这是 OpenCode 快捷键的核心机制。如果你只记住一件事，记住这个。
什么是 Leader 键？
Leader 键是一个前缀键，默认是
Ctrl+X。它不直接触发功能，而是开启一个”等待窗口”，等你按下后续的字母键。操作方式（三步法）：
┌─────────────────────────────────────────────────────────┐ │ │ │ 第 1 步 第 2 步 第 3 步 │ │ 按下 Ctrl+X → 松开所有键 → 按下字母键 │ │ │ │ ⚠️ 关键：第 2 步必须松开！不是同时按住三个键！ │ │ │ └─────────────────────────────────────────────────────────┘举例：
你想做什么 正确操作 ❌ 错误操作 新建会话 Ctrl+X→ 松开 →N同时按 Ctrl+X+N 打开会话列表 Ctrl+X→ 松开 →L按住 Ctrl 不放按 X 再按 L 为什么这样设计？
终端程序的快捷键空间很有限，很多组合键被终端本身或操作系统占用了。Leader 键机制让 OpenCode 可以支持大量快捷键，而不会和其他程序冲突。
这个设计借鉴自 Vim 编辑器和 Emacs 编辑器，程序员会很熟悉。
💡 练习技巧：刚开始可以故意放慢：按
Ctrl+X后，心里默数”1″，再按字母键。熟练后自然会快。第一梯队：每天必用
这 8 个快捷键覆盖了 90% 的日常操作：
快捷键 功能 说明 Enter发送消息 — Ctrl+J换行（不发送） 比 Shift+Enter更通用↑/↓翻阅历史输入 输入框为空时有效 Tab切换 Plan/Build 模式 看右下角确认切换成功 Escape中断 AI 响应 按两次强制中断 Ctrl+X → N新建会话 New Ctrl+X → L会话列表 List Ctrl+X → U撤销 Undo 关于换行：
写多行提示词时，需要换行而不是发送。有几种方式：
Ctrl+J（推荐，最通用）Shift+EnterCtrl+EnterAlt+Enter
如果
Shift+Enter不工作（直接发送了），说明你的终端不发送修饰键，改用Ctrl+J。关于 Ctrl+C：
状态 效果 输入框有内容 清空输入框 输入框为空 退出程序 这和终端的标准行为一致。
第二梯队：效率提升
快捷键 功能 记忆技巧 Ctrl+X → M切换模型 Model Ctrl+X → R重做 Redo Ctrl+X → Y复制 AI 回复 Yank Ctrl+X → C压缩对话 Compact Ctrl+P命令面板 同 VS Code 第三梯队：程序员福利
如果你用过终端或 Emacs，这些 Readline 风格的快捷键你会很熟悉：
快捷键 功能 Ctrl+A跳到行首 Ctrl+E跳到行尾 Ctrl+K删除光标到行尾 Ctrl+U删除光标到行首 Ctrl+W删除上一个单词 OpenCode 完全兼容 Readline，你在终端中的肌肉记忆可以直接迁移。
快捷键速记口诀
回车发送，Ctrl+J 换行 上箭头翻历史（输入框要空） 新建 N，列表 L，撤销 U，模型 M，复制 Y Escape 中断，Tab 切模式 Ctrl+C 不是复制！三、个性定制
这一部分帮你配置 OpenCode，让 AI 永久记住你的偏好。
3.1 规则文件：让 AI 永久记住你的偏好
厌倦了每次都说”用中文回复”？创建一个规则文件，一劳永逸。
什么是规则文件？
规则文件是一个 Markdown 文件，里面写着你希望 AI 遵守的规则。OpenCode 会在每次对话时自动读取这个文件，把内容加到系统提示词里。
好处：
- 不用每次对话都重复相同的要求
- 规则可以很详细，用 Markdown 格式组织
- 修改后立即生效，不需要重启
最快的创建方式
直接在 OpenCode 里让 AI 帮你创建：
帮我创建 ~/.config/opencode/AGENTS.md，内容是： - 始终使用简体中文回复 - 代码注释也用中文 - 不要客套话，直接给方案搞定。 下一条消息 AI 就会遵守这些规则。
两个作用域
位置 作用域 使用场景 ~/.config/opencode/AGENTS.md全局 所有项目都适用的偏好 项目根目录 AGENTS.md项目 仅当前项目适用的规范 两者会合并生效。如果有冲突，项目规则会覆盖全局规则。
热加载
规则文件是热加载的。修改后不需要重启 OpenCode，也不需要新建会话，下一条消息就会遵守新规则。
这意味着你可以让 AI 帮你修改规则文件，然后立即验证效果。
懒人方案：/init
如果你不知道该写什么规则，让 AI 分析项目自动生成：
/initAI 会分析项目的技术栈、代码风格、构建命令等，自动生成一份
AGENTS.md。实用规则模板
markdown## 沟通风格 - 始终使用简体中文回复 - 直接输出方案，禁止客套话（"好的"、"我明白了"等） - 不确定时先问，不要瞎猜 ## 代码规范 - 使用 2 空格缩进 - 变量名用 camelCase - 函数名用动词开头（如 getUserById） - 禁止使用 any 类型 ## 工作习惯 - 改代码前先阅读相关文件 - 每次只做最小必要的修改 - 修改后自行运行测试验证关于 AGENTS.md vs CLAUDE.md
OpenCode 同时支持两种文件名：
AGENTS.md— OpenCode 的标准名称，也是一个开放标准，被多种 AI 工具支持CLAUDE.md— 兼容 Claude Code
如果两个文件都存在，只会读取
AGENTS.md。建议统一使用AGENTS.md。3.2 环境管理：模型、统计、凭证
查看可用模型
opencode models列出所有已配置的模型。输出格式是
提供商/模型名：anthropic/claude-sonnet-4 openai/gpt-4o zhipuai/glm-4 ollama/deepseek-r1:7b只看某个厂商的模型：
opencode models anthropic刷新模型缓存：
如果你刚添加了新的 API Key，或者下载了新的 Ollama 模型，需要刷新缓存：
opencode models --refresh设为默认模型：
编辑
~/.config/opencode/opencode.json：{ "model": "anthropic/claude-sonnet-4" }查看使用统计
opencode stats显示你的 Token 消耗和费用统计：
┌─────────────────────────────────────────────────┐ │ OVERVIEW │ ├─────────────────────────────────────────────────┤ │ Sessions 948 │ │ Messages 30,575 │ │ Days 29 │ └─────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────┐ │ COST & TOKENS │ ├─────────────────────────────────────────────────┤ │ Total Cost $1232.56 │ │ Input 530.6M │ │ Output 9.9M │ │ Cache Read 703.0M │ └─────────────────────────────────────────────────┘关键指标：
指标 含义 备注 Total Cost 估算费用 根据厂商公开定价计算 Input 输入 Token 你发的消息 + AI 读的文件 Output 输出 Token AI 的回复，比 Input 贵 3-5 倍 Cache Read 缓存命中 越高越省钱，只收 1/10 费用 只看最近几天：
opencode stats --days 7 # 最近 7 天 opencode stats --days 1 # 今天看哪个模型最烧钱：
opencode stats --models 5 # 消耗最高的 5 个模型只看当前项目（需要在 Git 仓库中）：
opencode stats --project ""管理登录凭证
查看已登录的账号：
opencode auth list退出某个账号：
opencode auth logout然后选择要退出的提供商。
⚠️ 安全提示：凭证以明文存储在
~/.local/share/opencode/auth.json，不要把这个文件上传到公开仓库。四、速查手册
核心操作速查
符号 作用 示例 @引用文件 @src/main.ts 分析这个文件!执行命令 !git status/斜杠命令 /help斜杠命令速查
命令 作用 快捷键 /new新建会话 Ctrl+X → N/sessions切换会话 Ctrl+X → L/undo撤销操作 Ctrl+X → U/redo重做操作 Ctrl+X → R/compact压缩对话 Ctrl+X → C/export导出对话 Ctrl+X → X/models切换模型 Ctrl+X → M/help查看帮助 — /init生成项目规则 — 快捷键速查
基础操作
快捷键 功能 Enter发送消息 Ctrl+J换行（不发送） ↑/↓翻阅历史输入（输入框为空时） Tab切换 Plan/Build Escape中断 AI 响应 Ctrl+C清空输入（有内容）/ 退出（无内容） Ctrl+D退出（推荐） Leader 键组合（Ctrl+X → 字母）
组合 功能 记忆 → N新建会话 New → L会话列表 List → U撤销 Undo → R重做 Redo → M模型列表 Model → Y复制回复 Yank → C压缩对话 Compact 常见问题排错
现象 原因 解决方法 Ctrl+C退出了程序输入框为空时的正常行为 用 Ctrl+D退出，或用鼠标拖选复制@没有文件补全不在项目目录 cd到项目目录重新启动/undo没恢复文件不是 Git 仓库 运行 git init && git add . && git commit -m "init"Ctrl+X → N没反应没松开就按了 N 必须先松开 Ctrl+X，再按 N Tab没切换模式在输入状态 先按 Escape，再按TabShift+Enter不换行终端不发送修饰键 改用 Ctrl+JWindows 退出后鼠标乱码 Ctrl+C强制退出的后遗症关闭终端重开，以后用 Ctrl+D退出规则文件不生效 路径错误 确认是 ~/.config/opencode/AGENTS.md上箭头没出历史 输入框不是空的 先 Ctrl+C清空，再按上箭头上手检查清单
完成以下操作，你就真正掌握了 OpenCode：
你现在已经掌握了 OpenCode 日常使用的完整知识体系。从界面认知到核心操作，从效率技巧到个性配置，再到速查手册——这些知识足以让你在日常开发中得心应手。去写代码吧，让 AI 成为你的得力助手。
- 在项目目录启动：
-
- 抱歉，回覆主題必需先登入。