Claude Code 與任何具有終端機的整合開發環境 (IDE) 都能完美配合。只需執行 claude，您就可以開始使用了。

此外，Claude Code 為熱門的 IDE 提供專用整合功能，提供互動式差異檢視、選取內容分享等功能。這些整合功能目前支援：

  • Visual Studio Code（包括 Cursor、Windsurf 和 VSCodium 等熱門分支）
  • JetBrains IDE（包括 IntelliJ、PyCharm、Android Studio、WebStorm、PhpStorm 和 GoLand）

​
功能

  • 快速啟動：使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接從編輯器開啟 Claude Code，或點擊 UI 中的 Claude Code 按鈕
  • 差異檢視：程式碼變更可以直接在 IDE 差異檢視器中顯示，而不是在終端機中。您可以在 /config 中設定此功能
  • 選取內容：IDE 中目前的選取項目/分頁會自動與 Claude Code 分享
  • 檔案參考快捷鍵：使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入檔案參考（例如 @File#L1-99）
  • 診斷分享：IDE 的診斷錯誤（lint、語法等）會在您工作時自動與 Claude 分享

​
安裝

要在 VS Code 和 Cursor、Windsurf、VSCodium 等熱門分支上安裝 Claude Code：

  1. 開啟 VS Code
  2. 開啟整合終端機
  3. 執行 claude - 擴充功能將自動安裝

​
使用方式

​
從您的 IDE

從您 IDE 的整合終端機執行 claude，所有功能都將啟用。

​
從外部終端機

在任何外部終端機中使用 /ide 指令將 Claude Code 連接到您的 IDE 並啟用所有功能。

如果您希望 Claude 能夠存取與您 IDE 相同的檔案，請從與您 IDE 專案根目錄相同的目錄啟動 Claude Code。

​
設定

IDE 整合功能與 Claude Code 的設定系統配合使用：

  1. 執行 claude
  2. 輸入 /config 指令
  3. 調整您的偏好設定。將差異工具設定為 auto 將啟用自動 IDE 偵測

​
JetBrains 外掛程式設定

您可以前往 設定 → 工具 → Claude Code [Beta] 來設定 Claude Code 外掛程式設定。以下是可用的設定：

​
一般設定

  • Claude 指令：指定自訂指令來執行 Claude（例如 claude、/usr/local/bin/claude 或 npx @anthropic/claude），當點擊 Claude 圖示時使用
  • 隱藏找不到 Claude 指令的通知：跳過關於找不到 Claude 指令的通知
  • 啟用 Option+Enter 進行多行提示（僅限 macOS）：啟用時，Option+Enter 會在 Claude Code 提示中插入新行。如果您遇到 Option 鍵意外被擷取的問題，請停用此功能（需要重新啟動終端機）
  • 啟用自動更新：自動檢查並安裝外掛程式更新（重新啟動時套用）

對於 WSL 使用者：您可能會發現將 wsl -d Ubuntu -- bash -lic "claude" 設定為您的 Claude 指令很有用（將 Ubuntu 替換為您的 WSL 發行版名稱）

​
ESC 鍵設定

如果 ESC 鍵無法中斷 JetBrains 終端機中的 Claude Code 操作：

  1. 前往設定 → 工具 → 終端機
  2. 選擇以下其中一項：
    • 取消勾選「使用 Escape 將焦點移至編輯器」，或
    • 點擊「設定終端機按鍵綁定」並刪除「切換焦點至編輯器」快捷鍵
  3. 套用變更

這樣可以讓 ESC 鍵正確中斷 Claude Code 操作。

​
疑難排解

​
VS Code 擴充功能未安裝

  • 確保您從 VS Code 的整合終端機執行 Claude Code
  • 確保已安裝與您 IDE 對應的 CLI：
    • 對於 VS Code：應該可以使用 code 指令
    • 對於 Cursor：應該可以使用 cursor 指令
    • 對於 Windsurf：應該可以使用 windsurf 指令
    • 對於 VSCodium：應該可以使用 codium 指令
    • 如果未安裝，請使用 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）並搜尋「Shell Command: Install ‘code’ command in PATH」（或您 IDE 的對應指令）
  • 檢查 VS Code 是否有安裝擴充功能的權限

​
JetBrains 外掛程式無法運作

  • 確保您從專案根目錄執行 Claude Code
  • 檢查 JetBrains 外掛程式是否在 IDE 設定中啟用
  • 完全重新啟動 IDE。您可能需要多次執行此操作
  • 對於 JetBrains 遠端開發，請確保 Claude Code 外掛程式安裝在遠端主機上，而不是在用戶端本機上

如果您使用 WSL 或 WSL2 且未偵測到 IDE，請參閱我們的 WSL2 疑難排解指南，了解網路設定和防火牆設定。

如需其他協助，請參閱我們的疑難排解指南。

​
安全性

當 Claude Code 在啟用自動編輯權限的 IDE 中執行時，它可能能夠修改可由您的 IDE 自動執行的 IDE 設定檔。這可能會增加在自動編輯模式下執行 Claude Code 的風險，並允許繞過 Claude Code 對 bash 執行的權限提示。在 IDE 中執行時，請考慮啟用 IDE 安全功能（例如 VS Code 限制模式）、對編輯使用手動核准模式，或格外小心確保 Claude 僅用於受信任的提示。