Skip to main content
按你看到的提示往下對。還是不行，把 輸出 → CC GUI 裡的日誌和復現步驟發到 GitHub Issues。

​
安裝和開啟

搜尋 CCGUI 或 MossX。完整顯示名是 CCGUI / CC GUI（Claude Codex OpenCode Kimi），擴充功能 ID 是 MossX.vscode-cc-gui。也可以開啟 Marketplace 頁面 再點安裝。VS Code 需要 1.85 或更高版本。
先開啟一個工作區資料夾。沒有專案根目錄時，檔案引用、會話和工作目錄都缺少上下文。然後點 Activity Bar 的 CC GUI，或執行 CC GUI: Open CC GUI。

​
Node.js 和 SDK

CC GUI 需要 Node.js 20+，而且只用擴充功能自己的路徑，不改專案終端。
  1. 另裝一份 Node 20+
  2. 執行 node -p "process.execPath"
  3. 把完整路徑填到 設定 → 基礎配置 → 環境，或 ccGui.nodePath
  4. Windows 必須指向 node.exe
詳見 準備環境。
開啟 設定 → SDK 依賴，安裝 Claude Agent SDK 或 Codex SDK。對話區的 前往安裝 會跳到這一頁。Codex 如果缺 CLI 完整性，也會顯示為未安裝，需要重新裝一遍。
把安裝日誌複製給本機終端裡的 AI 或發到 GitHub。常見原因：
  • Node 路徑不對
  • npm 登錄檔或網路被攔
  • 使用者目錄 ~/.codemoss/dependencies/ 沒有寫許可權

​
供應商和登入

開啟 設定 → 供應商管理 → Claude Code，任選一種：
  • 新增帶 API Key 的供應商
  • 授權讀取 ~/.claude/settings.json
  • 授權使用已有的 CLI 登入
取消本地 settings.json 授權後，必須再啟用另一份供應商，否則 Claude 會一直處於未啟用狀態。
對 Claude：
  1. 終端登入成功
  2. ~/.claude/settings.json 的 env 保持為空
  3. 重啟 VS Code
  4. 仍不行時，再按 Claude Code 裡的代理示例加 HTTP_PROXY
對 Codex：先 codex login，再授權讀取 ~/.codex/，然後重啟 VS Code。
擴充功能不會代裝 Grok / Kimi / OpenCode / Pi。先在系統終端確認 xxx --version 能跑，再回到 設定 → 供應商管理 → CLI 點 重新檢測。從 Dock / 開始選單啟動的 VS Code 有時讀不到終端裡的 PATH。把安裝目錄寫進系統環境變數，再重啟 VS Code。詳見 檢測與安裝。

​
對話過程

依次檢查：
  1. 當前供應商是否已啟用
  2. SDK 或 CLI 是否就緒
  3. 是否卡在許可權 / 提問對話方塊
  4. 輸出 → CC GUI 有沒有報錯
0.1.3 起，停止會結束 Grok / Kimi / OpenCode / Pi 的子程序。請升級到 Marketplace 最新版。使用者主動停止後，完成 toast 和提示音不會再響。
0.1.3 修復了延遲迴寫導致的殘留。升級後仍出現，就再開一個編輯器標籤，不要複用當前標籤。
0.1.2 修復了多步工具結束後轉圈不消失的問題。先升級。仍復現時開啟除錯日誌，保留那一輪對話再提單。
0.1.1 修復了工具條被裁切的問題。升級後如果還點不到，把側欄拉寬，或把 CC GUI 開到編輯器標籤裡。
0.1.2 起圖片會透過 --prompt-file 傳給 Grok。請升級，並確認附件縮圖還在輸入框裡。

​
除錯

  1. 開啟 設定 → 基礎配置 → 行為 → 除錯日誌，或勾選 ccGui.enableDebugLog
  2. 日誌在 檢視 → 輸出 → CC GUI
  3. 檢視標題欄會出現開發者工具按鈕；也可執行 CC GUI: Open Webview Developer Tools
除錯日誌預設關閉。