支援的 IDEs
Claude Code 外掛程式適用於大多數 JetBrains IDEs,包括:- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
功能
- 快速啟動:使用
Cmd+Esc
(Mac) 或Ctrl+Esc
(Windows/Linux) 直接從編輯器開啟 Claude Code,或點擊 UI 中的 Claude Code 按鈕 - 差異檢視:程式碼變更可以直接在 IDE 差異檢視器中顯示,而不是在終端機中
- 選取內容:IDE 中目前的選取範圍/分頁會自動與 Claude Code 分享
- 檔案參考快捷鍵:使用
Cmd+Option+K
(Mac) 或Alt+Ctrl+K
(Linux/Windows) 插入檔案參考(例如 @File#L1-99) - 診斷分享:IDE 中的診斷錯誤(lint、語法等)會在您工作時自動與 Claude 分享
安裝
Marketplace 安裝
從 JetBrains marketplace 尋找並安裝 Claude Code 外掛程式,然後重新啟動您的 IDE。自動安裝
當您在整合終端機中執行claude
時,外掛程式也可能會自動安裝。必須完全重新啟動 IDE 才能生效。
安裝外掛程式後,您必須完全重新啟動 IDE 才能生效。您可能需要重新啟動多次。
使用方式
從您的 IDE
從 IDE 的整合終端機執行claude
,所有整合功能都會啟用。
從外部終端機
在任何外部終端機中使用/ide
命令將 Claude Code 連接到您的 JetBrains IDE 並啟用所有功能:
設定
Claude Code 設定
透過 Claude Code 的設定來配置 IDE 整合:- 執行
claude
- 輸入
/config
命令 - 將差異工具設定為
auto
以進行自動 IDE 偵測
外掛程式設定
透過前往 Settings → Tools → Claude Code [Beta] 來配置 Claude Code 外掛程式:一般設定
- Claude 命令:指定執行 Claude 的自訂命令(例如
claude
、/usr/local/bin/claude
或npx @anthropic/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 操作:- 前往 Settings → Tools → Terminal
- 執行以下任一操作:
- 取消勾選「使用 Escape 將焦點移至編輯器」,或
- 點擊「配置終端機按鍵綁定」並刪除「切換焦點至編輯器」快捷鍵
- 套用變更
特殊設定
遠端開發
使用 JetBrains Remote Development 時,您必須透過 Settings → Plugin (Host) 在遠端主機中安裝外掛程式。
WSL 設定
WSL 使用者可能需要額外設定才能讓 IDE 偵測正常運作。請參閱我們的 WSL 疑難排解指南 以取得詳細的設定說明。
- 適當的終端機設定
- 網路模式調整
- 防火牆設定更新
疑難排解
外掛程式無法運作
- 確保您從專案根目錄執行 Claude Code
- 檢查 JetBrains 外掛程式是否在 IDE 設定中啟用
- 完全重新啟動 IDE(您可能需要執行多次)
- 對於 Remote Development,確保外掛程式安裝在遠端主機中
IDE 未偵測到
- 驗證外掛程式已安裝並啟用
- 完全重新啟動 IDE
- 檢查您是否從整合終端機執行 Claude Code
- 對於 WSL 使用者,請參閱 WSL 疑難排解指南
找不到命令
如果點擊 Claude 圖示顯示「找不到命令」:- 驗證 Claude Code 已安裝:
npm list -g @anthropic-ai/claude-code
- 在外掛程式設定中配置 Claude 命令路徑
- 對於 WSL 使用者,使用設定部分中提到的 WSL 命令格式
安全考量
當 Claude Code 在啟用自動編輯權限的 JetBrains IDE 中執行時,它可能能夠修改可由您的 IDE 自動執行的 IDE 設定檔。這可能會增加在自動編輯模式下執行 Claude Code 的風險,並允許繞過 Claude Code 對 bash 執行的權限提示。 在 JetBrains IDEs 中執行時,請考慮:- 對編輯使用手動核准模式
- 格外小心確保 Claude 僅用於受信任的提示
- 了解 Claude Code 有權修改哪些檔案