OpenCode
1. 安装
1.1. Windows
scoop install main/opencode # 安装OpenCode
echo 'export EDITOR=vim' >> ~/.bashrc # 设置外部编辑器
1.2. Linux
npm install -g opencode-ai # 安装OpenCode
echo 'export EDITOR=vim' >> ~/.bashrc # 设置外部编辑器
2. 基础
- OpenCode将所有会话数据保存到同一个SQLite数据库中, 通常位于
~/.local/share/opencode/opencode.db(Linux)或%USERPROFILE%\.local\share\opencode\opencode.db(Windows) - OpenCode用不同的目录来隔离不同的项目, 每个目录内仅保存该项目关联的会话(/sessions, 目录感知)
- OpenCode包括Plan模式和Build模式, Plan模式不会进行任何修改, 只提供建议, Build模式会根据Plan模式的建议进行修改
- OpenCode的操作权限包括:
allow: 直接执行, 不询问ask: 询问后执行deny: 拒绝执行
- 操作权限的设置可通过配置文件实现, 配置文件位于
%USERPROFILE%\.config\opencode\下的opencode.json或opencode.jsonc(带注释)
3. 使用
一般使用tui(Terminal User Interface)模式, 进入项目目录后, 直接运行opencode即可
4. 常用命令
4.1. /models
列出当前可用模型, 进行切换模型
4.2. /variants
推理等级, 表示思考强度和token消耗快慢
4.3. /connect
添加新的提供商, 设置密钥
4.4. /init
OpenCode会分析项目结构和编码规范, 在根目录下生成一个AGENTS.md文件
4.5. /compact
压缩当前项目的会话数据, 减少上下文长度, 减少token消耗
4.6. /exit
退出OpenCode
4.7. /session
列出当前项目的所有会话
4.8. /new
创建一个新的会话
4.9. /rename
重命名当前会话标题
4.10. /fork
从当前会话中任一历史结点创建一个新的会话分支, 该会话分支将继承该结点之前的所有上下文, 避免污染当前会话
4.11. /timeline
显示当前会话的所有历史结点, 选择一个结点, 用于还原到任一历史结点, 或复制提交消息到粘贴板, 或进行fork操作
4.12. /undo, /redo
撤销/重做当前会话的操作, 仅在Build模式下有效
4.13. /editor
调用外部编辑器来输入
export EDITOR=vim临时设置echo 'export EDITOR=vim' >> ~/.bashrc永久设置
5. 辅助功能
5.1. Ctrl+P
显示所有命令和快捷键
5.2. Esc
打断当前思考或执行操作
@
引用文件或目录, 将其内容作为上下文传递给模型
5.3. 显示窗口滚动条
按Ctrl+P打开命令窗口, 输入Toggle session scrollbar, 回车即可显示窗口滚动条