OpenCode 开源编程智能体

它是什么

OpenCode 是一个开源 AI 编程智能体。你可以在全屏终端界面里用它，也可以用 README 标为 BETA 的桌面应用，或者网页应用。你用平常的话描述一项改动，智能体会搜索、阅读你的代码，编辑文件、运行命令，碰到你的规则要求先问的地方就先问你。默认情况下，一个共享的后台服务器管理所有会话，每个本地客户端都连到它。这个条目里是 Mindket 根据制作方的 README 和文档写的安装说明。

1. 你用平常的话描述一项任务
2. 智能体阅读、搜索、编辑并运行命令
3. 你的权限规则对每个动作允许、询问或拒绝
4. 在 Git 仓库里，/undo 可以把文件改回去
5. 一个共享服务器为每个客户端保存会话

适合谁

想在终端里用编程智能体、又想沿用手上模型的开发者。这个模型可以来自提供方密钥、ChatGPT Plus 或 Pro 登录、有 Copilot Chat 权限的 GitHub Copilot 账号、OpenCode 免费模型，也可以是 Ollama、LM Studio 或 vLLM 提供的本地模型。习惯把项目规则写进文件的人也合适：约定写在 AGENTS.md，智能体、命令和技能写成 Markdown，权限规则写在 opencode.jsonc。管理员还能设置仓库无法撤销的策略。

如果你需要稳定不变的工具，可以先不用它。桌面应用标着 BETA，而且 OpenCode 2 相比 OpenCode 1 改了插件、服务器 API 和终端设置。

用在哪里

OpenCode 能在这些地方运行。

• 终端：命令行，可以用安装脚本、包管理器，或者 macOS、Windows 和 Linux 的独立下载包安装
• 桌面应用（BETA）：macOS 和 Windows 安装包，Linux 有 .deb、.rpm 和 AppImage 文件
• 浏览器：opencode pair 会打印一个打开网页界面的链接
• 另一台机器：在主机上运行 opencode serve，用 --server 启动客户端，或者走 SSH 端口转发
• Docker：Intro 页面提到了带版本号的镜像标签，但没有给运行命令

Intro 页面说 OpenCode 内置支持许多 LLM 提供方。设置说明涵盖提供方密钥、ChatGPT 登录、GitHub Copilot、Ollama、LM Studio、vLLM，以及自定义的 OpenAI 兼容端点。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，每条命令都照抄自 OpenCode 文档。主要途径是一行安装命令，再接一个模型。

1. 安装命令行工具。在 macOS 或 Linux 上，用下面的 curl 命令，或者说明里的某个包管理器命令。在 Windows 上，下载说明里列出的 Windows 独立 zip 包（ARM64、x64 或 x64 baseline）。
2. 在项目文件夹里运行 opencode。它会打开全屏终端界面。
3. 输入 /connect 并选一个提供方。完成登录后，输入 /models 选一个模型。
4. 给 shell 命令定好规则。默认情况下智能体不问就能运行它们，所以正式干活前，先加上说明里那条“询问”规则。

curl -fsSL https://opencode.ai/v2/install | bash
opencode

README 把 curl 这一行标为“YOLO”。这一行会下载一个脚本，并立刻交给 bash 运行。它把 OpenCode 装到 $HOME/.opencode/bin。另一条途径是包管理器，比如 brew install anomalyco/tap/opencode-v2 或 npm install -g @opencode/cli。

如何使用

说出你想要的结果，让智能体自己选工具。下面是 Tools 页面的示例提示词。

Find where request timeouts are configured, change the default to 30 seconds, and run the relevant existing tests.

TUI 页面说按 Shift+Tab 轮换智能体，按 Ctrl+X 再按 A，或者运行 /agents，可以直接选一个。内置的主智能体有两个。build 有完全权限。plan 是只读的，默认禁止编辑文件。README 还说 plan 运行 shell 命令前会先问，但 Permissions 页面的默认设置没给 plan 任何 shell 规则，所以请自己加一条。

示例

你想把自己的改动再审一遍，又不想让智能体动任何文件。你已经把 Agents 页面的审查者（文件见下文）存成 .opencode/agents/reviewer.md。你对主智能体说：

Use the reviewer subagent to review my current changes.

审查者在一个子会话里运行，带着全新的上下文和它自己的权限。它不能编辑文件，也不能运行 shell 命令，所以只阅读你的改动。它的提示词要求它按严重程度列出发现，并附上文件和行号。

下面是 Agents 页面里的审查者文件。把 model 那一行改成你已经连接的模型。

---
description: Reviews changes for correctness and regressions
mode: subagent
model: anthropic/claude-sonnet-5-5#high
permissions:
  - action: edit
    resource: "*"
    effect: deny
  - action: shell
    resource: "*"
    effect: deny
---

Review the current changes. List findings in severity order with file and line references.

父智能体的 subagent 规则决定它可以启动哪些子智能体。

新手与专家

新手：编程智能体不只是一个聊天框。它读你的项目、编辑文件、运行命令，这些都通过工具来做。OpenCode 的默认策略允许所有工具，只有读取 .env 文件要先问。从一个 Git 仓库开始，这样 /undo 才能恢复文件。拿一个你还不熟的项目试试 plan 智能体。发第一个提示词前先运行 /models，看看有哪些模型可用。Intro 页面还提到了 Boot.dev 的 OpenCode AI 编程课程，这门课是 Boot.dev 在咨询 OpenCode 团队后制作的。页面说课程内容可以免费阅读和观看，但有些互动功能可能要付费。

专家：OpenCode 的大部分行为由文件和一个服务器决定。

• 一个服务器，多个客户端：默认由一个共享后台服务器管理会话、配置、权限和工具执行。opencode --standalone 让某一次运行用私有服务器，opencode serve 在前台运行它，适合 systemd 或 Docker
• 配置层：全局、项目和系统级的 opencode.json(c) 文件会合并。项目文件压过全局文件，系统级文件压过所有文件。全局和项目文件里的策略按相反的顺序执行，所以范围更大的配置压过项目配置
• 模型：写成 provider/model，可以再加 #variant。自定义的 OpenAI 兼容提供方写在 providers 下，带上它的包、基础 URL 和模型
• MCP 和 Code Mode：服务器写在 mcp.servers 下。Code Mode 是默认值，按服务器名给工具分组，"codemode": false 让某个服务器的工具留在原生工具列表里
• 技能：OpenCode 也会读 .claude/skills 和 .agents/skills，智能体按确切的 ID 加载技能
• 插件：包形式的插件用 opencode plugin add 安装。为 OpenCode 1 写的插件在第 2 版里跑不了

注意事项

OpenCode 在你的电脑上动手，也有几条路径会连到外面。

• 不问就做：默认策略允许所有动作，只有读取 .env 文件例外，而 shell 工具拥有你这个用户的文件系统、进程和网络权限
• 项目之外：第 2 版默认允许访问项目以外的路径，第 1 版会先问。把 external_directory 设为 ask 的规则可以把提示找回来
• 模型提供方看得到你的工作：提示词和文件内容会发给你所用模型的提供方，用 OpenCode 免费模型时，就是 OpenCode 自己的 opencode 提供方。OpenCode Go 的页面按模型列出训练和数据保留条款，并默认屏蔽会用请求数据训练的付费端点
• 密钥：保存的 API 密钥和 OAuth 令牌存在服务器的 SQLite 数据库里。在配置文件里用 {env:NAME} 代替密钥
• 快照：为了 /undo，OpenCode 默认在每个模型步骤前后抓取快照，存在数据文件夹下的一个 Git 对象库里。快照可能含有已跟踪文件和符合条件的未跟踪文件的完整内容，所以把这个文件夹当作敏感数据，重要的工作还是靠 Git 提交。"snapshots": false 会停止以后的抓取，但不会删除已经存下的快照
• 远程访问：第一次运行 opencode pair --remote 时，它会在把你的服务器暴露到互联网之前先问。接受之后，以后再运行就不再问，即使用 opencode service set remote false 关过远程访问也一样。Web 页面说流量端到端加密，访问需要你的服务器密码
• 堆快照：opencode debug heap-dump 或桌面应用命令面板写出的快照，可能含有提示词、文件内容和凭据。不要公开分享
• 使用数据：这些说明依据的页面没说 OpenCode 会不会发送使用数据，所以 Mindket 没法告诉你
• 付费选项：OpenCode Console 和 OpenCode Go 都是可选的，Go 页面说不用 Go 也能用 OpenCode
• 卸载：opencode uninstall --dry-run 可以先预览。会话数据、配置和状态永远不会被删
• 名字：README 请名字里带“opencode”的项目说明自己不是 OpenCode 团队做的。这些说明不是那个团队写的，也没有得到它的认可
• 许可证：MIT。LICENSE 文件写的是“Copyright (c) 2025 opencode”