在 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。

快速設定

  1. 安裝 CLI。 透過 npm 安裝需要 Node.js 22 以上;原生 CLI 不需要 Node.js。
1
npm install -g @anthropic-ai/claude-code
2
claude --version

先在一般終端機確認 claude 能解析得到。若不行,外掛就無法啟動它。

  1. 安裝外掛。 打開 Settings → Plugins → Marketplace,搜尋 Claude Code,安裝後完整重啟 IDE。使用 Remote Development 時,透過 Settings → Plugin (Host) 裝在遠端主機上。
  2. 讓外掛找到 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"。
  3. 寫入連線設定。 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 就足以跳過首次登入提示。

  1. 驗證。 在 IDE 整合終端機執行 claude,應該不會出現登入畫面。接著執行 /status,或按 Cmd+Esc / Ctrl+Esc 讓外掛連線。若終端機是在 IDE 外啟動,執行 /ide,看到 Connected to IntelliJ IDEA.(含你的 IDE 名稱)即成功。

JetBrains 整合的差異

VS Code / CursorJetBrains
要裝什麼一個內建 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-20251001AWSQ、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 再依賴它。

相關頁面

在 JetBrains 中使用 Claude Code:CLI、外掛與設定|AI in IDE