~/.config/opencode/
全局 opencode.json、AGENTS.md、commands/、skills/ 和 plugins/。桌面应用崩溃常常是插件。清空 plugin 键再启动。见桌面排查。
三种界面，同一个智能体
首页把这叫做“任意编辑器”：终端界面、桌面应用和 IDE 扩展。Desktop 是后来为活动会话加上标签页的那一层。官方下载页仍按 Terminal、Desktop、Extensions 的顺序列出。
TUI 配置在 tui.json（主题、快捷键、光标、提示音）。运行时配置在 opencode.json。它们不是同一个文件。
Windows 上桌面白屏通常是 WebView2。操作步骤在指南里。
模型、登录与 Zen
首页的“任意模型”指通过 Models.dev 接入 75 家以上 LLM 服务商，含本地模型。/connect 用来添加服务商。模型写成 provider/model，例如 openai/gpt-4.1 或 opencode/kimi-k2。
| 路径 | 是什么 |
|---|---|
| /connect | 添加服务商并粘贴 API key，或登录 Copilot、ChatGPT、Claude 或 Zen。 |
| /models | 打开选择器。在 shell 里运行 opencode models，列出你实际能调用的模型。 |
| OpenCode Zen | 项目为编程智能体测过的精选模型，服务商质量少一点碰运气。 |
| GitHub Copilot | 用 GitHub 登录。v1.18.31 会为 Copilot 模型请求摘要式自适应思考。 |
| ChatGPT Plus/Pro | 用 OpenAI 登录。v1.18.29 修复了 OpenAI 订阅用户看不到 gpt-6-astra 的问题。 |
| 本地模型 | 首页和 FAQ 都写明，可通过同一份服务商列表接入本地模型。 |
智能体循环
- Tab · Plan / Build
- Build 是默认主智能体，工具处于开启状态。Plan 受限制：edit 和 bash 默认 ask 或 deny，让模型可以提出方案而不动工作树。
- /init · AGENTS.md
- 引导式设置，写入项目规则。请提交该文件。全局规则也可以放在 ~/.config/opencode/AGENTS.md。
- /undo · /redo
- 撤回或恢复上一轮用户操作及其文件改动。需要 Git。可以连续撤销多次。
- /share · /unshare
- 发布会话供审阅或排查。在你运行该命令之前，对话不会被分享。
权限就是安全护栏
自 v1.1.1 起，旧的 tools 布尔值并入 permission。每条规则是 allow、ask 或 deny。opencode --auto 会批准未被 deny 的 ask。
- read / edit / bash / grep / glob
- 文件和 shell 工具。模式可以允许
git *并拒绝rm *。 - external_directory
- 工具离开工作目录时触发。默认是 ask。用 ~ 展开家目录不会跳过这道守卫。
- doom_loop
- 同一工具调用以相同输入重复三次时触发。默认是 ask。
- .env files
- read 是 allow，但
*.env和*.env.*默认 deny。*.env.example仍为 allow。
MCP、智能体与项目文件
配置放在约定目录里。这些路径就是速查表实际点名的那些。
仓库里的 .opencode/
按项目的配置、命令、技能和插件。智能体 markdown 可以设置 mode: subagent 并 deny edit，这样审阅者写不了文件。
/mcp
列出已配置的 MCP 服务器及其连接状态。权限键可用 mymcp_* 这类模式指向某台服务器。
Desktop 标签页
下载页标题：在 macOS、Windows 和 Linux 上用标签页组织工作和活动会话。