终端
默认路径。主题和快捷键在 tui.json。运行配置在 opencode.json。两者不是同一个文件。
为你的代码准备的开源智能体.
使用自带免费模型，或接入任意服务商——Claude、GPT、Gemini 以及其余目录。
$
choco install opencode
01 / 功能
为真实开发流程而建。
开源智能体，在终端、IDE 或桌面应用里和你一起写代码。
- 01↗LSP enabled 自动为模型加载合适的语言服务器。
- 02↗Multi-session 在同一项目上并行启动多个智能体。
- 03↗Share links 把任意会话做成链接，方便对照或排错。
- 04↗GitHub Copilot 用 GitHub 登录，使用已有 Copilot 账号。
- 05↗ChatGPT Plus/Pro 用 OpenAI 登录，使用 ChatGPT Plus 或 Pro。
- 06↗Any model 通过 Models.dev 接入 75+ 服务商，包含本地模型。
- 07↗Any editor 终端、桌面应用和 IDE 扩展。
02 / 开始
从安装到第一次改代码。
官方入门是一条短回路：安装、写项目规则、接入模型，再在 Plan 和 Build 之间切换。
- 1. 从下载页安装桌面或 CLI。当前版本是 v1.18.31，覆盖 Windows、macOS 和 Linux。
- 2. 在项目里运行
opencode，再执行/init写出AGENTS.md。提交这个文件，后续会话才能读到同一套规则。 - 3. 用
/connect添加服务商密钥，或登录 Copilot、ChatGPT、Claude、Zen。附带免费模型无需账号。 - 4. 用
@附加文件。Plan 只提方案，edit 和 bash 默认 ask 或 deny。Build 是默认智能体，工具开启。
03 / 界面
三种界面，同一个智能体。
「Any editor」指终端、桌面应用和 IDE 扩展。默认安装路径仍是终端。
桌面
在 macOS、Windows 和 Linux 上用标签管理活动会话。Windows 需要 WebView2。空白窗口通常是这个运行时。自 v1.3.4 起已签名。
IDE 扩展
同一套智能体跑在编辑器里。下载页顺序仍是 Terminal、Desktop、Extensions。
撤销与分享
/undo 和 /redo 回退或恢复上一轮用户操作及其文件改动。需要 Git。/share 只有你执行时才会公开会话。
04 / Adoption
公开的开源编程智能体。
超过 195,000 GitHub star、950 位贡献者、13,000+ 提交。每月有超过 1600 万开发者使用。
05 / Privacy
默认隐私优先。
默认不存储代码和上下文，可在敏感环境运行。FAQ 写明两个例外。 了解隐私 →
- 默认
- 服务端不存储代码和上下文。可以在不能留下远端副本的环境里运行。
- 会存储
- 使用附带免费模型或生成分享链接时会存数据。会话在你执行
/share之前不会公开。 - 本地磁盘
- 本地会话在
~/.local/share/opencode或%USERPROFILE%\.local\share\opencode，包含auth.json。 - 签名
- CLI 和桌面自 v1.3.4 起已代码签名。把 Windows x64 安装包加入杀毒排除前，先核对哈希。
06 / 权限
Allow、ask 或 deny。
自 v1.1.1 起，每条规则是 allow、ask 或 deny。opencode --auto 会批准未被 deny 的 ask。Plan 模式下模型思考时，edit 和 bash 关闭。
- external_directory
- 工具离开工作目录时触发。默认 ask。展开
~不会绕过这道守卫。 - doom_loop
- 同一工具调用以相同输入重复三次时触发。默认 ask。
- .env 文件
read为 allow，但*.env和*.env.*默认 deny。*.env.example仍为 allow。- 模式
- 文件和 shell 工具可以允许
git *、拒绝rm *。Ask 可选择 once、本会话 always，或 reject。
07 / FAQ
问题，直接回答。
开源智能体：用任意模型写代码、跑代码。终端、桌面或 IDE 扩展。
从下载页安装，在项目里运行 opencode，然后 /init。连接服务商，用 @ 附加文件，使用 Plan/Build。
不必。免费模型无需账号。也可连接 OpenAI、Anthropic、xAI、本地模型或 Zen。
可以。官方 FAQ 点名 Claude Pro/Max、ChatGPT Plus/Pro 和 GitHub Copilot。
不是。桌面覆盖 macOS、Windows 和 Linux，另有 IDE 扩展。
智能体本身免费，并附带免费模型。接入的服务商可能产生该服务商费用。
默认不存储代码和上下文。使用附带免费模型或分享链接时会存数据。本地会话仍在磁盘上。
是。源码公开，MIT 许可。GitHub 上的项目名是 anomalyco/opencode。
能。桌面提供 win-x64 和 win-arm64。文档仍建议用 WSL 跑终端路径。桌面需要 WebView2。见 WSL 指南。
启发式引擎曾把首次运行的临时 DLL 标成 Wacatac 或 PDM:Trojan.Win32.Generic。核对 SHA256，优先用已签名的 v1.18.31 桌面包，不要关 Smart App Control。完整步骤：杀毒说明。
Windows PowerShell：Get-FileHash .\opencode-desktop-win-x64.exe -Algorithm SHA256。v1.18.31 摘要在完整性一节。
08 / Models
为编码智能体验证过的可靠模型。
接入针对编码智能体验证过的模型。可用附带免费模型、自有密钥、Copilot、ChatGPT 或本地运行时，不必绑定单一厂商。
/connect
添加服务商并粘贴 API 密钥，或登录 Copilot、ChatGPT、Claude、Zen。
/models
打开选择器。运行 opencode models 列出可调用的模型。写法是 provider/model，例如 openai/gpt-4.1。
OpenCode Zen
项目为编码智能体挑过的模型，减少服务商质量上的碰运气。
本地模型
通过 Models.dev 上同一份 75+ 服务商列表接入本地模型。附带免费模型无需账号。