Browse documentation

Getting Started

Ide

在 JetBrains 系列 IDE 中使用 Claude Code

在 JetBrains 系列 IDE 裡使用 Claude Code，只需要一把 AI in IDE 的 API Key。支援 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm 與 Android Studio。

這套整合與 VS Code、Cursor 完全不同：JetBrains 沒有自帶聊天功能的擴充外掛，外掛是在 IDE 的整合終端機裡啟動 claude 指令，再透過本機通訊埠連上。所以要裝一個 CLI、裝一個外掛，再設定 CLI 的環境。這裡沒有真正的「一鍵安裝」，任何保證一鍵完成的教學都是錯的。

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、外掛與終端機工作階段。

版本與前置條件

元件	需求
JetBrains IDE	IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand、Android Studio 目前任一版本
Node.js	透過 npm 安裝時需要 22 以上版本。原生 CLI 執行時不需要 Node.js。
Claude Code CLI	目前版本，需全域安裝
Claude Code 外掛	JetBrains Marketplace，Beta 頻道
AI in IDE 金鑰	AWSQ 或 CCMAX 渠道，從 API Keys 取得
Anthropic 帳號	設定好 API Key 與 Base URL 後不需要

外掛以 Claude Code [Beta] 名稱發佈。功能與設定選單會隨版本變動，請以你安裝的那個版本的頁面為準，不要假設某個選項一定存在。

安裝

1. 安裝 CLI

1 npm install -g @anthropic-ai/claude-code
2 claude --version

先在一般終端機確認 claude 能解析得到。若不行，外掛就無法啟動它，會顯示 Cannot launch Claude Code。Node 版本管理器（nvm、fnm、asdf）是常見原因：claude 靠 shell 的初始化腳本才進到 PATH，而 IDE 不會執行那段腳本。改用系統層級的 Node 安裝，或在下一個步驟直接寫絕對路徑。

2. 安裝外掛

打開 Settings → Plugins → Marketplace，搜尋 Claude Code，安裝後完整重啟 IDE，不是只重開專案。使用 Remote Development 時，外掛必須透過 Settings → Plugin (Host) 裝在遠端主機上，不能只裝在本機客戶端；只裝本機的話連不上遠端專案。

3. 讓外掛找到 CLI

Settings → Tools → Claude Code [Beta] → Claude command 接受的是一段指令字串，不只是路徑：

claude，當它在 PATH 上
/usr/local/bin/claude 之類的絕對路徑
npx @anthropic-ai/claude-code，永遠執行最新發佈版
Windows 搭配 WSL 時用 wsl -d Ubuntu -- bash -lic "claude"，把 Ubuntu 換成你的發行版名稱

出現 command not found 通知時，改這個設定最有效。

建立並複製 API Key

在定價頁面選擇方案。一個帳戶可分別建立 Claude、GPT 與 Gemini 專用金鑰，每把金鑰依所選渠道使用對應模型。
打開 API Keys 建立金鑰。
渠道選 AWSQ 或 CCMAX。這是 Claude Code 渠道；Codex 與 Gemini 金鑰走不同端點，在這裡會失敗。
之後仍可回到 API Keys 清單，顯示或複製完整金鑰。

設定

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。寫成帶 /v1 會變成 /v1/v1/messages 並回 404。若你已經有含權限規則或 hooks 的 settings.json，請新增 env 物件，不要覆蓋整份檔案。

為什麼用檔案而不是 shell 匯出值？因為從 Dock 或開始功能表啟動的 JetBrains IDE 不會執行你的 shell 設定檔，外掛繼承的是 IDE 的環境。設定檔由 CLI 自己讀取，無論終端機怎麼啟動都有效。若你仍偏好環境變數，請同時確保 IDE 是從 shell 啟動的，或在 Claude command 裡帶上變數。

CLI 首次啟動的登入提示也不需要理會：只要 ANTHROPIC_AUTH_TOKEN 存在且沒有 claude.ai 工作階段，Claude Code 就會直接用這個 Token。

驗證

先列出模型，驗證金鑰及 Claude 渠道。這個請求不消耗額度。

1 curl --globoff -i 'https://api.aiinide.com/v1/models' \
2   -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3   -H "anthropic-version: 2023-06-01"

HTTP 200 會傳回模型清單。401 表示缺少金鑰、金鑰無效或已過期，400 表示金鑰渠道不符。下方 Messages 範例請填入清單中的模型 ID。

先驗終端機。在專案根目錄打開 IDE 的整合終端機執行 claude，應該直接出現提示字元，不該有登入畫面。這一步失敗，外掛也不可能成功；先把 CLI 與環境修好。
從 IDE 連線。專案開著時，從 IDE 終端機執行 claude，或按 Cmd+Esc / Ctrl+Esc，外掛會啟動 CLI 並建立連線。
確認連線。執行 /status，會顯示版本、模型與帳號狀態。連線正常時，檔案修改會以 IDE 的差異檢視呈現，而不是在終端機裡。
從外部終端機連線。若 claude 是在 IDE 外啟動的，在 Claude Code 裡輸入 /ide。成功時會顯示 Connected to IntelliJ IDEA.（換成你的 IDE 名稱）。請從專案根目錄啟動，否則檔案集合對不上。
使用已驗證的金鑰直接測試模型呼叫。

1 curl --globoff 'https://api.aiinide.com/v1/messages' \
2   -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3   -H "anthropic-version: 2023-06-01" \
4   -H "Content-Type: application/json" \
5   -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

用量。第一次成功提問後，用量頁面會顯示這把金鑰的 Token 消耗。

疑難排解

請使用 GET /v1/models 傳回的完整 ID。若拼錯 claude-* 名稱，代理可能改用已設定的預設 Claude 模型，並按該模型的費率扣款。

`API Error: 404`

將 ANTHROPIC_BASE_URL 設為 https://api.aiinide.com。多加 /v1 會讓請求送到 /v1/v1/messages，回傳 404。

`API Error: 400`

渠道錯誤：Codex 或 Gemini 金鑰驗證的是 /responses 或 /v1beta/models/...，打到這個端點會回 400。請建立 AWSQ 或 CCMAX 金鑰。
settings.json 壞掉：JSON 無法解析時 CLI 會默默退回預設，請求就帶著你的代理 Token 打到真正的 Anthropic 端點而失敗。請驗證檔案內容，有 $schema 那行時 IDE 會即時標錯。

金鑰驗證

請依 GET /v1/models 的狀態碼排查金鑰。原生 POST /v1/messages 在金鑰缺失或無效時，也可能回傳 HTTP 200，並將驗證錯誤寫在 content 裡。

設定放錯位置：Remote Development 或容器環境中，~/.claude/settings.json 必須存在於執行 CLI 的主機或容器上，不是你的筆記型電腦。
殘留的 ANTHROPIC_API_KEY：環境裡若同時有 Anthropic 金鑰，它可能優先於 ANTHROPIC_AUTH_TOKEN。取消該變數並重啟 IDE。
金鑰過期：到控制台確認到期時間，直接輪替而不是延長。

JetBrains 特有的整合問題

現象	原因	處理方式
`Cannot launch Claude Code`	`claude` 不在 IDE 的 `PATH` 上	把 Claude command 設成絕對路徑或 `npx @anthropic-ai/claude-code`
`/ide` 顯示 `No available IDEs detected`	外掛被停用、IDE 沒完整重啟，或 CLI 在使用者不同的工作階段啟動	啟用外掛、完整重啟 IDE，並從 IDE 終端機啟動 `claude`
WSL2 上出現 `No available IDEs detected`	NAT 網路或 Windows 防火牆阻擋 WSL 與 IDE 之間的 loopback	讓 WSL 子網路通過防火牆，或在 `.wslconfig` 改成 `networkingMode=mirrored`
外掛裝了但沒有差異檢視	`Diff tool` 設成 `terminal`	執行 `/config`，把 Diff tool 設為 `auto`；此選項只在連上 IDE 時出現
`Esc` 無法中斷 Claude	按鍵被 IDE 攔走	Settings → Tools → Terminal，取消勾選 Move focus to the editor with Escape
Remote Development 專案中功能缺失	外掛裝在客戶端	改用 Settings → Plugin (Host) 安裝
差異檢視開在新視窗而非專案中	專案根目錄不一致	從專案根目錄啟動 `claude`

逾時與代理

API_TIMEOUT_MS 對長時間的代理執行很重要；公司代理會讓每次請求都多一段延遲。若請求總在固定時間失敗，代表逾時值沒被讀到，請確認它寫在 settings.json 的 env 內並重啟 IDE。代理會做 TLS 解密時，在同一段 env 裡把 NODE_EXTRA_CA_CERTS 指向代理根憑證。

關於權限模式的提醒

在 JetBrains 裡，外掛有機會修改 IDE 可能會自動執行的設定檔。處理不受信任的儲存庫時，請維持 Manual 模式、關閉 acceptEdits，並留意你在這個可寫入的工作階段裡開了哪些專案目錄。

模型與價格

模型	渠道	用途
`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	快速、便宜的修改與檢查

Opus 5.5 基礎價：每 100 萬 Token 輸入 $4、快取讀取 $0.20、輸出 $20。額度消耗 AWSQ 為 0.8 倍、CCMAX 為 2 倍。上游若以 Fast 模式處理，基礎與快取費率加倍。

方案：定價
金鑰與額度：API Keys
協議細節：設定說明
官方外掛頁面：JetBrains Marketplace
官方整合說明：code.claude.com JetBrains

常見問題

為什麼沒有真正的一鍵安裝？ 因為外掛刻意不內建 CLI，而是啟動你已安裝的 claude，讓終端機與 IDE 共用同一份設定。所以必須先裝 CLI，再裝外掛，順序不能顛倒。

可以沿用 VS Code 的擴充功能嗎？ 不行。VS Code / Cursor 的擴充功能是另一個產品，這裡的介面是 IDE 終端機裡的 CLI。可以共用的是 ~/.claude/settings.json，兩者都讀它。

外掛需要 Anthropic 登入嗎？ 不需要。設定好 ANTHROPIC_AUTH_TOKEN 與 ANTHROPIC_BASE_URL 後，CLI 會跳過登入提示，請求直接送到 AI in IDE。

支援哪些 IDE？ 官方列出 IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand 與 Android Studio。同平台的其他 IDE 通常也能用；外掛仍在 Beta，實際依賴前請先驗證差異檢視與 /ide。

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	`}`

1	`curl --globoff 'https://api.aiinide.com/v1/messages' \`
2	`-H "x-api-key: YOUR_DASHBOARD_API_KEY" \`
3	`-H "anthropic-version: 2023-06-01" \`
4	`-H "Content-Type: application/json" \`
5	`-d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'`

1	`npm install -g @anthropic-ai/claude-code`
2	`claude --version`

1	`curl --globoff -i 'https://api.aiinide.com/v1/models' \`
2	`-H "x-api-key: YOUR_DASHBOARD_API_KEY" \`
3	`-H "anthropic-version: 2023-06-01"`