IntelliJ IDEA / Android Studio 配置指南

适用 IDE:

• IntelliJ IDEA: JetBrains 旗舰 IDE (Ultimate/Community)
• Android Studio: Google 官方 Android 开发 IDE
• 其他 JetBrains IDE: PyCharm、WebStorm、GoLand、Rider 等

说明: 以上 IDE 都是基于 IntelliJ 平台,插件和配置方式完全相同。

支持的模型:

• Claude: Claude Code [Beta] 插件
• GPT: Codex Launcher 插件

关于 IDE 兼容性

本文档适用于以下 JetBrains 系列 IDE:

重要: 所有 JetBrains 系列 IDE 基于统一的 IntelliJ 平台,插件和配置方式完全相同。

1. 配置令牌

1. 访问 NextAI Code 控制台 - 令牌管理 页面。

2. 点击 添加令牌,参照下图进行配置:

   • 名称:随意填写(例如 intellij)
   • 令牌分组:选择对应的分组
   • 过期时间:建议选择 永不过期
   • 新建数量:1

   

3. 额度与限制设置:

   • 额度:建议开启 无限额度
   • 访问限制:留空(不建议启用模型限制)
   • IP白名单:留空(不建议填写)

   

4. 提交后,复制生成的 sk- 开头的令牌。

2. Claude 配置

2.1 安装 Claude CLI

打开终端,执行:

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

验证安装:

claude --version

前置要求: 需要 Node.js 18 或更高版本。

2.2 安装 Claude Code [Beta] 插件

1. 打开 IntelliJ IDEA 或 Android Studio
2. 进入 Settings (Mac: Preferences) > Plugins
3. 在 Marketplace 标签页搜索 "Claude Code"
4. 找到发布者为 Anthropic, PBC 的插件
5. 点击 Install 安装

2.3 配置 API Key 和 Base URL

Claude Code [Beta] 插件会读取 Claude Code CLI 的配置文件和环境变量。

你需要按照 Claude Code CLI 配置指南 中的步骤进行配置。

推荐配置方式 (修改 settings.json):

• Windows: C:\Users\{用户名}\.claude\settings.json
• macOS / Linux: ~/.claude/settings.json

配置文件内容示例：

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
        "ANTHROPIC_BASE_URL": "https://www.nextai-code.com",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
    },
    "alwaysThinkingEnabled": true
}

重要: 配置完成后需要完全重启 IDE (File > Invalidate Caches / Restart > Restart)。

2.4 使用 Claude

配置完成后,Claude Code 插件会自动读取环境变量配置。

使用方式:

在 IDE 顶部工具栏右侧,点击 Claude Code 图标 (橙色 Spark 图标) 即可启动:

点击后会打开 Claude Code 面板,提供 AI 辅助功能。

支持的 Claude 模型:

• claude-4-5-sonnet-20250929 (最新旗舰)
• claude-4-5-opus (超大杯)
• claude-4-5-haiku (极速版)

3. Codex 配置

3.1 安装 Codex CLI

按照 Codex CLI 配置指南 安装 Codex CLI。

npm install -g @openai/codex

3.2 安装 Codex Launcher 插件

1. 打开 IntelliJ IDEA 或 Android Studio
2. 进入 Settings (Mac: Preferences) > Plugins
3. 在 Marketplace 标签页搜索 "Codex Launcher"
4. 找到发布者为 x0x0b 的插件
5. 点击 Install 安装

3.3 配置 API Key 和 Base URL

Codex Launcher 插件会读取 Codex CLI 的配置文件。

配置文件路径:

• config.toml: ~/.codex/config.toml
• auth.json: ~/.codex/auth.json

1. 创建或编辑 config.toml

model_provider = "nextai"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nextai]
name = "nextai"
base_url = "https://www.nextai-code.com/v1"
wire_api = "responses"
requires_openai_auth = true

2. 创建或编辑 auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

重要: 配置完成后需要完全重启 IDE。

3.4 配置插件设置 (Windows 用户)

1. 进入 Settings > Other Settings > Codex Launcher
2. Windows 用户必须配置:
   • Terminal Shell: 选择你的终端 Shell (如 PowerShell 或 CMD)
3. 保存设置

3.5 使用 Codex

在 IDE 顶部工具栏右侧,点击 Codex Launcher 图标 (方形图标) 即可启动:

点击后 Codex 会启动并提供 AI 辅助功能。

支持的 GPT 模型:

• gpt-5.2 (推荐)
• gpt-5 (通用模型)

4. 常见问题 (QA)

Claude Code 插件无法启动?

1. 检查 Claude CLI: 运行 claude --version 验证安装
2. 检查配置文件: 确认 settings.json 路径和内容正确
3. 完全重启 IDE: 不是重新加载窗口，而是完全退出并重新启动
4. 多次重启: 有些用户报告需要重启 2-3 次才能生效

Codex Launcher 连接失败?

1. 检查 Codex CLI: 确认已正确安装
2. 检查配置文件: 确认 config.toml 和 auth.json 配置正确
3. Windows 用户: 必须在插件设置中配置正确的 Terminal Shell
4. 重启 IDE: 修改配置后必须重启 IDE

为什么不支持 Gemini?

Google 官方的 Gemini Code Assist 插件不支持配置自定义 API 端点，只能连接 Google Cloud 官方 API，无法用于 NextAI Code。

如需使用 Gemini，推荐使用 VS Code / Cursor / Trae + Roo Code 扩展，配置更简单。

IDE 没有生效?

请确保:

1. 配置文件中的 API Key 和 Base URL 正确
2. 完全退出并重启 IDE (File > Exit)

Node.js 版本不符合要求?

Claude CLI 需要 Node.js 18 或更高版本：

1. 访问 nodejs.org 下载最新 LTS 版本
2. 安装后运行 node --version 验证
3. 重新安装 Claude CLI

额度不足

登录 NextAI Code 控制台 检查余额，必要时充值。

如何选择使用哪个模型?

• Claude Sonnet: 综合能力强，推荐复杂代码任务
• gpt-5.2: 知识面广，适合代码生成
• Haiku: 速度快，适合简单任务