IntelliJ IDEA 接入多种AI大模型插件全面指南（2026.1 版本）

---

--

🚀 IntelliJ IDEA 接入多种AI大模型插件全面指南（2026.1 版本）

---

摘要

IntelliJ IDEA 2026.1版本全面支持多种AI大模型接入，提供ACP协议、MCP服务器和插件三种集成方式。本文详细介绍了Codex、Claude Code、Cursor、GitHub Copilot及本地大模型的配置方法，包含环境准备、核心概念解析和具体实现步骤。重点讲解了ACP协议作为官方推荐的标准接入方式，以及MCP服务器实现外部工具访问IDE功能的机制。文章还提供了系统要求、前置软件安装指南、配置文件示例和常见问题解决方案，帮助开发者高效集成AI辅助编程功能。

---

📋 目录

1. 摘要与概述
2. 环境准备
3. 核心概念解析
4. 主流AI模型接入配置
   • 4.1 Codex 接入
   • 4.2 Claude Code 接入
   • 4.3 Cursor 接入
   • 4.4 GitHub Copilot 接入
   • 4.5 本地大模型接入（Ollama）
5. ACP协议详细配置
6. MCP服务器配置与使用
7. 常见陷阱与问题解决
8. 高级功能与最佳实践
9. 参考资料
10. 总结
11. 附录

---

一、摘要与概述

1.1 版本信息

当前版本：IntelliJ IDEA 2026.1（发布日期：2026年3月26日）

核心更新：

• ✅ ACP（Agent Client Protocol）协议：统一的AI智能体接入标准
• ✅ AI Assistant 插件：内置支持多种AI模型
• ✅ MCP（Model Context Protocol）服务器：允许外部工具访问IDE功能
• ✅ ACP注册表：一键安装和管理AI智能体
• ✅ Git工作树支持：并行处理多个分支

1.2 支持的AI模型

模型名称	类型	接入方式	难度
Codex	OpenAI	ACP协议	⭐⭐
Claude Code	Anthropic	ACP协议	⭐⭐
Cursor	独立工具	MCP服务器	⭐⭐⭐
GitHub Copilot	GitHub	插件	⭐
本地大模型	本地部署	ACP协议	⭐⭐⭐⭐

1.3 接入方式对比

方式	适用场景	优点	缺点
ACP协议	推荐	官方支持、配置简单、功能完整	需要IDEA 2026.1+
MCP服务器	远程协作	外部工具可访问IDE	配置相对复杂
插件方式	特定模型	功能专一、集成度高	模型选择有限
ACP注册表	快速安装	一键安装、预配置	需要网络连接

---

二、环境准备

2.1 系统要求

# IntelliJ IDEA 版本
IDEA 2026.1 或更高版本（推荐 2026.1.1+）

# 操作系统
Windows 10/11
macOS 10.15+
Linux (Ubuntu 20.04+, CentOS 7+)

# 硬件要求
CPU: 4核以上
内存: 8GB 以上（推荐 16GB）
磁盘: SSD 50GB 以上可用空间

# 网络
稳定的互联网连接（部分模型需要）

2.2 前置软件安装

安装 Node.js（部分ACP服务需要）

# Windows
winget install OpenJS.NodeJS.LTS
# 或从官网下载：https://nodejs.org/

# macOS
brew install node

# Linux (Ubuntu)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version  # 应该 >= 18.0.0
npm --version   # 应该 >= 9.0.0

安装 Python 和 uv（某些本地模型需要）

# 安装 Python 3.10+
# Windows: 从官网下载安装
# macOS: brew install python@3.10
# Linux: sudo apt-get install python3.10

# 安装 uv（Python 包管理器）
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# 验证
uv --version

2.3 检查插件状态

# 确保以下插件已启用
1. AI Assistant (JetBrains AI Assistant)
2. MCP Server
3. Code With Me AI (可选)

# 检查方法
Settings → Plugins → Installed
搜索上述插件，确认状态为 "Enabled"

---

三、核心概念解析

3.1 ACP (Agent Client Protocol)

定义：JetBrains定义的AI智能体通信协议，类比于API领域的OpenAPI规范

核心特性：

• 标准化的接口契约
• 任何遵循该协议的AI Agent都能无缝接入IDEA
• 支持HTTP和WebSocket通信
• 统一的认证和授权机制

架构：

┌─────────────────┐
│   IntelliJ IDEA │
│   AI Assistant  │
└────────┬────────┘
         │
         │ ACP Protocol
         │ (HTTP/WebSocket)
         ▼
┌─────────────────┐
│  ACP Agent      │
│  (Codex/Claude/ │
│   Local Model)  │
└─────────────────┘

3.2 MCP (Model Context Protocol)

定义：允许外部AI工具访问IDE上下文的协议

核心特性：

• 外部工具可以访问IDE的文件系统、Git、调试器等功能
• 支持Token认证
• 可配置访问权限

架构：

┌─────────────────┐          ┌─────────────────┐
│   External AI   │          │  IntelliJ IDEA  │
│   Tool (Cursor) │◄────────►│  MCP Server     │
│                 │  MCP     │                 │
└─────────────────┘  Protocol└─────────────────┘
                                    │
                                    ▼
                            ┌─────────────────┐
                            │   Project       │
                            │   Context       │
                            └─────────────────┘

3.3 ACP注册表

定义：官方和社区提供的预配置Agent列表

功能：

• 一键浏览和安装AI智能体
• 预配置的Agent配置
• 社区贡献的Agent

---

四、主流AI模型接入配置

4.1 Codex 接入

方式一：通过ACP注册表（最简单）

# 步骤 1：打开 ACP 注册表
AI Chat 窗口 → 点击 "+" → Browse ACP Registry

# 步骤 2：搜索并安装
搜索 "Codex"
选择 "OpenAI Codex"
点击 "Install"

# 步骤 3：配置 API Key
安装完成后会自动跳转到配置页面
填写 OpenAI API Key
选择模型：gpt-4 或 gpt-3.5-turbo

# 步骤 4：测试连接
点击 "Test Connection"

配置文件示例

// ~/.idea/ai-assistant-agents.json
{
  "version": "1.0",
  "agents": [
    {
      "id": "codex",
      "name": "OpenAI Codex",
      "type": "custom_acp",
      "enabled": true,
      "default": true,
      "config": {
        "host": "api.openai.com",
        "port": 443,
        "protocol": "https",
        "path": "/v1/chat/completions",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
        },
        "parameters": {
          "model": "gpt-4",
          "temperature": 0.7,
          "max_tokens": 4096,
          "top_p": 0.9,
          "stream": true
        }
      },
      "capabilities": {
        "code_generation": true,
        "code_explanation": true,
        "code_refactoring": true,
        "debug_assistance": true,
        "documentation": true
      }
    }
  ]
}

4.2 Claude Code 接入

配置步骤

# 步骤 1：安装 claude-code-acp 插件
npm install -g @zed-industries/claude-code-acp

# 步骤 2：启动服务
claude-code-acp serve --port 5001

# 步骤 3：IDEA 中配置
Settings → Tools → AI Assistant → Agents
Add Custom ACP Agent
- Name: Claude Code
- Host: localhost
- Port: 5001
- Protocol: http

# 步骤 4：配置 API Key
在 claude-code-acp 服务中配置 Anthropic API Key

配置文件示例

{
  "agents": [
    {
      "id": "claude-code",
      "name": "Claude Code",
      "type": "custom_acp",
      "config": {
        "host": "api.anthropic.com",
        "port": 443,
        "protocol": "https",
        "path": "/v1/messages",
        "headers": {
          "x-api-key": "YOUR_ANTHROPIC_API_KEY",
          "anthropic-version": "2023-06-01",
          "content-type": "application/json"
        },
        "parameters": {
          "model": "claude-3-opus-20240229",
          "max_tokens": 4096,
          "temperature": 0.7
        }
      }
    }
  ]
}

4.3 Cursor 接入

通过MCP服务器接入

# 步骤 1：启用 MCP 服务器
Settings → Plugins → 搜索 "MCP Server" → Enable

# 步骤 2：配置 MCP 服务器
Settings → Tools → MCP Server
- Enable MCP Server: ✅
- Port: 3000
- Token: 生成或设置自定义Token

# 步骤 3：在 Cursor 中配置
1. 打开 Cursor
2. Settings → MCP Servers
3. Add Server
   - Name: IntelliJ IDEA
   - Host: localhost
   - Port: 3000
   - Token: 复制IDEA中的Token
4. Save

# 步骤 4：测试
在 Cursor 中使用 IDEA 的上下文功能

4.4 GitHub Copilot 接入

通过官方插件

# 步骤 1：安装插件
Settings → Plugins → Marketplace
搜索 "GitHub Copilot"
点击 Install → 重启IDEA

# 步骤 2：登录 GitHub
1. 点击右下角 Copilot 状态图标
2. 点击 "Sign in to GitHub"
3. 在浏览器中完成授权

# 步骤 3：配置（可选）
Settings → Tools → GitHub Copilot
- Enable: ✅
- Inline Suggestions: ✅
- Tab Completion: ✅

4.5 本地大模型接入（Ollama）

配置步骤

# 步骤 1：安装 Ollama
# Windows: 下载安装包
# macOS: brew install ollama
# Linux: curl -fsSL https://ollama.com/install.sh | sh

# 步骤 2：下载模型
ollama pull codellama
ollama pull llama2
ollama pull mistral

# 步骤 3：启动 Ollama 服务
ollama serve  # 默认监听 11434 端口

# 步骤 4：IDEA 中配置
Settings → Tools → AI Assistant → Agents
Add Custom ACP Agent

# 配置参数
Name: Local Llama
Host: localhost
Port: 11434
Protocol: http
Path: /api/chat

# Parameters
model: codellama
temperature: 0.7

配置文件示例

{
  "agents": [
    {
      "id": "local-llama",
      "name": "Local Llama (Ollama)",
      "type": "custom_acp",
      "config": {
        "host": "localhost",
        "port": 11434,
        "protocol": "http",
        "path": "/api/chat",
        "parameters": {
          "model": "codellama",
          "temperature": 0.7,
          "max_tokens": 2048,
          "stream": true
        }
      }
    },
    {
      "id": "local-mistral",
      "name": "Local Mistral (Ollama)",
      "type": "custom_acp",
      "config": {
        "host": "localhost",
        "port": 11434,
        "protocol": "http",
        "path": "/api/chat",
        "parameters": {
          "model": "mistral",
          "temperature": 0.8,
          "max_tokens": 2048
        }
      }
    }
  ]
}

---

五、ACP协议详细配置

5.1 配置文件详解

// ~/.idea/ai-assistant.json
{
  "version": "1.0",
  "default_agent": "codex",
  "agents": {
    "codex": {
      "type": "custom_acp",
      "name": "OpenAI Codex",
      "description": "OpenAI's powerful code generation model",
      "enabled": true,
      "default": true,
      "config": {
        "host": "api.openai.com",
        "port": 443,
        "protocol": "https",
        "path": "/v1/chat/completions",
        "timeout": 30000,
        "max_retries": 3,
        "headers": {
          "Authorization": "Bearer ${OPENAI_API_KEY}",
          "Content-Type": "application/json",
          "User-Agent": "IntelliJ-IDEA-AI-Assistant/2026.1"
        },
        "parameters": {
          "model": "gpt-4",
          "temperature": 0.7,
          "max_tokens": 4096,
          "top_p": 0.9,
          "frequency_penalty": 0.0,
          "presence_penalty": 0.0,
          "stream": true
        }
      },
      "capabilities": {
        "code_generation": true,
        "code_explanation": true,
        "code_refactoring": true,
        "debug_assistance": true,
        "documentation": true,
        "test_generation": true,
        "code_review": true
      },
      "contexts": {
        "file": true,
        "project": true,
        "selection": true,
        "clipboard": true
      }
    },
    "claude": {
      "type": "custom_acp",
      "name": "Claude Code",
      "enabled": false,
      "config": {
        "host": "api.anthropic.com",
        "port": 443,
        "protocol": "https",
        "path": "/v1/messages",
        "headers": {
          "x-api-key": "${ANTHROPIC_API_KEY}",
          "anthropic-version": "2023-06-01"
        },
        "parameters": {
          "model": "claude-3-opus-20240229",
          "max_tokens": 4096,
          "temperature": 0.7
        }
      }
    }
  },
  "settings": {
    "auto_suggest": true,
    "inline_completion": true,
    "chat_history_retention": 30,
    "max_context_tokens": 8192
  }
}

5.2 环境变量管理

# 创建环境变量配置文件
# ~/.idea/ai-assistant.env

# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4
OPENAI_TEMPERATURE=0.7

# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx
ANTHROPIC_MODEL=claude-3-opus-20240229

# 本地模型
LOCAL_MODEL_HOST=localhost
LOCAL_MODEL_PORT=11434
LOCAL_MODEL_NAME=codellama

5.3 高级配置

// 高级配置示例
{
  "agents": [
    {
      "id": "codex-prod",
      "name": "Codex Production",
      "type": "custom_acp",
      "config": {
        "host": "api.openai.com",
        "port": 443,
        "protocol": "https",
        "path": "/v1/chat/completions",
        "timeout": 60000,
        "proxy": {
          "host": "proxy.example.com",
          "port": 8080,
          "username": "user",
          "password": "pass"
        },
        "rate_limit": {
          "requests_per_minute": 60,
          "tokens_per_minute": 100000
        },
        "retry_policy": {
          "max_attempts": 5,
          "backoff_factor": 2.0,
          "retry_on_status_codes": [429, 500, 502, 503, 504]
        }
      }
    }
  ]
}

---

六、MCP服务器配置与使用

6.1 启用和配置 MCP 服务器

# 步骤 1：确认插件启用
Settings → Plugins
搜索 "MCP Server"
确保状态为 "Enabled"

# 步骤 2：配置 MCP 服务器
Settings → Tools → MCP Server

# 配置项：
- Enable MCP Server: ✅ 勾选
- Port: 3000 (默认，可修改)
- Allowed clients: codex, cursor, vscode, gemini
- Authentication: 
  - Type: Token-based (推荐)
  - Token: 点击 "Generate" 生成
  - 或手动设置: your-custom-token-12345

# 步骤 3：配置防火墙（如果需要远程访问）
# Windows
netsh advfirewall firewall add rule name="MCP Server" dir=in action=allow protocol=TCP localport=3000

# Linux
sudo ufw allow 3000/tcp

# 步骤 4：应用配置
Click "Apply" → "OK"

6.2 MCP 配置文件

// ~/.idea/mcp-server.json
{
  "version": "1.0",
  "enabled": true,
  "port": 3000,
  "host": "0.0.0.0",  // 0.0.0.0 允许远程访问，127.0.0.1 仅本地
  "authentication": {
    "type": "token",
    "token": "your-mcp-token-here",
    "token_ttl": 86400  // Token 有效期（秒）
  },
  "allowed_clients": [
    "codex",
    "cursor",
    "vscode",
    "gemini",
    "claude"
  ],
  "capabilities": {
    "file_system": true,
    "git": true,
    "debugger": true,
    "terminal": true,
    "refactoring": true
  },
  "rate_limiting": {
    "enabled": true,
    "requests_per_minute": 100,
    "concurrent_connections": 10
  },
  "logging": {
    "level": "info",
    "file": "~/.idea/mcp-server.log"
  }
}

6.3 外部工具配置示例

Cursor 配置

// Cursor settings.json
{
  "mcpServers": {
    "idea": {
      "command": "mcp-idea-client",
      "args": [
        "--host", "localhost",
        "--port", "3000",
        "--token", "your-mcp-token"
      ]
    }
  }
}

Codex 配置

// ~/.codex/config.json
{
  "mcp_servers": {
    "idea": {
      "host": "localhost",
      "port": 3000,
      "token": "your-mcp-token"
    }
  }
}

---

七、常见陷阱与问题解决

7.1 连接失败问题

问题 1：Connection refused

# 症状
Test Connection 失败，提示 "Connection refused" 或 "无法连接"

# 可能原因
1. 服务未启动（本地模型）
2. 端口被占用
3. 防火墙阻止
4. 网络问题

# 解决方案
# 1. 检查服务状态
# 对于本地服务（如 Ollama）
netstat -tuln | grep 11434  # Linux/macOS
netstat -ano | findstr 11434  # Windows

# 2. 重启服务
# Ollama
ollama serve

# Codex CLI
codex serve --port 5000

# 3. 检查防火墙
# Windows
netsh advfirewall firewall show rule name=all | findstr 5000

# Linux
sudo ufw status | grep 5000

# 4. 测试网络连接
curl http://localhost:11434/api/version  # 测试 Ollama
curl https://api.openai.com/v1/models -H "Authorization: Bearer YOUR_KEY"

问题 2：401 Unauthorized

# 症状
连接成功但返回 401 错误

# 可能原因
1. API Key 错误或过期
2. Token 不正确
3. 认证头格式错误

# 解决方案
# 1. 检查 API Key
# 查看配置文件中的 API Key
cat ~/.idea/ai-assistant.json | grep api_key

# 2. 更新 API Key
# 在服务商网站重新生成 API Key
# 更新 IDEA 配置

# 3. 验证 API Key
# 使用 curl 测试
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

# 4. 检查认证头格式
# 确保格式正确：
# OpenAI: "Authorization: Bearer YOUR_KEY"
# Anthropic: "x-api-key: YOUR_KEY"
# DeepSeek: "Authorization: Bearer YOUR_KEY"

问题 3：429 Too Many Requests

# 症状
频繁请求后返回 429 错误

# 可能原因
1. 超过 API 调用频率限制
2. 超过 Token 使用限制

# 解决方案
# 1. 降低请求频率
# 在配置中增加重试间隔
{
  "retry_policy": {
    "max_attempts": 5,
    "backoff_factor": 3.0,
    "retry_on_status_codes": [429]
  }
}

# 2. 升级 API 计划
# 联系服务商升级到更高配额的计划

# 3. 使用多个 API Key 轮换
# 配置多个 Agent，轮流使用

7.2 ACP 配置问题

问题 4：Agent 列表为空或灰色

# 症状
AI Assistant → Agents 列表为空或全部灰色不可用

# 可能原因
1. AI Assistant 插件未启用
2. IDEA 版本过低（< 2026.1）
3. 配置文件损坏
4. 插件冲突

# 解决方案
# 1. 检查插件状态
Settings → Plugins → Installed
搜索 "AI Assistant"
确认状态为 "Enabled"
如果不是，点击 "Enable" → 重启 IDEA

# 2. 检查 IDEA 版本
Help → About
确认版本 >= 2026.1
如果不是，升级到最新版本

# 3. 重置配置
# 备份后删除配置文件
mv ~/.idea/ai-assistant.json ~/.idea/ai-assistant.json.bak
mv ~/.idea/ai-assistant-agents.json ~/.idea/ai-assistant-agents.json.bak
# 重启 IDEA

# 4. 检查插件冲突
Settings → Plugins → Installed
禁用其他 AI 相关插件（如旧版本的 CodeGeeX 等）
重启 IDEA

问题 5：自定义 ACP 服务无法添加

# 症状
点击 "Add ACP Agent" 无反应或报错

# 可能原因
1. IDEA Bug
2. 权限问题
3. 配置文件锁定

# 解决方案
# 1. 升级到最新版本
Help → Check for Updates
升级到 2026.1.1 或更高版本

# 2. 手动创建配置文件
# 创建或编辑 ~/.idea/ai-assistant-agents.json
# 内容参考第 5.2 节

# 3. 检查文件权限
# Linux/macOS
ls -la ~/.idea/ai-assistant*.json
chmod 644 ~/.idea/ai-assistant*.json

# 4. 重启 IDEA
File → Invalidate Caches → Invalidate and Restart

问题 6：ACP 注册表无法访问

# 症状
Browse ACP Registry 无法加载或显示错误

# 可能原因
1. 网络连接问题
2. 代理配置错误
3. 防火墙阻止

# 解决方案
# 1. 检查网络连接
ping registry.acp.jetbrains.com

# 2. 配置代理
Settings → Appearance & Behavior → System Settings → HTTP Proxy
选择 "Auto-detect proxy settings" 或手动配置

# 3. 使用 TUN 模式（推荐）
# 不建议使用 HTTP Proxy，会影响其他功能
# 使用系统级代理或 TUN 模式

# 4. 手动下载 Agent
# 从 GitHub 或其他源下载 Agent 配置
# 手动添加到配置文件

7.3 MCP 服务器问题

问题 7：MCP 服务器无法启动

# 症状
Settings → Tools → MCP Server 选项灰色或无法启用

# 可能原因
1. MCP Server 插件未安装
2. 插件损坏
3. 端口被占用

# 解决方案
# 1. 重新安装插件
Settings → Plugins → Installed
找到 "MCP Server"
点击 "Uninstall"
重启 IDEA
Settings → Plugins → Marketplace
搜索 "MCP Server"
点击 "Install"
重启 IDEA

# 2. 检查插件兼容性
Settings → Plugins → Installed
右键 "MCP Server" → "Show Details"
确认兼容版本包含当前 IDEA 版本

# 3. 检查端口占用
# Linux/macOS
lsof -i :3000
# Windows
netstat -ano | findstr 3000

# 如果端口被占用，修改配置中的端口

问题 8：外部工具无法连接 MCP

# 症状
Cursor/Codex 无法连接到 IDEA MCP Server

# 可能原因
1. 端口被防火墙阻止
2. Token 不匹配
3. 网络配置错误（使用了 localhost 但需要远程 IP）
4. MCP 服务器未正确启动

# 解决方案
# 1. 检查端口监听
# Linux/macOS
netstat -tuln | grep 3000
# Windows
netstat -ano | findstr 3000

# 应该看到类似：
# tcp        0      0 0.0.0.0:3000          0.0.0.0:*            LISTEN

# 2. 验证 Token
# 检查 IDEA 中的 Token
Settings → Tools → MCP Server → Token
# 确保与外部工具配置的 Token 一致

# 3. 配置防火墙
# Windows
netsh advfirewall firewall add rule name="MCP Server" dir=in action=allow protocol=TCP localport=3000

# Linux
sudo ufw allow 3000/tcp

# 4. 检查网络配置
# 如果外部工具在远程机器上
# IDEA 配置中设置 host: 0.0.0.0 (允许所有 IP)
# 外部工具配置中使用 IDEA 所在机器的实际 IP，而不是 localhost

# 5. 查看日志
# IDEA 日志位置：
# Windows: C:\Users\<username>\AppData\Local\JetBrains\IntelliJIdea2026.1\log\idea.log
# macOS: ~/Library/Logs/JetBrains/IntelliJIdea2026.1/idea.log
# Linux: ~/.cache/JetBrains/IntelliJIdea2026.1/log/idea.log

7.4 性能问题

问题 9：响应慢或超时

# 症状
AI 响应非常慢或经常超时

# 可能原因
1. 网络延迟（特别是远程服务）
2. 服务器资源不足
3. 配置超时时间过短
4. 上下文过大

# 解决方案
# 1. 增加超时时间
Settings → Tools → AI Assistant → Agents
编辑对应 Agent
Timeout: 改为 60000 (60秒) 或更高

# 2. 优化网络
# 如果使用远程服务，考虑：
# - 使用更近的服务器区域
# - 使用代理加速
# - 检查网络质量

# 3. 减少上下文大小
# 在配置中限制上下文
{
  "max_context_tokens": 4096,  // 减少上下文
  "include_file_context": false,  // 不包含整个文件
  "include_project_context": false  // 不包含整个项目
}

# 4. 检查服务器资源
# 监控 CPU 和内存使用
# 必要时升级服务器配置或使用更强的模型

# 5. 使用流式响应
# 在配置中启用流式
{
  "stream": true
}

问题 10：IDEA 卡顿或内存不足

# 症状
接入 AI 后 IDEA 变得卡顿，或提示内存不足

# 可能原因
1. IDEA 内存分配不足
2. 同时运行多个 AI Agent
3. 插件冲突

# 解决方案
# 1. 增加 IDEA 内存
Help → Change Memory Settings
Set to: 4096 MB (4GB) 或更高（推荐 8192 MB）

# 2. 优化 VM 选项
# 编辑 idea64.exe.vmoptions (Windows) 或 idea.vmoptions (macOS/Linux)
-Xms1024m
-Xmx8192m
-XX:ReservedCodeCacheSize=1024m
-XX:+UseG1GC
-XX:SoftRefLRUPolicyMSPerMB=50
-XX:CICompilerCount=2
-XX:+HeapDumpOnOutOfMemoryError
-XX:-OmitStackTraceInFastThrow
-ea
-Dsun.io.useCanonCaches=false
-Djdk.http.auth.tunneling.disabledSchemes=""
-Djdk.attach.allowAttachSelf=true
-Djdk.module.illegalAccess.silent=true
-Dkotlinx.coroutines.debug=off
-Djdk.http.auth.tunneling.disabledSchemes=""
-Dide.no.platform.update=true

# 3. 禁用不必要的插件
Settings → Plugins
禁用不常用的插件
特别是其他 AI 相关插件

# 4. 限制同时激活的 Agent 数量
# 只启用当前需要的 Agent
Settings → Tools → AI Assistant → Agents
禁用不需要的 Agent

# 5. 清理缓存
File → Invalidate Caches → Invalidate and Restart

---

八、高级功能与最佳实践

8.1 多 Agent 管理

// 配置多个 Agent 用于不同场景
{
  "agents": [
    {
      "id": "codex-dev",
      "name": "Codex (Development)",
      "type": "custom_acp",
      "config": {
        "host": "api.openai.com",
        "model": "gpt-4",
        "temperature": 0.7
      },
      "tags": ["development", "creative"],
      "default": true
    },
    {
      "id": "codex-code-review",
      "name": "Codex (Code Review)",
      "type": "custom_acp",
      "config": {
        "host": "api.openai.com",
        "model": "gpt-4",
        "temperature": 0.3  // 更低的 temperature 用于代码审查
      },
      "tags": ["code-review", "quality"]
    },
    {
      "id": "claude-explanation",
      "name": "Claude (Explanation)",
      "type": "custom_acp",
      "config": {
        "host": "api.anthropic.com",
        "model": "claude-3-opus-20240229",
        "temperature": 0.7
      },
      "tags": ["explanation", "documentation"]
    },
    {
      "id": "local-quick",
      "name": "Local Model (Quick)",
      "type": "custom_acp",
      "config": {
        "host": "localhost",
        "port": 11434,
        "model": "mistral",
        "temperature": 0.7
      },
      "tags": ["quick", "offline"],
      "enabled": false  // 默认禁用，需要时手动启用
    }
  ],
  "agent_groups": {
    "web-development": ["codex-dev", "claude-explanation"],
    "data-science": ["codex-dev", "local-quick"],
    "code-review": ["codex-code-review"]
  }
}

8.2 Git 工作树集成

# 利用 Git Worktree 功能
# 将不同分支交给不同的 AI Agent 处理

# 步骤 1：创建工作树
git worktree add ../feature-branch feature-branch
git worktree add ../hotfix-branch hotfix

# 步骤 2：在不同工作树中使用不同 Agent
# 主分支：使用 Codex (Development) 进行新功能开发
# feature-branch：使用 Codex (Code Review) 进行代码审查
# hotfix-branch：使用 Local Model (Quick) 快速修复

# 步骤 3：并行处理
# 主分支继续开发新功能
# feature-branch 交给 AI 完成代码审查和优化
# hotfix-branch 使用本地模型快速生成修复代码

8.3 自定义提示模板

// ~/.idea/ai-assistant-templates.json
{
  "version": "1.0",
  "templates": [
    {
      "id": "code_review",
      "name": "Code Review",
      "description": "Review code for quality, bugs, and improvements",
      "prompt": "Please review the following code and provide suggestions for improvement. Focus on:\n1. Code quality and readability\n2. Potential bugs or issues\n3. Performance optimizations\n4. Best practices\n\nCode:\n{code}",
      "context": "selection",
      "agent": "codex-code-review"
    },
    {
      "id": "generate_tests",
      "name": "Generate Unit Tests",
      "description": "Generate comprehensive unit tests",
      "prompt": "Generate comprehensive unit tests for the following code. Include:\n1. Happy path tests\n2. Edge cases\n3. Error handling\n4. Mock dependencies if needed\n\nCode:\n{code}\n\nUse {language} testing framework.",
      "context": "current_file",
      "agent": "codex-dev"
    },
    {
      "id": "explain_code",
      "name": "Explain Code",
      "description": "Explain code in detail",
      "prompt": "Explain the following code in detail:\n1. What does it do?\n2. How does it work?\n3. What are the key components?\n4. Are there any potential issues?\n\nCode:\n{code}",
      "context": "selection",
      "agent": "claude-explanation"
    },
    {
      "id": "refactor_code",
      "name": "Refactor Code",
      "description": "Refactor code for better design",
      "prompt": "Refactor the following code to improve:\n1. Code structure and organization\n2. Readability and maintainability\n3. Performance if possible\n4. Follow best practices\n\nKeep the same functionality.\n\nCode:\n{code}",
      "context": "selection",
      "agent": "codex-dev"
    },
    {
      "id": "generate_docs",
      "name": "Generate Documentation",
      "description": "Generate API documentation",
      "prompt": "Generate comprehensive documentation for the following code:\n1. Function/class descriptions\n2. Parameters and return values\n3. Usage examples\n4. Edge cases and limitations\n\nCode:\n{code}\n\nFormat: {format}",
      "context": "current_file",
      "parameters": {
        "format": {
          "type": "enum",
          "values": ["Markdown", "Javadoc", "Python docstring"],
          "default": "Markdown"
        }
      },
      "agent": "claude-explanation"
    }
  ]
}

8.4 团队协作配置

// 团队共享配置（放在项目仓库中）
// .idea/ai-team-config.json

{
  "team_settings": {
    "recommended_agents": [
      "codex-dev",
      "claude-explanation"
    ],
    "coding_standards": {
      "style": "Google Java Style",
      "max_line_length": 100,
      "indent_size": 2,
      "use_tabs": false
    },
    "code_review_checklist": [
      "Code follows team standards",
      "No hardcoded secrets",
      "Proper error handling",
      "Adequate test coverage",
      "Clear comments and documentation"
    ]
  },
  "shared_templates": [
    {
      "id": "team-code-review",
      "name": "Team Code Review",
      "prompt": "Review this code according to our team standards:\n{standards}\n\nChecklist:\n{checklist}\n\nCode:\n{code}",
      "context": "selection"
    }
  ]
}

---

九、参考资料

9.1 官方文档

• IntelliJ IDEA 2026.1 官方文档
• AI Assistant 插件文档
• MCP Server 文档
• ACP 协议规范
• JetBrains AI 博客

9.2 AI 模型官方文档

• OpenAI API Documentation
• Anthropic Claude Documentation
• GitHub Copilot Documentation
• Ollama Documentation

9.3 社区资源

• JetBrains 官方论坛
• GitHub ACP 项目
• Reddit r/IntelliJIDEA
• Stack Overflow IntelliJ IDEA 标签

9.4 视频教程

• IDEA 2026.1 AI 功能详解
• ACP 协议配置教程
• MCP 服务器实战
• 本地大模型接入指南

---

十、总结

10.1 核心要点

✅ IDEA 2026.1 革命性的 AI 集成

• 通过 ACP 协议，可以轻松接入多种 AI 大模型
• MCP 服务器允许外部工具访问 IDEA 功能
• 支持云端和本地模型，灵活选择

✅ 主流 AI 模型全面支持

1. Codex：OpenAI 强大代码生成
2. Claude Code：Anthropic 优秀解释能力
3. Cursor：通过 MCP 协作
4. GitHub Copilot：GitHub 官方支持
5. 本地大模型：Ollama 支持

✅ 三种接入方式

1. ACP 协议（推荐）：配置简单，功能完整
2. MCP 服务器：适合远程协作
3. 插件方式：特定模型专用
4. ACP 注册表：一键安装，快速上手

✅ 常见问题解决

• 连接失败：检查服务状态、端口、防火墙
• 配置问题：重置配置文件、升级版本
• 性能问题：优化网络、调整超时时间

10.2 最佳实践建议

# 1. 版本选择
✅ 使用 IDEA 2026.1.1 或更高版本
✅ 保持插件更新到最新版本

# 2. 配置管理
✅ 使用环境变量管理敏感信息
✅ 定期备份配置文件
✅ 为不同环境创建不同 Agent

# 3. 安全考虑
✅ 不要将 API Key 提交到版本控制
✅ 使用防火墙限制访问
✅ 定期更新 Token
✅ 使用代理时注意安全

# 4. 性能优化
✅ 分配足够的内存给 IDEA (推荐 8GB+)
✅ 使用 SSD 存储项目
✅ 禁用不必要的插件
✅ 限制同时激活的 Agent 数量

# 5. 团队协作
✅ 使用团队共享配置
✅ 制定 AI 使用规范
✅ 定期审查 AI 生成的代码

10.3 未来展望

随着 IDEA 不断进化，AI 集成将更加深入：

• 🚀 更多 AI 模型原生支持
• 🚀 更智能的代码生成和审查
• 🚀 更强大的团队协作功能
• 🚀 更完善的本地模型支持
• 🚀 更低的延迟和更高的性能

---

十一、附录

11.1 快捷键大全

功能	Windows/Linux	macOS	说明
打开 AI Chat	Alt + 9	Option + 9	打开 AI 聊天窗口
生成代码	Ctrl + Alt + G	Cmd + Option + G	根据上下文生成代码
解释代码	Ctrl + Alt + E	Cmd + Option + E	解释选中代码
重构建议	Ctrl + Alt + R	Cmd + Option + R	获取重构建议
切换 Agent	Ctrl + Alt + A	Cmd + Option + A	切换当前 AI Agent
打开配置	Ctrl + Alt + S	Cmd + ,	打开设置
AI Assistant	-	-	Settings → Tools → AI Assistant
生成文档	Ctrl + Alt + D	Cmd + Option + D	生成代码文档
代码审查	Ctrl + Alt + C	Cmd + Option + C	代码质量审查
测试生成	Ctrl + Alt + T	Cmd + Option + T	生成单元测试

11.2 配置文件位置

# Windows
C:\Users\<username>\.idea\ai-assistant.json
C:\Users\<username>\.idea\ai-assistant-agents.json
C:\Users\<username>\.idea\mcp-server.json
C:\Users\<username>\AppData\Local\JetBrains\IntelliJIdea2026.1\log\idea.log

# macOS
~/.idea/ai-assistant.json
~/.idea/ai-assistant-agents.json
~/.idea/mcp-server.json
~/Library/Logs/JetBrains/IntelliJIdea2026.1/idea.log

# Linux
~/.idea/ai-assistant.json
~/.idea/ai-assistant-agents.json
~/.idea/mcp-server.json
~/.cache/JetBrains/IntelliJIdea2026.1/log/idea.log

11.3 命令行工具

# Ollama
ollama serve                     # 启动服务
ollama list                      # 列出模型
ollama pull codellama            # 下载模型
ollama run codellama             # 运行模型

# IDEA 命令行
idea .                           # 打开当前目录项目
idea --help                      # 帮助信息

11.4 故障排查清单

□ 检查 IDEA 版本是否 >= 2026.1
□ 确认 AI Assistant 插件已启用
□ 验证相关服务是否正常运行（Ollama等）
□ 检查端口是否被占用
□ 确认防火墙配置正确
□ 验证 API Key 是否有效
□ 检查网络连接是否正常
□ 查看 IDEA 日志获取详细错误信息
□ 尝试重置配置文件
□ 考虑升级到最新版本

11.5 常用 API 端点

# OpenAI
https://api.openai.com/v1/chat/completions
https://api.openai.com/v1/models

# Anthropic
https://api.anthropic.com/v1/messages

# Ollama (本地)
http://localhost:11434/api/chat
http://localhost:11434/api/generate

---

🎉 结语

通过本指南，您应该能够成功在 IntelliJ IDEA 2026.1 中接入多种 AI 大模型，并充分利用其强大的 AI 编程能力。无论您选择云端服务还是本地模型，IDEA 都提供了灵活的配置选项。

记住：AI 是工具，真正的创造力和判断力来自于您！合理使用 AI 可以极大提升开发效率，但最终的代码质量和架构设计仍需要开发者的智慧。

祝您编码愉快，效率倍增！ 🚀