软件介绍
OpenCode 是一个在终端里帮你写代码的 AI 助手。你用大白话说明想做什么,它会翻看项目里的文件、找到出问题的地方,再把改好的代码写回去。
它自带 build 和 plan 两种工作状态,按 Tab 键就能切换:plan 只读不改,适合先让它把陌生项目讲清楚;build 才会真正动手改文件。需要执行终端命令时,它会先征求你的同意,不会自作主张。
除了命令行,还提供桌面版安装包,Windows、macOS、Linux 都能装,桌面版目前仍标注为测试阶段。
核心功能
Tab 键切换两种模式
build 模式可以自由改代码,plan 模式默认只读、不动文件,适合先摸清陌生项目再动手。
跑命令前先确认
在 plan 模式下执行终端命令前会先问你一句,避免 AI 在你没看清时动到系统里的东西。
唤出子代理查难题
在消息里输入 @general 叫出通用子代理,专门处理大范围搜索和多步骤的复杂任务。
脚本跑在独立工作树
启动会话时加上 -w 参数会新建一个 git 工作树,试验性改动不会弄脏你当前正在写的代码。
三个系统都能装
Windows、macOS、Linux 都有对应安装包,命令行版之外还提供桌面版下载。
安装与使用
- 在本站下载安装包:Windows 选 opencode-desktop-win-x64.exe,macOS 的 Apple 芯片机型选 opencode-desktop-mac-arm64.dmg、Intel 机型选 opencode-desktop-mac-x64.dmg,Linux 选 .deb、.rpm 或 .AppImage。
- 双击安装并完成首次启动,把工作目录切到你自己的项目文件夹。
- 先按 Tab 切到 plan 模式,用大白话说明需求,让它读代码、讲思路,这一步它不会改任何文件。
- 确认方向没问题后,再按 Tab 切回 build 模式让它动手改;过程中要执行命令时,按提示选择允许或拒绝。
- 遇到大范围搜索时,在消息里输入 @general 唤出子代理;不想让自动运行的会话占满列表,可以在命令后加 --archived。
常见问题
Q:装的时候提示和旧版本冲突怎么办?
A:官方提醒要先删掉早于 0.1.x 的旧版本再安装,把旧版卸载干净后重新运行安装包即可。
Q:它会不会不打招呼就改我的代码?
A:默认的 build 模式会直接改文件。想先看不动手,按 Tab 切到 plan 模式,它默认拒绝任何文件修改。
Q:桌面版和命令行版有什么区别?
A:桌面版目前标注为 BETA 测试阶段,可以直接下载安装包使用;命令行版则通过安装脚本或 brew、npm 等方式安装。
Q:除了下载安装包,还有别的安装方式吗?
A:有。可以用一条安装脚本,也能通过 npm、bun、pnpm、yarn、Homebrew、pacman、mise、Nix 安装。
Q:装完之后程序被放到哪里了?
A:安装脚本会把 OpenCode 装到用户目录下的 .opencode/bin 文件夹里。
版本更新内容
当前版本 v2.2.7 更新内容(内容较多时可在框内滚动查看)
2.2.7 · 2026-11-10
以新增 Copilot 自动选模型、标签页快捷操作等体验改进为主,并修复多处登录与文件读取问题。
- 新增 Copilot Auto 模式,由 Copilot 自动挑选模型并享折扣,路由失败时回退到账户默认模型。
- 新增标签页操作:右键可关闭右侧全部标签,⌘W 关闭侧栏标签,⌘⇧T 恢复刚关闭的标签。
- 新增会话已读/未读标记,设为未读后红点会保留到你下次打开该会话。
- 修复 MCP 登录:多个客户端同时刷新凭据,或令牌服务短暂故障时,不再被登出。
- 优化文件读取:可用负数 offset 从文件末尾往回读,找不到文件时会提示拼写或扩展名相近的文件名。
- 优化命令结果:末尾显示退出码,被信号中断时显示信号名,超时则提示等待时长。
- 修复 Copilot 费用按实际扣费金额显示,内容被拦截时会说明是哪个过滤器拦下的。
- 注意:直接调用 @opencode/ai 的项目需改用 response.images[0],原来的 response.image 已移除。
2.2.6 · 2026-11-06
新增 MCP 连接共享、插件主题与手机端操作栏,并修复一批运行与安全问题。
- 新增 MCP 连接共享:开启后相同配置的项目共用一个连接,进程更少、启动更快。
- 新增插件自定义配色主题,插件还能在代码块上添加按钮和操作。
- 优化手机和平板界面,操作按钮更大并固定在键盘上方,点按更方便。
- 新增 opencode run -w,可在新的 git worktree 中开启会话,并用 --worktree=<name> 命名。
- 新增 opencode run --archived,脚本和 CI 会话直接归档,不出现在收件箱和会话列表。
- 修复 opencode run 退出过早的问题,现在会等后台任务结束再回复结果;注意没有超时限制,遇到常驻进程需手动中断,CI 中建议自行设置超时。
- 修复安全问题:项目里的文件无法再以服务器身份运行脚本,抓取网页时会拒绝带账号密码的网址,并逐个检查跳转链接。
- 优化首次提问的体验,连接较慢的 MCP 服务器最多等 2 秒;控制台请求 5 秒超时,启动不再卡住。
2.2.5 · 2026-10-30
新增工作树与 shell 模式快捷键,支持单独发送引用,并修复多处报错
- 新增:macOS 按 ⌘⌥O、Windows 和 Linux 按 Ctrl+Alt+O 可选择工作树,另有快捷键选择基础分支
- 新增:按 ⌘⇧X 或 Ctrl+Shift+X 可在输入框中切换 shell 模式
- 新增:在引用弹窗中按住 ⌘ 或 Ctrl,或按 ⌘Enter / Ctrl+Enter,可只发送这条引用和评论,不影响输入框其余内容
- 新增:配置文件里的 compaction.buffer 可以填百分比,例如 20%,大小窗口的模型共用同一个设置
- 优化:找不到文件夹或要修改的内容时,报错会指出缺失的路径和文件中最接近的几行,并提示改动是否已存在
- 修复:MCP 服务发送超过 10 MiB 的大消息时不再断开连接,大消息读取速度也更快
- 修复:切换模型或继续被中断的回答时,推理内容不再变成普通文本,避免部分服务商报请求错误
- 修复:超出上下文长度限制时会自动压缩而不是中断会话,连接菜单也不再重复列出 MCP 服务器
2.2.0 · 2026-10-27
桌面端界面焕新并支持插件,新增图像与决策生成接口,含多项不兼容改动
- 新增桌面插件,可创建、安装和分享,目前为实验性功能
- 桌面应用界面焕新,整体操作体验有更新
- 插件和开发接口新增图像生成、决策生成能力,属实验性
- 插件可随时给会话追加指令,不再让已有模型缓存失效
- 桌面端恢复 Todo 工具,需手动开启后才可用
- 可按服务商和模型单独设置提示缓存的有效时长
- 注意:@opencode/ai 根路径导入方式变了,OpenCode GitHub Action 已停止发布,需从工作流中移除
- 注意:TUI 插件需先升级 OpenTUI 依赖才能正常安装
1.19.4 · 2026-10-22
本次更新以安全修复为主,修补网络连接与加密传输中的隐患,建议尽快升级
- 修复网络连接、加密传输等环节的多个安全问题,降低上网时被攻击的风险
- 更新证书校验数据,打开 HTTPS 网站时识别更可靠
- 没有新增功能,日常使用感知不明显,主要是让软件运行更安全
1.19.3 · 2026-10-16
优化模型推理选项,支持按配置生成推理变体,并保留已有设置
- 新增 可为模型配置推理选项,自动生成对应的推理变体
- 内置变体列表改由配置生成,你手动设置过的变体覆盖项保持不变