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

–

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

• • 摘要
  • 一、摘要与概述
  • • 1.1 版本信息
    • 1.2 支持的AI模型
    • 1.3 接入方式对比
  • 二、环境准备
  • • 2.1 系统要求
    • 2.2 前置软件安装
    • • 安装 Node.js（部分ACP服务需要）
      • 安装 Python 和 uv（某些本地模型需要）
    • 2.3 检查插件状态
  • 三、核心概念解析
  • • 3.1 ACP (Agent Client Protocol)
    • 3.2 MCP (Model Context Protocol)
    • 3.3 ACP注册表
  • 四、主流AI模型接入配置
  • • 4.1 Codex 接入
    • • 方式一：通过ACP注册表（最简单）
      • 配置文件示例
    • 4.2 Claude Code 接入
    • • 配置步骤
      • 配置文件示例
    • 4.3 Cursor 接入
    • • 通过MCP服务器接入
    • 4.4 GitHub Copilot 接入
    • • 通过官方插件
    • 4.5 本地大模型接入（Ollama）
    • • 配置步骤
      • 配置文件示例
  • 五、ACP协议详细配置
  • • 5.1 配置文件详解
    • 5.2 环境变量管理
    • 5.3 高级配置
  • 六、MCP服务器配置与使用
  • • 6.1 启用和配置 MCP 服务器
    • 6.2 MCP 配置文件
    • 6.3 外部工具配置示例
    • • Cursor 配置
      • Codex 配置
  • 七、常见陷阱与问题解决
  • • 7.1 连接失败问题
    • • 问题 1：Connection refused
      • 问题 2：401 Unauthorized
      • 问题 3：429 Too Many Requests
    • 7.2 ACP 配置问题
    • • 问题 4：Agent 列表为空或灰色
      • 问题 5：自定义 ACP 服务无法添加
      • 问题 6：ACP 注册表无法访问
    • 7.3 MCP 服务器问题
    • • 问题 7：MCP 服务器无法启动
      • 问题 8：外部工具无法连接 MCP
    • 7.4 性能问题
    • • 问题 9：响应慢或超时
      • 问题 10：IDEA 卡顿或内存不足
  • 八、高级功能与最佳实践
  • • 8.1 多 Agent 管理
    • 8.2 Git 工作树集成
    • 8.3 自定义提示模板
    • 8.4 团队协作配置
  • 九、参考资料
  • • 9.1 官方文档
    • 9.2 AI 模型官方文档
    • 9.3 社区资源
    • 9.4 视频教程
  • 十、总结
  • • 10.1 核心要点
    • 10.2 最佳实践建议
    • 10.3 未来展望
  • 十一、附录
  • • 11.1 快捷键大全
    • 11.2 配置文件位置
    • 11.3 命令行工具
    • 11.4 故障排查清单
    • 11.5 常用 API 端点
  • 🎉 结语

摘要

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

一、摘要与概述

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模型

1.3 接入方式对比

二、环境准备

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 模型全面支持

✅ 三种接入方式

✅ 常见问题解决

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

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 快捷键大全

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 可以极大提升开发效率，但最终的代码质量和架构设计仍需要开发者的智慧。

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