支援的 JetBrains IDE 總覽

Claude Code 的 JetBrains Plugin 目前處於 Beta 階段，但已支援絕大多數 JetBrains 系列 IDE。以下是官方確認支援的 IDE 列表：

只要你的 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 中使用效率的關鍵。以下是所有重要的快捷鍵整理：

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 版在 GUI 整合方面更為完善，提供了原生面板、多對話管理、Plugin GUI 管理等功能。而 JetBrains 版雖然在介面上相對簡約，但核心的 Diff 檢視、選取共享和診斷同步功能同樣完整。如果你是 JetBrains 的重度使用者，不需要為了 Claude Code 切換到 VS Code，JetBrains Plugin 已經能滿足大部分開發需求。

Plugin 設定詳解

安裝 Plugin 後，你可以在 Settings → Tools → Claude Code [Beta] 中進行細部設定。以下是各項設定的說明：

特殊環境設定

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 有權限修改哪些檔案。這些安全建議在團隊協作環境中尤其重要。

總結

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 的進階功能。如果你在整合過程中遇到任何問題，歡迎在下方留言討論。

ㄚ槌

blog.che-ya.com