在 JetBrains 中使用 Claude Code:CLI、外掛與設定
在 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm 或 Android Studio 裡,用一把 AI in IDE API Key 使用 Claude Code。
JetBrains 沒有內建聊天的擴充功能。外掛會在 IDE 終端機啟動 claude CLI,再透過本機 socket 連線,所以要裝 CLI、裝外掛,再設定 CLI 環境。完整參考請看在 JetBrains 中使用 Claude Code。
快速設定
- 安裝 CLI。 透過 npm 安裝需要 Node.js 22 以上;原生 CLI 不需要 Node.js。
1 npm install -g @anthropic-ai/claude-code2 claude --version
先在一般終端機確認 claude 能解析得到。若不行,外掛就無法啟動它。
- 安裝外掛。 打開 Settings → Plugins → Marketplace,搜尋 Claude Code,安裝後完整重啟 IDE。使用 Remote Development 時,透過 Settings → Plugin (Host) 裝在遠端主機上。
- 讓外掛找到 CLI。 Settings → Tools → Claude Code [Beta] → Claude command 接受指令字串:PATH 上的
claude、/usr/local/bin/claude之類的絕對路徑、npx @anthropic-ai/claude-code,或 WSL 指令如wsl -d Ubuntu -- bash -lic "claude"。 - 寫入連線設定。 CLI 會讀取
~/.claude/settings.json(macOS/Linux)或C:/Users/<UserName>/.claude/settings.json(Windows):
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
ANTHROPIC_BASE_URL 只填主機位址;CLI 會加上 /v1/messages。有 ANTHROPIC_AUTH_TOKEN 就足以跳過首次登入提示。
- 驗證。 在 IDE 整合終端機執行
claude,應該不會出現登入畫面。接著執行/status,或按Cmd+Esc/Ctrl+Esc讓外掛連線。若終端機是在 IDE 外啟動,執行/ide,看到Connected to IntelliJ IDEA.(含你的 IDE 名稱)即成功。
JetBrains 整合的差異
| VS Code / Cursor | JetBrains | |
|---|---|---|
| 要裝什麼 | 一個內建 CLI 的擴充功能 | CLI 加上外掛 |
| 聊天介面在哪 | 編輯器內的原生面板 | IDE 終端機,差異對照顯示在 IDE 中 |
| 怎麼找到 Claude | 內建執行檔 | PATH 上的 claude,或在設定裡指定路徑 |
| 怎麼連線 | 擴充功能行程 | 外掛啟動本機 MCP 伺服器,CLI 用 ws:// 連到隨機的 loopback 埠 |
因為實際對外發請求的是 CLI,AI in IDE 的設定屬於 CLI,不在外掛的圖形介面裡。一份 ~/.claude/settings.json 就能設定 CLI、外掛與終端機工作階段。
支援模型
| 模型 | 渠道 | 適合 |
|---|---|---|
claude-opus-5-5(別名 claude-opus-5.5) | AWSQ、CCMAX | 多檔案重構、長時間自動任務 |
claude-sonnet-5-5(別名 claude-sonnet-5.5) | AWSQ、CCMAX | 日常工作的預設 |
claude-haiku-4-5-20251001 | AWSQ、CCMAX | 快速、便宜的修改與檢查 |
請使用 GET /v1/models 的完整 ID;拼錯的 claude-* 名稱可能被解析成預設 Claude 模型,並依該模型費率計費。方案與目前費率請看定價。
疑難排解重點
Cannot launch Claude Code—claude不在 IDE 的 PATH。把 Claude command 設成絕對路徑或npx @anthropic-ai/claude-code。No available IDEs detected— 外掛被停用、IDE 沒有完整重啟,或 CLI 在其他使用者工作階段。WSL2 下請放行 WSL 子網,或改用networkingMode=mirrored。- 沒有差異對照 — 連上 IDE 時用
/config把 Diff tool 設成auto。 Esc無法中斷 Claude — 在 Settings → Tools → Terminal 取消勾選 Move focus to the editor with Escape。- Remote Development 功能缺失 — 外掛裝在本機客戶端,而不是主機。
常見問題
為什麼沒有真正的一鍵安裝?
外掛刻意不內建 CLI。它啟動你安裝的 claude,讓終端機與 IDE 共用同一份設定,因此必須先裝 CLI、再裝外掛。
可以沿用 VS Code 的擴充功能嗎?
不行。VS Code 與 Cursor 的擴充功能是另一個產品。可以沿用的是 ~/.claude/settings.json,兩邊都會讀取。
外掛需要 Anthropic 登入嗎?
不需要。設定 ANTHROPIC_AUTH_TOKEN 與 ANTHROPIC_BASE_URL 後,CLI 會跳過登入提示,把請求送到 AI in IDE。
支援哪些 IDE?
官方列出 IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand 與 Android Studio。同平台的其他產品通常也能用,但外掛仍是 beta,請先確認差異對照與 /ide 再依賴它。