桌面应用

OpenCode 提供带有图形界面的原生桌面应用程序，在更友好的环境中提供同样强大的 AI 编程能力。

下载

直接从我们的发布页面或 opencode.ai/download 下载桌面应用。

平台	下载
macOS (Apple Silicon)	opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	opencode-desktop-darwin-x64.dmg
Windows	opencode-desktop-windows-x64.exe
Linux	.deb, .rpm, 或 AppImage

包管理器安装

macOS (Homebrew)

brew install --cask opencode-desktop

Windows (Scoop)

scoop bucket add extras
scoop install extras/opencode-desktop

功能特性

桌面应用提供终端版本的所有功能，并具有额外优势：

图形界面

具有熟悉 UI 的原生桌面窗口
拖放文件支持
系统托盘集成
键盘快捷键
多窗口支持

会话管理

多个并发会话
会话历史和书签
通过链接分享会话
导出会话日志

编辑器集成

内置代码编辑器，支持语法高亮
代码更改差异查看器
文件树导航
快速文件搜索

认证

CLI 中可用的所有认证方法在桌面应用中也可用：

OpenCode Zen：内置免费模型
GitHub Copilot：使用您现有的订阅
ChatGPT Plus/Pro：直接集成
自定义 API 密钥：配置任何提供商

配置

桌面应用将其配置存储在：

macOS: ~/Library/Application Support/opencode/
Windows: %APPDATA%\opencode\
Linux: ~/.config/opencode/

设置文件

配置存储在 config.json 中：

{
  "theme": "dark",
  "fontSize": 14,
  "model": "zen-default",
  "language": "zh-CN"
}

键盘快捷键

操作	快捷键
新建会话	`Cmd/Ctrl + N`
打开文件	`Cmd/Ctrl + O`
保存	`Cmd/Ctrl + S`
查找	`Cmd/Ctrl + F`
切换侧边栏	`Cmd/Ctrl + B`
设置	`Cmd/Ctrl + ,`
退出	`Cmd/Ctrl + Q`

自动更新

桌面应用在启动时自动检查更新。您也可以手动检查更新：

macOS: OpenCode → 检查更新...
Windows: 帮助 → 检查更新
Linux: 帮助 → 检查更新

与 CLI 比较

功能	桌面应用	CLI
图形界面	✅	❌
多会话	✅	✅
会话分享	✅	✅
文件导航	GUI	终端
资源使用	较高	较低
自动化/脚本	有限	✅
远程访问	❌	✅

故障排除

应用无法启动

检查是否已有实例在运行
验证系统要求（Node.js 18+）
检查防火墙设置

认证问题

首先从终端运行 opencode auth login
检查 API 密钥有效性
验证网络连接

性能问题

减少并发会话数量
清除会话历史
检查可用系统内存

测试版状态

桌面应用目前处于测试版。虽然稳定可用于日常使用，您可能会遇到：

偶尔的 UI 故障
版本之间的功能变化
性能变化

我们积极收集反馈以改善桌面体验。请在我们的 GitHub Issues 页面报告问题。