Claude Code 不僅能在終端機獨立運行,更可以與主流 IDE 深度整合。前一篇我們介紹了 VS Code 的擴充功能,這次要帶你走進 JetBrains 生態系。無論你使用的是 IntelliJ IDEA、WebStorm、PyCharm 還是 GoLand,都可以透過官方 Plugin 讓 Claude Code 直接在 IDE 中運作,享受 Diff 檢視、選取內容共享、診斷訊息同步等整合功能。本篇教學將從安裝設定開始,一步步帶你完成 JetBrains IDE 的 Claude Code 整合。這篇會完整介紹 Claude Code JetBrains。
本文目錄
支援的 JetBrains IDE 總覽
Claude Code 的 JetBrains Plugin 目前處於 Beta 階段,但已支援絕大多數 JetBrains 系列 IDE。以下是官方確認支援的 IDE 列表:
| IDE | 主要用途 | 支援狀態 |
|---|---|---|
| IntelliJ IDEA | Java / Kotlin 開發 | ✅ 支援 |
| WebStorm | JavaScript / TypeScript 開發 | ✅ 支援 |
| PyCharm | Python 開發 | ✅ 支援 |
| GoLand | Go 開發 | ✅ 支援 |
| PhpStorm | PHP 開發 | ✅ 支援 |
| Android Studio | Android 應用開發 | ✅ 支援 |
只要你的 JetBrains IDE 支援 Plugin Marketplace,基本上都能安裝 Claude Code Plugin。如果你同時使用多個 JetBrains IDE,每個 IDE 都需要個別安裝 Plugin。
安裝與環境準備
前置條件
在安裝 JetBrains Plugin 之前,你需要先確保 Claude Code CLI 已經安裝在系統上。如果還沒安裝,請透過 npm 進行安裝:
npm install -g @anthropic-ai/claude-code安裝完成後,在終端機執行 claude 確認可以正常啟動,並完成帳號登入。這是 JetBrains Plugin 運作的基礎,因為 Plugin 本質上是在 IDE 內部呼叫 Claude Code CLI。
安裝 JetBrains Plugin
安裝 Plugin 有兩種方式,你可以選擇最方便的一種:
方法一:從 IDE 內部安裝
開啟你的 JetBrains IDE,進入 Settings → Plugins → Marketplace,搜尋「Claude Code」,找到標示為 [Beta] 的官方 Plugin,點擊 Install 並重新啟動 IDE。
方法二:從 JetBrains Marketplace 網站安裝
前往 JetBrains Marketplace 搜尋 Claude Code Plugin,點擊 Install 按鈕,系統會自動開啟你的 IDE 並完成安裝。安裝後務必重新啟動 IDE,有時候可能需要重啟多次才能完全生效。
核心功能介紹
JetBrains Plugin 的設計理念是將 Claude Code 的強大能力無縫嵌入你熟悉的開發環境中。以下是幾個核心功能:
快速啟動(Quick Launch)
安裝 Plugin 後,你可以透過快捷鍵快速呼叫 Claude Code,不需要手動切換到終端機。在 macOS 上使用 Cmd+Esc,在 Windows/Linux 上使用 Ctrl+Esc,即可直接在 IDE 中開啟 Claude Code 介面。你也可以點擊 IDE 工具列上的 Claude Code 按鈕來啟動。
IDE 內建 Diff 檢視
這是 JetBrains Plugin 最實用的功能之一。當 Claude 提出程式碼修改建議時,變更內容會直接在 IDE 的 Diff Viewer 中顯示,而不是在終端機裡用純文字呈現。你可以用 JetBrains 原生的並排比對介面來檢視修改前後的差異,逐行確認後再決定是否接受。這比在終端機中閱讀 patch 格式的輸出要直觀得多。
選取內容自動共享
當你在編輯器中選取一段程式碼,Plugin 會自動將選取的內容與目前開啟的檔案資訊傳送給 Claude Code。這意味著你不需要手動複製貼上程式碼,Claude 就能理解你正在處理的上下文。搭配快捷鍵 Cmd+Option+K(macOS)或 Alt+Ctrl+K(Windows/Linux),你還可以快速插入檔案參考(例如 @File#L1-99),精確指定 Claude 應該關注的程式碼範圍。
診斷訊息同步
你的 IDE 偵測到的所有診斷資訊——包括語法錯誤、lint 警告、型別錯誤等——都會自動同步給 Claude。這讓 Claude 可以主動發現問題並提供修正建議,不需要你額外描述錯誤訊息的內容。當你正在除錯時,這個功能特別有用。
Terminal 整合方式
在 JetBrains IDE 中使用 Claude Code,有兩種主要的 Terminal 整合方式:
從 IDE 內建終端機啟動
最簡單的方式就是直接在 JetBrains IDE 的內建終端機中執行 claude 指令。當 Plugin 已安裝且 IDE 正在運行時,所有整合功能(Diff 檢視、選取共享、診斷同步)都會自動啟用,不需要額外設定。
# 在 JetBrains IDE 的內建終端機中
claude從外部終端機連接
如果你習慣使用外部終端機(例如 iTerm2、Windows Terminal 或系統終端機),可以在啟動 Claude Code 後使用 /ide 指令來連接你的 JetBrains IDE:
# 在外部終端機中
claude
# 進入 Claude Code 後輸入
/ide使用外部終端機時,建議從與 IDE 專案相同的根目錄啟動 Claude Code,這樣 Claude 才能正確存取你的專案檔案。
快捷鍵與操作技巧
熟悉快捷鍵是提升 Claude Code 在 JetBrains IDE 中使用效率的關鍵。以下是所有重要的快捷鍵整理:
| 功能 | macOS | Windows / Linux |
|---|---|---|
| 開啟 Claude Code | Cmd+Esc | Ctrl+Esc |
| 插入檔案參考 | Cmd+Option+K | Alt+Ctrl+K |
| 中斷 Claude 操作 | Esc | Esc |
| 多行輸入 | Option+Enter | 需在設定中啟用 |
ESC 鍵衝突處理
在 JetBrains IDE 中,ESC 鍵預設的行為是將焦點從終端機移回編輯器。這會導致你無法用 ESC 中斷 Claude Code 的操作。要解決這個問題,進入 Settings → Tools → Terminal,取消勾選「Move focus to the editor with Escape」,或者點擊「Configure terminal keybindings」刪除「Switch focus to Editor」的快捷鍵設定。
實用操作技巧
除了快捷鍵之外,以下幾個技巧可以讓你的使用體驗更順暢:
善用選取 + 快捷鍵工作流:先在編輯器中選取你想修改的程式碼,然後按 Cmd+Esc 開啟 Claude Code,選取的內容會自動作為上下文傳送。接著直接描述你想要的修改,Claude 就會根據選取的程式碼給出建議。
使用 @ 符號引用檔案:在 Claude Code 的對話中,你可以用 @filename 的方式引用專案中的檔案。搭配 Cmd+Option+K 快捷鍵可以快速插入目前編輯中檔案的參考,包含行號範圍。
自訂 Claude 指令路徑:如果你的 Claude Code CLI 安裝在非標準路徑,可以在 Settings → Tools → Claude Code [Beta] 中設定自訂的指令路徑,例如 /usr/local/bin/claude 或 npx @anthropic/claude。
與 VS Code 版的功能差異比較
Claude Code 在 VS Code 和 JetBrains 中的整合方式有本質上的差異。VS Code 版提供的是原生圖形化介面(GUI Extension),而 JetBrains 版主要是透過 Plugin 將 CLI 嵌入 IDE 的終端機環境。以下是詳細的功能比較:
| 功能項目 | VS Code | JetBrains |
|---|---|---|
| 介面類型 | 原生 GUI 面板 | CLI 嵌入終端機 |
| Diff 檢視 | ✅ IDE 內建 Diff | ✅ IDE 內建 Diff |
| 選取內容共享 | ✅ 支援 | ✅ 支援 |
| 診斷訊息同步 | ✅ 支援 | ✅ 支援 |
| 多對話分頁 | ✅ 多分頁 / 多視窗 | ❌ 不支援 |
| 對話歷史瀏覽 | ✅ GUI 列表 | ⚠️ 僅 CLI 方式 |
| Plan 模式 | ✅ 完整支援 | ⚠️ 僅 CLI 方式 |
| Plugin 管理介面 | ✅ GUI 管理 | ⚠️ 僅 CLI 方式 |
| Checkpoint(程式碼還原點) | ✅ GUI 支援 | ✅ CLI 支援 |
| 快速啟動快捷鍵 | Cmd+Esc | Cmd+Esc |
| @ 檔案引用 | Option+K | Cmd+Option+K |
| URI Handler 支援 | ✅ 支援 | ❌ 不支援 |
從比較中可以看出,VS Code 版在 GUI 整合方面更為完善,提供了原生面板、多對話管理、Plugin GUI 管理等功能。而 JetBrains 版雖然在介面上相對簡約,但核心的 Diff 檢視、選取共享和診斷同步功能同樣完整。如果你是 JetBrains 的重度使用者,不需要為了 Claude Code 切換到 VS Code,JetBrains Plugin 已經能滿足大部分開發需求。
Plugin 設定詳解
安裝 Plugin 後,你可以在 Settings → Tools → Claude Code [Beta] 中進行細部設定。以下是各項設定的說明:
| 設定項目 | 說明 | 預設值 |
|---|---|---|
| Claude command | 指定 Claude CLI 的執行路徑 | claude |
| Suppress notification | 隱藏找不到 Claude 指令的通知 | 關閉 |
| Enable Option+Enter | 啟用 Option+Enter 進行多行輸入(僅 macOS) | 關閉 |
| Enable automatic updates | 自動檢查並安裝 Plugin 更新 | 開啟 |
特殊環境設定
Remote Development 遠端開發
如果你使用 JetBrains 的 Remote Development 功能進行遠端開發,有一個非常重要的注意事項:Plugin 必須安裝在遠端主機上,而不是你的本地客戶端。進入 Settings → Plugin (Host) 進行安裝,否則 Plugin 將無法正常運作。
WSL(Windows Subsystem for Linux)設定
Windows 使用者如果透過 WSL 執行開發環境,需要額外的設定才能讓 IDE 正確偵測 Claude Code。首先,在 Plugin 設定中將 Claude command 設為:
wsl -d Ubuntu -- bash -lic "claude"將指令中的 Ubuntu 替換為你實際使用的 WSL 發行版名稱。此外,可能還需要調整 WSL 的網路模式和防火牆設定,詳細步驟可參考官方的 WSL 疑難排解指南。
常見問題與疑難排解
在使用 JetBrains Plugin 的過程中,你可能會遇到一些常見問題。以下是排解方式整理:
Plugin 安裝後沒有反應
這是最常見的問題。請依序檢查以下項目:確認 Claude Code CLI 已正確安裝(執行 npm list -g @anthropic-ai/claude-code 檢查)、確認 Plugin 在 IDE 設定中處於啟用狀態、完全關閉並重新啟動 IDE(有時需要重啟多次)、確認你是從專案根目錄啟動 Claude Code。
IDE 無法被偵測
如果你從外部終端機啟動 Claude Code,但 /ide 指令無法偵測到你的 JetBrains IDE,請確認 Plugin 已安裝並啟用、IDE 正在運行中、嘗試完全重新啟動 IDE。WSL 使用者需要額外確認網路設定是否正確。
點擊 Claude 按鈕顯示 Command Not Found
這表示 Plugin 找不到 Claude Code CLI。解決方式:先確認 CLI 已安裝(npm list -g @anthropic-ai/claude-code),然後在 Plugin 設定中明確指定 Claude 指令的完整路徑。如果你使用 nvm 等版本管理工具,CLI 的路徑可能不在預設的 PATH 中,需要手動設定。
安全性注意事項
在 JetBrains IDE 中使用 Claude Code 時,需要特別注意安全性。當 Claude Code 以自動編輯(auto-edit)權限運行時,它可能會修改 IDE 的設定檔案,而這些檔案可能被 IDE 自動執行。這意味著存在繞過 Claude Code 權限提示的風險。
為了降低風險,建議你:使用手動核准模式(manual approval mode)來審查每一次編輯、確保 Claude 只處理來自信任來源的提示、注意 Claude Code 有權限修改哪些檔案。這些安全建議在團隊協作環境中尤其重要。
延伸參考:Claude Code 官方文件(英文)
Claude Code JetBrains 總結
JetBrains IDE 中使用 Claude Code 的體驗,雖然在 GUI 層面不如 VS Code 版本豐富,但核心功能——Diff 檢視、選取共享、診斷同步——一個都沒少。對於 JetBrains 生態系的開發者來說,不需要為了使用 Claude Code 而切換 IDE,透過 Plugin 就能在熟悉的開發環境中享受 AI 輔助開發的便利。
安裝流程很簡單:裝好 CLI、裝好 Plugin、重啟 IDE,三步就搞定。日常使用時善用 Cmd+Esc 快速啟動和 Cmd+Option+K 檔案引用快捷鍵,就能大幅提升與 Claude 協作的效率。如果你同時使用多個 JetBrains IDE,記得每個 IDE 都需要個別安裝 Plugin。
下一篇文章,我們將繼續探索 Claude Code 的進階功能。如果你在整合過程中遇到任何問題,歡迎在下方留言討論。
嗨,我是ㄚ槌,寫了十多年程式的全端工程師,也就是站名裡的那個「小人物」。平常跟 bug 搏鬥,順手把踩過的坑整理成筆記:Claude Code 與 AI 開發、Python、SQL,偶爾也玩 ESP32 智慧家庭、NAS 自架服務和網頁開發。希望這些筆記能幫你少踩幾個坑。