​
VS Code 擴充功能（Beta）

VS Code 擴充功能目前提供 beta 版本，讓您透過直接整合到 IDE 中的原生圖形介面即時查看 Claude 的變更。VS Code 擴充功能讓偏好視覺介面而非終端機的使用者更容易存取和互動 Claude Code。

​
功能

VS Code 擴充功能提供：
  • 原生 IDE 體驗：透過 Spark 圖示存取專用的 Claude Code 側邊欄面板
  • 具編輯功能的計畫模式：在接受 Claude 的計畫之前檢視和編輯
  • 自動接受編輯模式：在 Claude 進行變更時自動套用
  • 檔案管理：使用 @ 提及檔案或使用系統檔案選擇器附加檔案和圖片
  • MCP 伺服器使用：使用透過 CLI 設定的模型上下文協定伺服器
  • 對話歷史：輕鬆存取過去的對話
  • 多重工作階段：同時執行多個 Claude Code 工作階段
  • 鍵盤快捷鍵：支援 CLI 中的大部分快捷鍵
  • 斜線命令：直接在擴充功能中存取大部分 CLI 斜線命令

​
需求

  • VS Code 1.98.0 或更高版本

​
安裝

從 Visual Studio Code Extension Marketplace 下載並安裝擴充功能。

​
更新

要更新 VS Code 擴充功能：
  1. 使用 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）開啟 VS Code 命令面板
  2. 搜尋「Claude Code: Update」
  3. 選擇命令以更新到最新版本

​
運作方式

安裝完成後，您可以透過 VS Code 介面開始使用 Claude Code：
  1. 點擊編輯器側邊欄中的 Spark 圖示以開啟 Claude Code 面板
  2. 以與在終端機中相同的方式提示 Claude Code
  3. 觀看 Claude 分析您的程式碼並建議變更
  4. 直接在介面中檢視和接受編輯
    • 提示：將側邊欄拖寬以查看內嵌差異，然後點擊它們以展開查看完整詳細資訊

​
尚未實作

以下功能在 VS Code 擴充功能中尚未提供：
  • 完整 MCP 伺服器設定：您需要先透過 CLI 設定 MCP 伺服器，然後擴充功能會使用它們
  • 子代理設定：透過 CLI 設定子代理以在 VS Code 中使用它們
  • 檢查點：在特定點儲存和還原對話狀態
  • 進階快捷鍵：
    • # 快捷鍵以新增到記憶體
    • ! 快捷鍵直接執行 bash 命令
  • Tab 自動完成：使用 tab 鍵進行檔案路徑自動完成
我們正在努力在未來的更新中新增這些功能。

​
安全性考量

當 Claude Code 在 VS Code 中執行且啟用自動編輯權限時，它可能能夠修改可由您的 IDE 自動執行的 IDE 設定檔。這可能會增加在自動編輯模式下執行 Claude Code 的風險，並允許繞過 Claude Code 對 bash 執行的權限提示。 在 VS Code 中執行時，請考慮：
  • 為不受信任的工作區啟用 VS Code 限制模式
  • 對編輯使用手動核准模式
  • 格外小心確保 Claude 僅與受信任的提示一起使用

​
舊版 CLI 整合

我們發布的第一個 VS Code 整合允許在終端機中執行的 Claude Code 與您的 IDE 互動。它提供選擇上下文共享（目前選擇/分頁會自動與 Claude Code 共享）、在 IDE 而非終端機中檢視差異、檔案參考快捷鍵（Mac 上的 Cmd+Option+K 或 Windows/Linux 上的 Alt+Ctrl+K 以插入檔案參考如 @File#L1-99），以及自動診斷共享（lint 和語法錯誤）。 舊版整合會在您從 VS Code 的整合終端機執行 claude 時自動安裝。只需從終端機執行 claude，所有功能即會啟動。對於外部終端機，使用 /ide 命令將 Claude Code 連接到您的 VS Code 實例。要設定，執行 claude，輸入 /config，並將差異工具設定為 auto 以進行自動 IDE 偵測。 擴充功能和 CLI 整合都適用於 Visual Studio Code、Cursor、Windsurf 和 VSCodium。

​
疑難排解

​
擴充功能無法安裝

  • 確保您有相容版本的 VS Code（1.85.0 或更高版本）
  • 檢查 VS Code 是否有安裝擴充功能的權限
  • 嘗試直接從市集網站安裝

​
舊版整合無法運作

  • 確保您從 VS Code 的整合終端機執行 Claude Code
  • 確保您的 IDE 變體的 CLI 已安裝：
    • VS Code：code 命令應該可用
    • Cursor：cursor 命令應該可用
    • Windsurf：windsurf 命令應該可用
    • VSCodium：codium 命令應該可用
  • 如果命令未安裝：
    1. 使用 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）開啟命令面板
    2. 搜尋「Shell Command: Install ‘code’ command in PATH」（或您的 IDE 的對應命令）
如需其他協助，請參閱我們的疑難排解指南。