跳到主要内容

Opencode

管理对话（Session）​

OpenCode 把会话数据存储在本地文件系统中，按 JSON 文件组织：

~/.local/share/opencode/storage/
├── session/           # 会话信息
│   └── <project-id>/
│       └── <session-id>.json
├── message/           # 消息记录
│   └── <session-id>/
│       └── <message-id>.json
└── part/              # 消息片段（文本、工具调用等）
    └── <message-id>/
        └── <part-id>.json

会话管理命令速览

命令作用
/new新建会话
/sessions查看并切换会话
/undo撤销上一步操作
/redo重做被撤销的操作
/compact压缩上下文
/export导出对话记录
/share分享会话（生成链接）
opencode import从文件或 URL 导入会话（CLI 命令）
opencode export导出会话为 JSON（CLI 命令）

快捷键​

Leader 键机制

OpenCode 使用 Leader 键（默认 Ctrl+X）作为快捷键前缀，避免与终端快捷键冲突。

第一梯队：每天必用

快捷键功能说明
Enter发送消息回车发送
Shift+Enter换行（不发送）写多行提示词时用
Ctrl+C清空输入 / 关闭对话框 / 退出详见下方说明
Escape中断 AI 响应AI 在生成时按，立即停止。按两次可强制中断
↑+↓翻阅历史输入输入框为空时，按上下键可找回之前发过的消息
Tab切换 Agent在 Plan/Build/不同 Agent 间切换
Ctrl+X+N新建会话Leader 键 + N = New
Ctrl+X+L会话列表Leader 键 + L = List

第二梯队：效率提升

快捷键功能记忆技巧
Ctrl+X+M模型列表Model
F2快速切换最近模型IDE 通用
Ctrl+X+U撤销消息Undo
Ctrl+X+R重做消息Redo
Ctrl+P命令面板同 VS Code

第三梯队：锦上添花

快捷键 功能 使用场景

快捷键功能使用场景
Ctrl+X+Y复制消息复制 AI 回复
Ctrl+X+C压缩上下文对话太长时
Ctrl+X+B切换侧边栏看会话树
PageUp+PageDown翻页浏览长对话翻阅
Ctrl+X+T主题列表换个心情

输入框快捷键

快捷键功能Readline 风格
Ctrl+A跳到行首✅
Ctrl+E跳到行尾✅
Ctrl+K删除光标到行尾✅
Ctrl+U删除光标到行首✅
Ctrl+W删除上一个单词✅
Alt+B后退一个单词✅
Alt+F前进一个单词✅
什么是 Readline 风格

Readline 是 Unix/Linux 终端的标准输入库，定义了一套通用的快捷键。

几乎所有终端程序（bash、zsh、python REPL）都支持这套快捷键。如果你天天在终端工作，这些快捷键已经是肌肉记忆了。

OpenCode 完全兼容 Readline，让你在输入框里也能用熟悉的方式编辑文本。

全局提示词 (cluade.md)​

三种作用域 OpenCode 支持三种作用域的规则，满足不同场景：

作用域位置适用场景
全局规则~/.config/opencode/AGENTS.md所有项目通用的偏好
项目规则项目根目录 AGENTS.md项目特定的规范
配置文件opencode.json 的 instructions 字段引用多个规则文件
🤔 为什么叫 AGENTS.md？

OpenCode 同时支持 AGENTS.md 和 CLAUDE.md（兼容 Claude Code）。推荐用 AGENTS.md，这是 OpenCode 的标准名称。

规则加载顺序 规则按以下顺序加载，后加载的会补充（不是覆盖）前面的：

  1. 全局 ~/.config/opencode/AGENTS.md
  2. 全局 ~/.claude/CLAUDE.md（兼容模式）
  3. 项目目录向上查找 AGENTS.md / CLAUDE.md
  4. 配置文件 instructions 指定的文件

结果：所有规则都会生效，合并在一起。

高效工作流​

Plan vs Build：规划与执行​

Plan 和 Build 是什么​

Plan 和 Build 是 OpenCode 内置的两个 Primary Agents（主要助手）。

  • Primary Agent：你可以直接对话的主助手，用 Tab 切换
  • Subagent：由 Primary Agent 调用的专家助手，用 @ 提及

OpenCode 默认提供两个 Primary Agents：

Agent类型说明
BuildPrimary默认助手，所有工具可用，适合开发工作
PlanPrimary受限助手，权限询问，适合分析和规划