Claude Code 與熱門的整合開發環境 (IDE) 無縫整合,以增強您的編碼工作流程。這種整合讓您能夠直接在您偏好的開發環境中利用 Claude 的功能。

支援的 IDE

Claude Code 目前支援兩個主要的 IDE 系列:

  • Visual Studio Code(包括熱門的分支版本如 Cursor 和 Windsurf)
  • JetBrains IDE(包括 PyCharm、WebStorm、IntelliJ 和 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

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

往後您也可以在任何外部終端機中使用 /ide 命令來連接到 IDE。

這些安裝說明也適用於 VS Code 分支版本,如 Cursor 和 Windsurf。

JetBrains IDE

從市集安裝 Claude Code 外掛程式 並重新啟動您的 IDE。

當您在整合終端機中執行 claude 時,外掛程式也可能會自動安裝。必須完全重新啟動 IDE 才能生效。

遠端開發限制:使用 JetBrains 遠端開發時,您必須透過 設定 > 外掛程式(主機) 在遠端主機中安裝外掛程式。

設定

兩種整合都與 Claude Code 的設定系統配合使用。要啟用 IDE 特定功能:

  1. 在內建終端機中執行 claude 將 Claude Code 連接到您的 IDE
  2. 執行 /config 命令
  3. 將差異工具設定為 auto 以進行自動 IDE 偵測
  4. Claude Code 將根據您的 IDE 自動使用適當的檢視器

如果您使用外部終端機(不是 IDE 的內建終端機),您仍然可以在啟動 Claude Code 後使用 /ide 命令連接到您的 IDE。這讓您即使從獨立的終端機應用程式執行 Claude 也能受益於 IDE 整合功能。這適用於 VS Code 和 JetBrains IDE。

使用外部終端機時,為確保 Claude 預設能存取與您的 IDE 相同的檔案,請從與您的 IDE 專案根目錄相同的目錄啟動 Claude。

疑難排解

VS Code 擴充功能未安裝

  • 確保您從 VS Code 的整合終端機執行 Claude Code
  • 確保已安裝對應您 IDE 的 CLI:
    • 對於 VS Code:應該可以使用 code 命令
    • 對於 Cursor:應該可以使用 cursor 命令
    • 對於 Windsurf:應該可以使用 windsurf 命令
    • 如果未安裝,請使用 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 外掛程式安裝在遠端主機中,而不是在用戶端本機上

如需其他協助,請參考我們的疑難排解指南或聯繫支援團隊。