Skip to content

建立 2026-09-15 更新 2026-09-15

Desktop、IDE 與 Web

TUI 不夠時,可以用桌面應用、編輯器擴充或瀏覽器。它們連的是同一套 OpenCode server,session 與設定可以共用,不必學三套 agent。

Desktop

桌面應用目前標為 beta,從 opencode.ai/downloadGitHub Releases 下載。

平台 安裝方式
macOS .dmg,或 brew install --cask opencode-desktop
Windows 安裝程式,或 Scoop extras 的 opencode-desktop
Linux .deb.rpm 或 AppImage

Desktop 會在背景啟動本機 CLI server。啟動失敗時,先暫時拿掉 opencode.json 裡的 plugin、清掉 ~/.config/opencode/plugins/,並檢查是否設了會搶 port 的 server.portOPENCODE_PORT。細節見 Troubleshooting

IDE 擴充

VS Code、Cursor、Windsurf、VSCodium 等支援終端機的編輯器都可以用。在整合終端機執行 opencode,擴充套件通常會自動安裝;也可以在 Marketplace 搜尋 OpenCode。

安裝後常見快捷鍵:

動作 macOS Windows/Linux
開啟或聚焦 OpenCode Cmd+Esc Ctrl+Esc
開新 session Cmd+Shift+Esc Ctrl+Shift+Esc
插入檔案引用 Cmd+Option+K Alt+Ctrl+K

擴充套件會帶入目前選取範圍或分頁。若自動安裝失敗,先確認 IDE 的 codecursor 等指令已進 PATH。

TUI 裡的 /editor/export 若要開這個 IDE,請設定 EDITOR,例如 export EDITOR="cursor --wait"

Web

opencode web

會在本機開 HTTP server,並用瀏覽器打開圖形介面。可指定 port:

opencode web --port 4096

預設只綁 127.0.0.1。若要讓區網連進來,才用 --hostname 0.0.0.0,並設定:

export OPENCODE_SERVER_PASSWORD="your-password"

使用者名稱預設為 opencode,可用 OPENCODE_SERVER_USERNAME 改。沒有密碼就綁到 0.0.0.0,等於把 agent 暴露在網路上。

另一個終端機可以貼上同一個 server:

opencode attach http://localhost:4096

這樣 Web 與 TUI 共用 session。無介面、只提供 HTTP API 時用 opencode serve

相關資料

推薦影音

Desktop 介面導覽

介紹 OpenCode Desktop(beta)的 Plan/Build、模型選擇與在圖形介面裡規劃任務。功能迭代快,細節以官網下載頁為準。