IntelliJ IDEA 保姆级安装 + ClaudeAPI 配置教程

本教程适合零基础用户，从安装插件到配置 Claude 模型，一步步带你在 IDEA 中用上 AI 编程助手。无需付费订阅，通过 ClaudeAPI 免费接入最新的 Claude 模型。

一、下载安装 IntelliJ IDEA

下载步骤

前往官网下载：https://www.jetbrains.com/idea/download

选择版本说明：

社区版（Community）：免费，推荐用于学习和开发
专业版（Ultimate）：付费，包含更多企业级功能

💡 提示：社区版功能已足够满足日常编程需求，完全可以用。下载完成后按提示安装即可。

验证安装

安装完成后，双击启动 IntelliJ IDEA，看到欢迎界面说明安装成功。

二、安装 Continue 插件

为什么用 Continue？

JetBrains 内置的 AI Assistant 需要付费订阅，而 Continue 插件 可以接入第三方 API（如 ClaudeAPI），完全免费使用，功能也不少。

安装步骤

步骤 1：打开设置

Windows/Linux ：点击菜单 File → Settings
macOS ：点击菜单 IntelliJ IDEA → Preferences

步骤 2：进入插件市场

在左侧菜单找到 Plugins → Marketplace

复制代码

File → Settings → Plugins → Marketplace

步骤 3：搜索并安装

在搜索框输入 Continue
找到由 Continue 官方发布的插件
点击 Install 按钮安装

步骤 4：重启 IDE

安装完成后会提示 Restart IDE，点击确认重启。

步骤 5：验证安装

重启后，在 IDE 右侧边栏会出现 Continue 图标 （通常是一个代码符号 ><），点击即可打开 AI 对话面板。

如果看不到 Continue 图标，可以手动打开：View → Tool Windows → Continue

三、配置 Claude 模型

本教程使用 ClaudeAPI 的 OpenAI 兼容接口配置，支持多种配置方式。

前置准备

登录 ClaudeAPI 官网
在后台生成或复制你的 API Key （格式：sk- 开头）
记住 API 基础地址 ：https://gw.claudeapi.com/v1

方式一：通过 UI 界面配置（推荐新手）

步骤 1：打开 Continue 面板

点击右侧边栏的 Continue 图标。

步骤 2：进入设置

在 Continue 面板右下角找到 齿轮图标 ⚙️，点击进入设置页面。

步骤 3：添加新模型

点击 Add Model → Add a model

步骤 4：填写配置信息

按照下表逐项填写：

配置项	填写内容	说明
Provider	OpenAI Compatible	不要选 Anthropic，必须选 OpenAI Compatible
API Key	`sk-xxxxxxxxxxxx`	从 ClaudeAPI 后台复制你的 API Key
Model	`claude-opus-4-6`	可选 opus-4-6、sonnet-4-6、haiku-4-5
API Base	`https://gw.claudeapi.com/v1`	不要遗漏末尾的 `/v1`

步骤 5：测试连接

点击 Connect 按钮
返回 Continue 对话框，发送测试消息：

Reply with exactly one word: OK
如果能收到 OK 的回复，说明配置成功 ✅

方式二：直接编辑配置文件（高级用户）

步骤 1：打开配置文件

点击 Continue 面板右下角的 齿轮图标 ⚙️
点击 Open config.yaml 打开配置文件

步骤 2：编辑配置

将 config.yaml 文件改成以下内容：

yaml 复制代码

name: Local Config
version: 1.0.0
schema: v1

models:
  - name: Claude Opus 4.6
    provider: openai
    model: claude-opus-4-6
    apiKey: sk-xxxxxxxxxxxxxxxxxxxx
    apiBase: https://gw.claudeapi.com/v1

  - name: Claude Sonnet 4.6
    provider: openai
    model: claude-sonnet-4-6
    apiKey: sk-xxxxxxxxxxxxxxxxxxxx
    apiBase: https://gw.claudeapi.com/v1

  - name: Claude Haiku 4.5
    provider: openai
    model: claude-haiku-4-5-20251001
    apiKey: sk-xxxxxxxxxxxxxxxxxxxx
    apiBase: https://gw.claudeapi.com/v1

重点修改：

将所有 apiKey 的值替换为你的真实 API Key：

yaml 复制代码

apiKey: sk-xxxxxxxxxxxxxxxxxxxx  # 改成你的 API Key

步骤 3：保存并测试

保存 config.yaml 文件（Ctrl+S）
回到 Continue 面板，在右下角选择模型（例如选中 Claude Opus 4.6）
发送测试消息：

你是谁？请用中文回答，不要重复我的问题。

能正常输出中文回答，说明配置完全成功 ✅

四、安装中文语言包（可选）

如果你想让整个 IntelliJ IDEA 界面显示为中文，可以安装官方中文语言包。

安装步骤

打开 File → Settings → Plugins → Marketplace
搜索 Chinese (Simplified) 或 中文
找到由 JetBrains 官方发布的语言包
点击 Install 安装
重启 IDE

完成后，整个 IDEA 界面都会切换为中文。

💡 提示：安装中文包不是必须的，Continue 的对话功能与语言无关。

五、常见问题排查

问题	原因分析	解决方案
Continue 图标在哪里？	插件未正确安装或启用	1. 重启 IDEA； 2. 进入 Settings → Plugins 检查 Continue 是否已启用； 3. 手动打开：View → Tool Windows → Continue
API 报错 401 Unauthorized	API Key 错误或失效	1. 检查 API Key 是否完整复制； 2. 确认 API Key 未过期； 3. 从 ClaudeAPI 后台重新生成新的 API Key
API 报错 404 Not Found	API 基础地址配置错误	1. 检查 `apiBase` 是否为 `https://gw.claudeapi.com/v1`； 2. 特别注意末尾的 `/v1` 不要遗漏
API 报错 503 Service Unavailable	第三方网关暂时不可用	1. 稍后重试； 2. 检查网络连接； 3. 切换其他模型再试
模型不回复，只复读我的输入	Provider 配置错误	1. 确认使用 `provider: openai`，不是 `anthropic`； 2. 确认 API Base 带有 `/v1`
模型名报错 Model not found	模型 ID 不存在或写错	从 ClaudeAPI 模型列表复制真实的模型 ID，例如 `claude-opus-4-6`
中文回复乱码或异常	编码问题或网络波动	1. 先用英文测试：`Reply with exactly one word: OK`； 2. 确认接口正常后再测试中文； 3. 如果仍有问题，尝试切换模型
Continue 面板无法打开	IDE 状态异常	1. 重启 IDEA； 2. 卸载 Continue 重新安装； 3. 清除缓存：File → Invalidate Caches

总结与快速开始

快速检查清单

安装了 IntelliJ IDEA
安装了 Continue 插件
获取了 ClaudeAPI 的 API Key
配置了模型信息（Provider、API Key、Model、API Base）
测试发送消息成功
选择了合适的模型（推荐 Sonnet 4.6）

下一步

配置完成后，你就可以在编写代码时，随时打开 Continue 面板，让 Claude AI 来：

✅ 生成代码片段

✅ 解释代码逻辑

✅ 快速修复 Bug

✅ 优化性能建议

✅ 代码审查与重构

祝你使用愉快！ 🎉

IntelliJ IDEA 保姆级安装 + ClaudeAPI 配置教程