外观
IntelliJ IDEA / JetBrains 配置指南
最近更新:2026 年 10 月 17 日(Asia/Shanghai)
适用:IntelliJ IDEA、Android Studio、PyCharm、WebStorm 等 JetBrains IDE。常见接入方式是 Continue、Proxy AI 类插件,或 IDE 内置 AI Assistant 的自定义 OpenAI 兼容端点(视版本与许可证而定)。
1. 准备令牌
控制台创建令牌(如 jetbrains),复制 sk-xxxxxxxx。建议单独额度上限。
Base URL 口诀:
| 协议类型 | 填写 |
|---|---|
| OpenAI Compatible | https://ai.afp.net/v1 |
| Anthropic 自定义 | https://ai.afp.net(无 /v1) |
2. 使用 Continue 插件(推荐通用路径)
- 在 JetBrains 插件市场安装 Continue。
- 打开 Continue 配置(通常为本地
config.json/config.yaml,以插件当前文档为准)。 - 添加 OpenAI 兼容模型,示例(JSON 思路):
json
{
"models": [
{
"title": "词源探索 Claude Sonnet",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "https://ai.afp.net/v1",
"apiKey": "sk-xxxxxxxx"
},
{
"title": "词源探索 Gemini",
"provider": "openai",
"model": "gemini-3.1-pro",
"apiBase": "https://ai.afp.net/v1",
"apiKey": "sk-xxxxxxxx"
}
]
}字段名随 Continue 大版本可能变为 apiBase / baseURL 等,请以插件内示例为准,保留「根地址 + /v1」这一含义。
- 保存后在 Continue 面板选择模型,发送测试消息。
3. 内置 AI Assistant / 其它商业插件
若你的 JetBrains AI 功能支持「第三方 OpenAI API」:
- 打开 Settings → Tools → AI Assistant(或同类菜单)。
- 选择自定义 / OpenAI 兼容提供商。
- 填入 API Key 与 Base URL(多数要求带
/v1)。 - 模型名填写平台真实 ID(如
claude-sonnet-4-6),不要填控制台不存在的名称。
不同版本菜单路径差异较大;若找不到自定义端点,请改用 Continue,或在终端使用 Claude Code / OpenCode。
4. HTTP 代理与公司网络
- 若 IDE 走系统代理,确保能访问你的
https://ai.afp.net。 - 自签名证书环境可能需在 JVM / IDE 信任库导入证书,否则 TLS 握手失败。
- 本地只监听内网的网关地址,在办公网以外会连不上——这与 Key 无关。
5. 推荐模型
| 场景 | 模型 ID |
|---|---|
| 日常 Java / Kotlin 开发 | claude-sonnet-4-6 |
| 复杂架构 / 长推理 | claude-opus-4-8、claude-opus-5 |
| 快速问答 | claude-haiku-4-5、gemini-3.5-flash |
| 中文文档 / 通义 | qwen3.8-max、glm-5.3 |
完整列表见 帮助中心。
6. 故障排查
| 现象 | 处理 |
|---|---|
| 401 | Key 前后空格、是否用了控制台登录 Cookie 而非 sk- 令牌 |
| 404 | OpenAI 兼容是否漏了 /v1 |
| 模型无效 | ID 是否与 /v1/models 完全一致(含日期后缀) |
| 超时 | 推理模型首包较慢,调大插件超时;或改用 flash/haiku |
| 无可用渠道 | 令牌分组下没有该模型 → 换分组或换模型 |
返回:帮助中心