註冊
Claude

Claude Code JetBrains 插件怎麼用：IDEA / PyCharm 安裝與配置

在 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 裏用 Claude Code：先裝命令行版再裝插件、/ide 連接、IDE 內看 diff、引用文件快捷鍵、WSL 和遠程開發的配置，以及常見報錯。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-10-07 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 Claude Code 官方文檔《JetBrains IDEs》整理，核對日期 2026-10-07。插件目前在 JetBrains Marketplace 上標註為 Beta，選單名稱以實際介面為準。

適用於誰

  • 用 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、Android Studio 寫代碼，想在 IDE 裏用 Claude Code 的人；
  • 搜「claude code idea 使用教學」「idea 安裝」「jetbrains plugin」的人；
  • 在 Windows + WSL 環境下遇到「No available IDEs detected」的人。

結論先說

  1. JetBrains 插件和 VS Code 擴展不一樣：它不自帶 Claude Code，而是在 IDE 的內置終端裏運行你本機的 claude 命令並與之連接，所以要先裝命令行版，再裝插件。
  2. 裝好後在 IDE 內置終端裏運行 claude，集成功能自動生效；在外部終端裏運行的話，輸入 /ide 手動連接。
  3. 集成後的好處：改動在 IDE 自帶的 diff 查看器裏顯示；當前選中內容和打開的文件會自動發給 Claude；Claude 能讀取 IDE 的檢查結果（語法錯誤、lint 警告）。
  4. 帳號要求和命令行版相同：任一付費訂閱（Pro / Max / Team / Enterprise）或 Console 帳號，不需要 API Key。
  5. 官方安全提醒：在 JetBrains 裏用 acceptEdits 或 auto 模式時，Claude 可能改到 IDE 會自動執行的配置文件，建議改文件用 Manual 模式。

步驟

1. 先裝 Claude Code 命令行版

按官方快速開始安裝，裝好後在終端裏確認：

bash
claude --version

安裝命令和登入方法詳見本站《Claude Code 中文入門教學（2026）：安裝、登入、第一個任務、常用命令》。如果沒裝好，插件會彈出「Cannot launch Claude Code」提示。

2. 安裝 JetBrains 插件

在 IDE 裏打開「Settings → Plugins → Marketplace」，搜尋「Claude Code」（發佈者 Anthropic），安裝後重啟 IDE。也可以從 JetBrains Marketplace 網頁安裝。

支持的 IDE 包括 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 等大多數 JetBrains 產品。

3. 啟動並連接

方式一（推薦）：在 IDE 內置終端運行

打開 IDE 底部的 Terminal，進入項目根目錄運行 claude，所有集成功能自動生效。也可以按 Ctrl+Esc（Mac 是 Cmd+Esc）或點介面上的 Claude Code 按鈕快速啟動。第一次運行會讓你登入。

方式二：在外部終端運行後連接

bash
claude

然後在會話裏輸入：

text
/ide

看到類似 Connected to IntelliJ IDEA. 就說明連上了。如果檢測到正在運行的 IDE 還沒裝插件，/ide 會替你安裝並提示重啟 IDE。想讓 Claude 看到和 IDE 相同的文件，記得從 IDE 項目的根目錄啟動 claude。

4. 日常使用

功能怎麼用
快速啟動Ctrl+Esc（Mac Cmd+Esc），或點 Claude Code 按鈕
在 IDE 裏看改動預設用 IDE 的 diff 查看器；想留在終端裏看，/config 裏把 Diff tool 改成 terminal
共享選區當前選中內容或標籤頁會自動發給 Claude，對話裏會顯示 ⧉ Selected N lines from <文件>
插入文件引用Alt+Ctrl+K（Mac Cmd+Option+K），插入類似 @src/auth.ts#L1-99 的引用
讀取 IDE 檢查結果讓 Claude「看一下這個文件的報錯」，它會調用 IDE 的診斷工具讀取錯誤和警告
切換權限模式和命令行一樣按 Shift+Tab，或啟動時加 --permission-mode

注意：Diff tool 選項只在 Claude Code 已經連上 IDE 時才會出現在 /config 裏。

5. 插件設定

位置：Settings → Tools → Claude Code [Beta]。

  • Claude command：自定義啟動命令，比如 claude、/usr/local/bin/claude。IDE 找不到 claude 時在這裏填完整路徑。
  • WSL 用戶：把 Claude command 設為 wsl -d Ubuntu -- bash -lic "claude"（把 Ubuntu 換成你的發行版名稱）。
  • Option+Enter 換行（僅 macOS）：開啟後可以用 Option+Enter 在提示詞裏換行，改完需重啟終端。
  • 自動更新：自動檢查並安裝插件更新，重啟後生效。

ESC 打斷不了 Claude？JetBrains 終端預設把 ESC 用來「把焦點切回編輯器」。到 Settings → Tools → Terminal，取消勾選「Move focus to the editor with Escape」，或者在「Configure terminal keybindings」裏刪掉「Switch focus to Editor」。

特殊環境

遠程開發（JetBrains Remote Development）

官方特別警告：插件要裝在遠程主機上（Settings → Plugin (Host)），而不是你本地的客戶端機器。

Windows + WSL2：提示「No available IDEs detected」

原因通常是 WSL2 的 NAT 網絡或 Windows 防火牆擋住了 WSL2 和 Windows 上 IDE 之間的連接（WSL1 不受影響）。兩種解決辦法：

辦法一（官方推薦）：給 WSL2 網段放行防火牆

  1. 在 WSL 裏運行 hostname -I，取 IP 的前兩段加 .0.0/16，比如 172.21.123.45 對應 172.21.0.0/16；
  2. 以管理員身份打開 PowerShell，按你的網段運行：
powershell
   New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16
  1. 重啟 IDE 和 Claude Code。

辦法二：把 WSL2 改成鏡像網絡（需要 Windows 11 22H2 及以上）

在 Windows 用戶目錄下的 .wslconfig 裏加入：

ini
[wsl2]
networkingMode=mirrored

然後在 PowerShell 裏運行 wsl --shutdown 重啟 WSL。

插件設定裏還有一個「Accept connections from all network interfaces」選項也能解決連接問題，但官方提醒它會讓 IDE 的連接端口暴露在局域網、且通信是明文的，只有其他辦法都不行時才開；WSL2 優先用鏡像網絡。

安全提醒

插件運行時會在本機起一個名為 ide 的內部 MCP 伺服器，用來打開 diff、讀取選區和診斷資訊；暴露給模型的只有一個只讀的「讀取診斷」工具，不提供代碼執行工具。

想讓 .env 之類的敏感文件即使被選中也不發給 Claude，加一條 Read deny 規則，例如在設定裏寫 "deny": ["Read(./.env)"]。規則寫法詳見本站《Claude Code 權限模式詳解：auto、手動、plan、bypass 與權限規則配置》。

常見問題

Q：裝了插件但沒有任何集成效果？

確認從項目根目錄啟動 Claude Code；在 IDE 設定裏檢查插件已啟用；徹底重啟 IDE（官方說可能需要重啟幾次）；遠程開發要確認插件裝在遠程主機上。

Q：點 Claude 圖標提示「command not found」？

先在終端運行 claude --version 確認命令行版已安裝；然後在插件設定的 Claude command 裏填完整路徑；WSL 用戶按上面的 WSL 命令格式填寫。

Q：/ide 顯示「No available IDEs detected」？

檢查插件已安裝並啟用、完整重啟 IDE；如果期望自動連接，確認是在 IDE 內置終端裏啟動的 claude；WSL 用戶見上文的防火牆 / 鏡像網絡設定。

Q：JetBrains 和 VS Code 的集成有什麼區別？

VS Code 擴展有獨立的圖形聊天面板並自帶內核；JetBrains 插件是「命令行 + IDE 集成」，介面就是終端裏的 Claude Code，靠插件把 diff、選區、診斷接進 IDE。VS Code 的用法詳見本站《Claude Code VS Code 插件使用教學：安裝、登入與常用操作》。

參考資料

  • JetBrains IDEs（官方）：https://code.claude.com/docs/en/jetbrains
  • Quickstart（官方）：https://code.claude.com/docs/en/quickstart
  • Choose a permission mode（官方）：https://code.claude.com/docs/en/permission-modes
  • Claude Code 插件頁（JetBrains Marketplace）：https://plugins.jetbrains.com/plugin/27310-claude-code-beta-
需要開通或續費？Claude Pro 充值 →

Nathaniel 的更多內容

  1. 01

    AI 學習路線：零基礎從哪開始，6 個階段、每階段該讀哪幾篇教學（2026）

    AI 學習路線怎麼走？給零基礎的人一條循序漸進的路徑：先選一個助手用順，再學提問，再用進日常工作，按需學做圖做影片，守住私隱與版權，最後進階自動化和編程。每個階段都配了本站對應的教學。

    其他 AI 工具0
  2. 02

    AI 瀏覽器有哪些：Perplexity Comet、Opera Neon、Dia、Brave Leo 與 Edge Copilot 的官方說法對照

    AI 瀏覽器有哪些？按官方頁面整理 Perplexity Comet、Opera Neon、Dia、Brave Leo 和 Edge 裏的 Copilot：官方自述的定位、支持的平台、免費還是訂閱，以及 Gemini、Claude 的 Chrome 方案和已停用的 ChatGPT Atlas。

    其他 AI 工具0
  3. 03

    即夢國際版 Dreamina 是什麼：官方站入口、能生成什麼、免費積分和模型（2026）

    即夢國際版 Dreamina 是什麼？官方站是 dreamina.capcut.com，是一個圖片、影片和數字人一體的 AI 創作平台。按官方首頁和 FAQ 講：能生成什麼、免費用戶每天 120 積分、列出的 Seedance 與 Seedream 模型，以及和國內即夢怎麼區分。

    其他 AI 工具0
  4. 04

    Kimi K3 Coding Plan 是什麼、怎麼用：Kimi Code 會員、模型 ID、套餐價格和額度規則

    Kimi K3 Coding Plan 是什麼？按 Kimi 官方文檔核對：官方現在叫 Kimi Code，是 Kimi 會員權益裏的編程服務，Plus 及以上才有；講 K3 等模型 ID、國內新套餐價格、三種客戶端、第三方工具接入和額度規則。

    Kimi0
  5. 05

    DeepSeek V4 Pro 和 Flash 的區別與 API 價格：官方價格頁逐項對照（高峰與空閒時段）

    DeepSeek V4 Pro 和 Flash 有什麼區別、API 怎麼收費？按 DeepSeek 官方價格頁（2026-10-19 查詢）列出兩個模型的版本、上下文、圖像理解、並發和每百萬 token 價格，說明高峰與空閒時段的計費差別和舊模型名怎麼處理。

    其他 AI 工具0
  6. 06

    GPT-6 Pro（Astra）怎麼用、哪些套餐有：怎麼選到 Pro 檔、用量限制和 Pro 三檔價格

    GPT-6 Pro（Astra）怎麼用、哪些套餐有？按 OpenAI 幫助中心核對：聊天裏 Pro 檔給 Pro 100、Pro 200、Business 和 Enterprise；Plus 在 Work 和 Codex 裏含 Astra。講怎麼選到、用量上限和官方 Pro 價格。

    ChatGPT0

同產品的其他教學

  1. 01

    Claude Pro 和 Max 的區別：用量、價格、Fable 模型和每月 API 額度怎麼選

    Claude Pro 和 Max 有什麼區別？按官方定價頁和幫助中心核對：Max 有 5x、20x 兩檔用量，Pro 與 Max 在價格、Fable 模型、每月 API 額度和計費週期上的差別，以及什麼情況下 Pro 夠用、什麼情況下該升 Max。

    Claude0
  2. 02

    Claude 登入不了、用不了、打不開怎麼辦：按官方幫助中心逐條排查

    Claude 無法登入、無法使用、無法打開怎麼辦？按官方幫助中心的順序排查：收不到登入電郵、登入報錯、Google 登入出問題、系統繁忙、額度用完、官方故障，以及所在地區是否在官方支持名單裏。

    Claude0
  3. 03

    Claude 怎麼註冊：官方註冊流程、手機驗證要求，以及提示無法註冊時官方怎麼說

    Claude 怎麼註冊？打開 claude.ai，用 Google 或電郵登入連結創建帳號，再用支持地區的手機號收短訊驗證碼。講清官方的註冊條件、手機驗證的限制，以及收不到驗證碼、號碼被用過多次時官方的處理辦法。

    Claude0
  4. 04

    Claude 怎麼用：新手入門，從打開聊天到寫出第一個好問題

    Claude 怎麼用？按官方幫助中心整理的新手路徑：在網頁、桌面版或手機 App 打開聊天，像對同事一樣寫需求，用輸入框的「+」和「/」找功能，點模型名換模型，免費版有每 5 小時重置的上限。

    Claude0
  5. 05

    Claude 怎麼設定成中文：介面語言、回答語言和語音語言分別怎麼設

    Claude 怎麼設定中文？官方幫助中心列出的 11 種介面語言裏目前沒有中文，但 Claude 會用你提問的語言回答，直接用中文問即可；想固定用中文，可在設定的 Instructions for Claude 裏寫一句。語音模式的語言要單獨選。

    Claude0
  6. 06

    MCP Inspector 怎麼用：安裝、啟動命令、調試 MCP 伺服器與 v2 的變化

    MCP Inspector 是什麼、怎麼安裝和使用？按 MCP 官方文檔講清網頁、命令行、終端介面三種模式的啟動命令，怎麼連本地和遠程伺服器、怎麼傳環境變量，密鑰存在哪，以及 v2 相比舊教學在端口、令牌變量名和 Node 版本上的變化。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～