# OpenCode

开源 AI 编程代理的桌面客户端，用于本地项目工作和编程会话，支持可配置的模型提供商；与终端 CLI 独立。

> 这是 OpenNavo 上 OpenCode 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/opencode-desktop>

- **最新版本**: `2.3.2`
- **开发者**: Anomaly and contributors
- **主页**: <https://opencode.ai/>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask opencode-desktop`
- **近 30 天安装**: 12,679
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-arm64.dmg>
- **SHA-256**: `2c46269132d2acbd8a73ed931bb61fa39fd17e80facd815193c536c3ae4e052c`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "OpenCode.app"
      ],
      "target": "/Applications/OpenCode.app"
    },
    "phase": "install",
    "sources": [
      "OpenCode.app"
    ],
    "target": "/Applications/OpenCode.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/ai.opencode.desktop",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/ai.opencode.desktop.sfl*",
            "~/Library/Caches/ai.opencode.desktop",
            "~/Library/HTTPStorages/ai.opencode.desktop",
            "~/Library/Logs/ai.opencode.desktop",
            "~/Library/Preferences/ai.opencode.desktop.plist",
            "~/Library/Saved Application State/ai.opencode.desktop.savedState",
            "~/Library/WebKit/ai.opencode.desktop"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

OpenCode Desktop 是开源 OpenCode AI 编程智能体的图形化桌面客户端，由 Anomaly 开发。它为开发者提供桌面入口，用于操作编程智能体会话和已连接的模型提供商。此 Homebrew cask 安装 OpenCode.app；它与单独分发的 opencode 终端 CLI 不同。官方 version1 README 将桌面应用标记为测试版。

### 功能
- 通过桌面客户端，使用 AI 编程智能体处理本地项目。
- 通过智能体工作流程询问代码相关问题，并规划或实施更改。
- 选择受支持的模型提供商，并配置其身份验证和模型。
- 使用规划智能体进行分析，或使用构建智能体执行开发操作，操作受所配置的权限约束。
- 通过文档中介绍的工具、插件和 MCP 集成扩展 OpenCode 工作流程。
- 在同一 OpenCode 项目生态中，配合其独立的终端和编辑器集成使用。

### 安装与首次使用
运行 `brew install --cask opencode-desktop` 安装，或下载适用于 Apple Silicon 或 Intel 的官方 macOS DMG，并将 OpenCode.app 移至“应用程序”。启动应用，选择项目，并通过应用的连接流程配置受支持的提供商。选择可用模型，先尝试一个简单的代码问题或规划任务。根据所配置的权限，审查拟执行的文件和命令操作。README 中的 npm、shell 安装程序和 Homebrew formula 命令安装的是终端工具，而非此桌面 cask。

### 要求与依赖
正式版 Homebrew cask 要求 macOS12 或更新版本，并分别提供 ARM64 和 x64 DMG。它未声明额外的 formula 依赖。用户仅为启动打包后的桌面应用，无需安装源码仓库的开发工具链。项目所需的工具、编译器和测试命令，仍是编程智能体执行所请求工作时的依赖。使用托管模型提供商需要网络连接和相应凭据；本地模型配置则有各自的服务器和资源要求。在查阅的官方资料中，未确认固定的最低 RAM 或安装存储空间要求。当前 Apple Silicon DMG 为151,111,725 字节，这并非安装后的占用空间。

### 平台、冲突与安装详情
官方桌面版发布下载包括 macOS Apple Silicon/Intel、Windows x64，以及 Linux deb/rpm/AppImage 选项。当前 cask 也列出了 Linux AppImage 变体。不要根据源码树中的 Android/iOS 图标资源推断已有移动应用发布。此处查阅的官方 README 未列出受支持的移动端桌面发行版。

Homebrew 未声明任何具名的 cask 冲突。另一个手动安装的 OpenCode.app 可能占用相同的“应用程序”路径。独立的 OpenCode CLI 是另一种发行形式，并非已声明的冲突项。提供商服务中断、不受支持的模型设置或凭据问题可能导致模型请求失败，但这不代表桌面应用安装失败。可选的 Homebrew zap 会移除应用的支持数据、缓存、日志、偏好设置、网页存储和已保存状态；清理前请保留所需的设置和会话数据。

### 账户、费用与许可证
源码项目采用 MIT 许可证。安装桌面客户端本身并不包含无限量的托管模型访问权限。提供商身份验证、API 使用费用、订阅适用资格和模型限制取决于所选服务；OpenCode 的可选托管服务另有条款。请查阅提供商的官方文档，不要假定某项订阅可用于所有提供商连接。本地提供商需要单独配置本地模型服务。查阅的 README 未声明桌面客户端普遍需要付费许可证。

### 官方参考资料
- [Version1 源码、桌面版下载与智能体工作流程](https://github.com/anomalyco/opencode/tree/v1.18.35)
- [官方下载页面](https://opencode.ai/download)
- [提供商文档](https://opencode.ai/docs/providers/)
- [MIT 许可证](https://github.com/anomalyco/opencode/blob/v1.18.35/LICENSE)
- [官方发布记录](https://github.com/anomalyco/opencode/releases)

### 产品系列的历史工作流程
官方仓库 README 嵌入了所提供的终端界面图片。图片清晰标明 OpenCode v0.3.11，并展示了智能体会话审查代码更改的过程。这是真实的历史 OpenCode 产品系列终端工作流程，而非当前 1.18.35 桌面应用的截图。桌面客户端和终端客户端仍为独立发行版本，可能呈现不同的界面。

## 系统要求

- macOS 13 起 · 应用版本: 2.3.2 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 核查于 2026-11-21
  - <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-x64.dmg>
  - SHA-256: `c9a59afda0860667cab904423d8ab0c1b63adb181a57f125f84e63e6555b93c3`
- macOS 13 起 · 应用版本: 2.3.2 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 核查于 2026-11-21
  - <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-arm64.dmg>
  - SHA-256: `2c46269132d2acbd8a73ed931bb61fa39fd17e80facd815193c536c3ae4e052c`

## OpenCode 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/anomalyco/opencode> · 是否开源: 是 — <https://github.com/anomalyco/opencode> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask opencode-desktop`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask opencode-desktop`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/ai.opencode.desktop.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/HTTPStorages/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Logs/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/ai.opencode.desktop.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/ai.opencode.desktop.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/WebKit/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 38252-videos-prerelease (2026-07-22)

Before/after verification recordings for PR #38252.

## 资料与来源

- <https://opennavo.com/zh/apps/opencode-desktop>
- <https://opennavo.com/zh/apps/opencode-desktop/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · 核查于 2026-11-21
- <https://formulae.brew.sh/cask/opencode-desktop>
- <https://github.com/anomalyco/opencode> · 核查于 2026-11-13
