用了一段時間 Claude Code，最大的問題是我一直沒離開過終端窗口。

寫著寫著要切回 IDEA 看報錯，看完再切回終端告訴 Claude，Claude 改完我再切回去確認——這個來回，每天少說要折騰幾十次，心態(tài)容易崩。

IntelliJ IDEA 2026.1 發(fā)布的時候我第一時間更新了，理由只有一個：它把 Claude Code 這件事給做進來了。

但接的方式有兩種，文檔說得輕描淡寫，實際配完你才知道差別很大。這篇我從底層講到實戰(zhàn)，14 張圖對應每一個關(guān)鍵步驟，順著走一遍就能搞定。

先搞清楚：IDEA 里的 Claude 不止一個

很多人沒想明白這件事就動手配了，結(jié)果搞混，這里先厘清。

IDEA 2026.1 里實際上可以同時存在三種 Claude 入口：

① JetBrains 內(nèi)置 Claude Agent——JetBrains 自己買的調(diào)用權(quán)，走 JetBrains AI 訂閱配額，跟你的 Claude 賬號沒有任何關(guān)系。

② Claude Code 官方插件——Anthropic 在 JetBrains Marketplace 發(fā)的官方插件，走你的 Claude 賬號，在 IDEA 內(nèi)置終端里運行，插件負責橋接終端和編輯器。

③ Claude Code via ACP——通過 ACP 協(xié)議接入，不需要開終端，在 AI Chat 面板里直接對話，支持完整 MCP 工具鏈。

三者并不互斥，我現(xiàn)在同時用②和③，按任務類型切換。

方式一：官方插件，5 分鐘裝好

第一步：安裝 Claude Code CLI

打開終端，執(zhí)行：

npm install -g @anthropic-ai/claude-code

裝完驗證：

claude --version

第二步：安裝 IDEA 插件

進入 Settings → Plugins → Marketplace，搜索：

Claude Code

找到 **Claude Code [Beta]**（開發(fā)者顯示為 Anthropic），點 Install，重啟 IDEA。

第三步：在 IDEA 內(nèi)置終端啟動

點底部工具欄的 Terminal，在 IDEA 自己的終端里運行：

claude

首次運行會彈瀏覽器引導你授權(quán) Claude 賬號，完成后回到 IDEA，插件全部功能激活。

注意一定要在 IDEA 的內(nèi)置終端里啟動，在外部終端啟動插件檢測不到，功能不會激活。

插件給你帶來什么

除了快捷鍵，插件還有兩個被動能力：當前選中代碼和當前 Tab 自動同步給 Claude；編輯器里的 lint 錯誤、語法錯誤實時傳遞給 Claude，你不需要手動復制粘貼報錯。

Claude 改完的代碼不在終端里展示，而是在 IDEA 自己的 Diff Viewer 里——左邊原來的，右邊改后的，Accept / Reject 都在這里操作。

方式二：ACP 接入，才是真正的王炸

官方插件已經(jīng)好用，為什么還要講 ACP？

一句話：官方插件本質(zhì)上是在 IDEA 里嵌了一個終端會話，而 ACP 讓 Claude Code 成為 IDEA 原生的 AI Agent，兩者的集成深度完全不是一個量級。

最核心的差異在 MCP 工具鏈——ACP 方式接入后，你在 ~/.claude.json 里配過的所有 MCP Server，在 IDEA 的 AI Chat 面板里全部可用。連數(shù)據(jù)庫、訪問文件系統(tǒng)、調(diào)外部 API，Claude 在 Chat 面板里直接能做到。

ACP 是什么

ACP（Agent Client Protocol），由 Zed Industries 主導、JetBrains 和 Anthropic 共同參與制定的開放協(xié)議。目標是讓任何 AI Agent 都能接入任何編輯器，不用各自單獨造適配器。

類比一下：LSP 統(tǒng)一了語言服務（寫了一個 Java Language Server，VS Code、IDEA、Vim 都能用），ACP 做的是同一件事，只不過統(tǒng)一的是 AI Agent 的接入方式。

底層走 JSON-RPC 2.0，Agent 作為獨立進程運行，IDEA 通過 stdin/stdout 和它通信。Agent 是獨立進程不是插件，這意味著 Claude Code 的版本升級完全不依賴 IDEA 插件的更新節(jié)奏，兩邊解耦。

第一步：安裝 ACP 適配器

Zed 官方提供了一個橋接包，把 Claude Code 包成符合 ACP 協(xié)議的 Server：

# npm
npm install -g @zed-industries/claude-code-acp
# pnpm（推薦）
pnpm add -g @zed-industries/claude-code-acp

裝完確認可執(zhí)行文件路徑（后面配置要用）：

# npm
npm bin -g
# pnpm
pnpm bin -g

第二步：打開 acp.json 配置入口

在 IDEA 里：打開 AI Chat 面板 → 右上角三點菜單 → 「配置 ACP 智能體」。

IDEA 會自動打開或創(chuàng)建 ~/.jetbrains/acp.json。

第三步：填寫 acp.json

把文件內(nèi)容替換成：

{
  "default_mcp_settings": {},
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": {
        "ACP_PERMISSION_MODE": "bypassPermissions"
      },
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}

command按系統(tǒng)和包管理器調(diào)整：

# Mac + npm
"command": "npx"
# Mac + pnpm（推薦寫絕對路徑，穩(wěn)定）
"command": "/Users/你的用戶名/Library/pnpm/claude-code-acp"
# Windows（必須用 npx.cmd，不是 npx）
"command": "npx.cmd"

Windows 這里是一個高頻踩坑點：用 npx 會報 IOException: Cannot run program "npx"，必須改成 npx.cmd。

第四步：選擇 Claude Code

保存 acp.json 后，回到 AI Chat 面板，點模型/Agent 下拉框，Claude Code 會出現(xiàn)在列表里，選中即可開始對話。

重點：兩個參數(shù)，很多人沒搞懂

use_custom_mcp——把你已有的 MCP 工具全帶進來

這個參數(shù)設為 true 后，Claude Code 會讀取你 ~/.claude.json 里已配置的所有 MCP Server，在 IDEA 的 AI Chat 里全部可用。

比如你之前給 Claude Code 配了數(shù)據(jù)庫和文件系統(tǒng)的 MCP：

// ~/.claude.json（你之前配好的，無需改動）
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRESQL_CONNECTION_STRING": "postgresql://localhost/mydb"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/你的項目目錄"]
    }
  }
}

開了 use_custom_mcp: true，這些工具在 IDEA 的 AI Chat 里全部激活，你可以直接用自然語言操作數(shù)據(jù)庫、讀寫文件，不用切任何工具。

use_idea_mcp——有一個副作用要知道

這個參數(shù)開啟后，IDEA 會把自己的 MCP Server 暴露給 Claude Code，Claude 因此能調(diào)用 IDEA 的內(nèi)部能力：查看運行時變量、分析調(diào)用棧、執(zhí)行調(diào)試命令等等。

聽起來很強，但有一個副作用：IDEA 的 MCP 配置會被寫入你的 ~/.claude.json，而這是全局配置。

后果是：你在其他地方用 Claude Code（比如終端直接跑 claude，或者在 VS Code 里）時，IDEA 的 MCP 工具描述也會被加載進上下文——足足 10.7K Token 的 IDEA 內(nèi)部工具，對那些場景完全是噪音，白白占用上下文窗口。

我的建議：

• 只用 IDEA 一個編輯器 → use_idea_mcp: true，享受完整能力
• 多編輯器混用 → use_idea_mcp: false，避免全局污染

// 多編輯器用戶推薦配置
{
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": { "ACP_PERMISSION_MODE": "bypassPermissions" },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    }
  }
}

進階：同時接入多個 Agent，隨時切換

agent_servers 支持配多個，Claude Code 和 Codex 可以同時在列：

{
  "agent_servers": {
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp"],
      "env": { "ACP_PERMISSION_MODE": "bypassPermissions" },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    },
    "Codex": {
      "command": "npx.cmd",
      "args": ["@zed-industries/codex-acp"],
      "env": { "OPENAI_API_KEY": "你的Key" }
    }
  }
}

進階：Claude 直連數(shù)據(jù)庫，不開任何工具

IDEA 2026.1 新增了數(shù)據(jù)庫直連能力——如果你在 IDEA Database 面板里配過數(shù)據(jù)庫連接，開啟 use_idea_mcp 后，Claude 可以直接在 AI Chat 里查詢，不用再單獨配數(shù)據(jù)庫 MCP。

實際對話是這樣的：

我：幫我看一下 orders 表里狀態(tài)是 PENDING 且創(chuàng)建超過 24 小時的記錄有多少條

Claude：我來查詢一下……SELECT COUNT(*) FROM orders WHERE status = 'PENDING' AND created_at < NOW() - INTERVAL '24 hours'

查詢結(jié)果：共 1,247 條

不切工具，不手寫 SQL，不開數(shù)據(jù)庫客戶端。

我目前的完整配置

直接貼，可以抄：

{
  "default_mcp_settings": {},
  "agent_servers": {
    "Claude Code": {
      "command": "/Users/xxx/Library/pnpm/claude-code-acp",
      "env": {
        "ACP_PERMISSION_MODE": "bypassPermissions"
      },
      "use_idea_mcp": false,
      "use_custom_mcp": true
    }
  }
}

用的是 pnpm 安裝后的絕對路徑（比 npx 啟動更快，沒有解析延遲），關(guān)掉了 use_idea_mcp（因為同時用 VS Code，不想污染全局配置），保留了 use_custom_mcp（~/.claude.json 里配了 filesystem 和 postgres 兩個 MCP Server）。

常見問題

Q：Mac 上不需要單獨裝 ACP 適配器包？對，macOS 上 Claude Code 可以直接通過內(nèi)置 Claude Agent 使用，不需要額外安裝 ACP 包。但如果你想用 ACP 方式接入 AI Chat 面板，還是需要裝適配器。

Q：Windows 上 npx 報錯怎么辦？把 command 改成 "npx.cmd"，Windows 上 IDEA 無法識別不帶擴展名的 npx。

Q：ACP 和官方插件能同時用嗎？可以，兩個完全獨立，互不影響。我自己就是同時裝的，小任務用官方插件快捷鍵，復雜任務開 ACP 的 AI Chat。

Q：devcontainer 里能用嗎？目前有已知 Bug，2026.1 的新 devcontainer 架構(gòu)不在容器內(nèi)運行 JetBrains 后端進程，Diff 查看等功能失效。本地項目正常使用不受影響。

工具配好了，王炸不王炸，用一周你自己就有答案。

到此這篇關(guān)于IDEA 2026.1 + Claude Code 使用全解析的文章就介紹到這了,更多相關(guān)IDEA Claude Code使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論