OpenCode 速查表

🔍

未找到匹配内容

尝试更换关键词搜索

⌨️ 快速入门

启动命令

opencode 启动 TUI

opencode /path 指定项目目录

--continue 继续上一个会话

--version 查看版本

快捷键

Tab 切换主代理

@ 引用文件

! 执行 bash

ctrlx 斜杠命令前缀

CLI 命令

run 非交互模式运行

models 列出模型

agent list 管理代理

session list 管理会话

stats 统计信息

serve/web 启动服务

upgrade 升级

--print-logs 打印日志

⚡ 斜杠命令

会话管理

/connect 添加提供商

/compact 压缩会话 ctrl+x c

/details 切换工具详情 ctrl+x d

/editor 打开外部编辑器 ctrl+x e

/exit 退出 ctrl+x q

/export 导出对话 ctrl+x x

/help 显示帮助 ctrl+x h

/new 新会话 ctrl+x n

/undo 撤销修改 ctrl+x u

/redo 重做修改 ctrl+x r

/sessions 会话列表 ctrl+x l

配置命令

/init 创建 AGENTS.md ctrl+x i

/models 列出模型 ctrl+x m

/themes 列出主题 ctrl+x t

🧠 工作流与技巧

开发流程

添加新功能 Plan→Build 流程

代码审查流程代理分析步骤

/undo /redo 撤销与重做

最佳实践

/init 初始化 AGENTS.md

先规划再执行复杂任务使用 Plan

使用 @ 引用相关文件

Git 仓库确保使用撤销功能

封装技能将常用工作流封装

📋 规则系统

AGENTS.md 位置

项目级 ./AGENTS.md

全局级 ~/.config/opencode/

Claude兼容 CLAUDE.md

外部引用

opencode.json 引用外部文件

初始化

/init 创建 AGENTS.md

🤖 代理系统

主代理

Build 默认开发代理

Plan 规划代理（只读）

子代理

@general 通用研究代理

@explore 代码库探索代理

切换方式

Tab 切换主代理

@name 提及调用子代理

创建自定义代理

CLI 创建 opencode agent create

JSON 配置 opencode.json

Markdown ~/.config/opencode/agents/

🔌 MCP 服务器

配置类型

本地 MCP type: local

远程 MCP type: remote

常用示例

Sentry 错误追踪

Context7 文档搜索

Grep GitHub 代码搜索

管理命令

mcp list 列出服务器

mcp add 添加服务器

mcp auth 认证

mcp debug 调试

🔧 推荐插件

认证插件

opencode-gemini-auth Gemini 套餐替代

opencode-antigravity-auth 免费模型替代

功能插件

oh-my-opencode 后台代理、LSP/MCP

opencode-skillful 技能管理工具

🛠️ 故障排除

常见问题

无法启动日志检查、升级

身份验证重新认证、API密钥

ProviderInitError 清除配置

AI_APICallError 清除缓存

文件位置

日志文件 ~/.local/share/opencode/

存储位置配置与会话数据

速查表

模型不响应检查 API 密钥和网络

工具被禁用检查 permission 配置

MCP 不工作运行 mcp debug

无法撤销确保是 Git 仓库

性能问题使用 /compact

上下文溢出增加 reserved 值