AI Assistant 2026.3 Help

激活智能体

AI Assistant 提供一组集成的智能体(如 Junie、 Claude Agent 和 Codex ),也支持添加外部或自定义 ACP 兼容智能体。

集成智能体可根据具体智能体及配置使用不同的身份验证方法激活。

激活智能体后即可在 AI 聊天中使用。 根据所选 激活方法 ,部分 AI Assistant 功能可能不可用。

集成智能体

可使用以下任一身份验证方法激活集成智能体:

  • JetBrains AI 订阅

  • API 密钥(BYOK)

  • 提供账户(OAuth)

  • 特定提供商方法(如 Anthropic 控制台)

并非每个智能体都支持所有身份验证方法:

代理

JetBrains AI

提供账户(OAuth)

API 密钥(BYOK)

特定提供商

Junie 徽标 Junie

支持

不支持

支持

不支持

Claude Agent

支持

不支持

支持

Anthropic 控制台

Codex

支持

支持

支持

不支持

GitHub Copilot

不支持

支持

不支持

不支持

所选身份验证方法用于请求处理和计费。 可在 设置 | 工具 | AI Assistant | 提供商和API密钥 的 智能体授权 部分查看当前激活的方法。

查看智能体身份验证方法

如需更换身份验证方法,可 撤销当前方法并选择其它选项。 要应用更改,您需要创建一个新的聊天。

使用 JetBrains AI 订阅激活智能体

Junie、Claude Agent 和 Codex 可与 JetBrains AI 订阅配合使用。 要激活这些智能体:

  1. 打开 AI 聊天 工具窗口。

  2. 选择 使用 JetBrains AI 订阅登录。

    选择智能体
  3. 如有需要,请使用 JetBrains Account 完成登录。

  4. 返回 AI 聊天 ,然后选择要使用的智能体。

    如果选择了 Junie,它会自动执行激活,无需执行任何操作 – 智能体即可使用。 如果选择了 Claude Agent 或 Codex,需要发送一条消息来触发激活流程。

  5. 发送消息以触发激活。

  6. 点击 安装并继续 接受服务条款并安装代理程序。

  7. 在 选择身份验证方式 提示中,选择 JetBrains AI 选项。 根据获取 JetBrains AI 访问权限的方式,提示会显示以下选项之一:

    • JetBrains},{ – 使用个人 JetBrains AI 订阅。

    • 组织 – 使用组织提供的 JetBrains AI 访问权限。 如果组织已为您分配 JetBrains AI 许可证并启用了 JetBrains AI,或者组织使用 JetBrains Central 且管理员已授予您 AI 访问权限,则此选项可用。

要验证是否正在使用 JetBrains AI 订阅,请导航到 设置 | 工具 | AI Assistant | 提供商&API 密钥。 当前激活的身份验证方法会显示在 智能体授权 部分。

使用 API 密钥(BYOK)激活智能体

Junie、Claude Agent 和 Codex 支持使用 API 密钥 (BYOK) 激活:

  1. 打开 AI 聊天 工具窗口。

  2. 选择 Junie,由 JetBrains 出品。

    选择智能体

    此操作会打开 AI Chat,并选择 Junie 进行交互。 在列表中选择 Junie 后,它会立即自动启动激活流程。

  3. 在 选择身份验证方式 提示中,选择 API 密钥。

    点击 JetBrains,以使用拥有 JetBrains AI 订阅的 JetBrains 帐户进行授权

    设置页面将打开。

  4. 在 第三方 AI 提供商 部分中,选择 OpenAI 或 Anthropic 作为 提供商。

    AI 助手模型和 API 密钥设置
  5. 请在 API 密钥 字段输入 API 密钥并点击 测试连接 验证连接是否已建立。

  6. 点击 确定 以应用更改。

已配置提供商的模型将在 Junie 模型选择器 中可用。 如果 JetBrains AI 也处于活动状态,列表会包含来自两个来源的模型。

  1. 打开 AI 聊天 工具窗口。

  2. 选择 Claude Agent。

    选择智能体

    此操作会打开 AI 聊天,并选择了 Claude Agent 进行交互。

  3. 发送消息以触发激活。

  4. 点击 安装并继续 接受 服务条款并安装代理程序。

    接受服务条款并安装代理程序

    安装完成后,将提示你选择身份验证方法。

  5. 在提示中选择 API 密钥。

    选择 API 密钥选项

    设置页面将打开。

  6. 在 第三方 AI 提供商 部分,将 Anthropic 选择为 提供商。

    AI 助手模型和 API 密钥设置
  7. 请在 API 密钥 字段输入 API 密钥并点击 测试连接 验证连接是否已建立。

  8. 点击 确定 以应用更改。

  1. 打开 AI 聊天 工具窗口。

  2. 选择 Codex确定码库。

    选择智能体

    此操作会打开 AI 聊天,并选择了 Codex 进行交互。

  3. 发送消息以触发激活。

  4. 点击 安装并继续 接受 服务条款并安装代理程序。

    接受服务条款并安装代理程序

    安装完成后,将提示你选择身份验证方法。

  5. 在提示中选择 API 密钥。

    选择 API 密钥选项

    设置页面将打开。

  6. 在 第三方 AI 提供商 部分,将 OpenAI 选择为 提供商。

    AI 助手模型和 API 密钥设置
  7. 请在 API 密钥 字段输入 API 密钥并点击 测试连接 验证连接是否已建立。

  8. 点击 确定 以应用更改。

完成这些步骤后,即可开始使用代理程序。

要验证是否正在使用第三方提供商 API 密钥,请导航到 设置 | 工具 | AI Assistant | 提供商&API 密钥。 当前激活的身份验证方法会显示在 智能体授权 部分。

使用提供商账户(OAuth)激活智能体

Codex 和 GitHub Copilot 支持通过提供商账户激活:

  1. 打开 AI 聊天 工具窗口。

  2. 选择 Codex确定码库。

    选择智能体

    此操作会打开 AI 聊天,并选择了 Codex 进行交互。

  3. 发送消息以触发激活。

  4. 点击 安装并继续 接受 服务条款并安装代理程序。

    接受服务条款并安装代理程序

    安装完成后,将提示你选择身份验证方法。

  5. 在提示中,根据偏好的登录机制选择 ChatGPT​ 或 ChatGPT(设备代码)。

    选择 ChatGPT 或 ChatGPT(设备代码)选项
  6. 完成授权。

  1. 打开 AI 聊天 工具窗口。

  2. 选择 GitHub Copilot。

    选择智能体

    此操作会打开 AI 聊天,并选择了 GitHub Copilot 进行交互。

  3. 发送消息以触发激活。

  4. 点击 安装并继续 接受服务条款并安装代理程序。

    接受服务条款并安装代理程序

    安装完成后,将提示你选择身份验证方法。

  5. 在提示中选择 使用 GitHub 登录。

    使用 GitHub 登录

    GitHub 登录页面将打开。

  6. 登录您的 GitHub 账户以授权代理。

完成这些步骤后,即可开始使用代理程序。

要验证是否使用了提供商账户,请导航到 设置 | 工具 | AI Assistant | 提供商&API 密钥。 当前激活的身份验证方法会显示在 智能体授权 部分。

使用特定提供商方法激活智能体

部分智能体支持特定提供商激活方法。 例如,Claude Agent 可通过 Anthropic 控制台 激活。

要使用 Anthropic 控制台激活 Claude Agent,请执行以下操作:

  1. 打开 AI 聊天 工具窗口。

  2. 选择 Claude Agent。

    选择智能体

    此操作会打开 AI 聊天,并选择了 Claude Agent 进行交互。

  3. 发送消息以触发激活。

  4. 点击 安装并继续 接受 服务条款并安装代理程序。

    接受服务条款并安装代理程序

    安装完成后,将提示你选择身份验证方法。

  5. 在提示中, Anthropic 控制台。

    选择 Anthropic 控制台选项
  6. 登录您的 Anthropic 账户以授权代理。

完成这些步骤后,即可开始使用代理程序。

要验证是否正在使用 Anthropic 账户,请导航到 设置 | 工具 | AI Assistant | 提供商&API 密钥。 当前激活的身份验证方法会显示在 智能体授权 部分。

添加 ACP 智能体

AI Assistant 支持 代理客户端协议(ACP) ,可让您连接外部 AI 代理。 可安装 ACP 兼容智能体,并在 AI 聊天 中使用,无需 JetBrains AI 服务订阅。

  1. 打开 AI 聊天 工具窗口。

  2. 点击 更多智能体。

    添加 ACP 代理
  3. 在 代理 页面,选择要安装的代理并点击 安装。

    代理设置页面

    安装过程中,IDE 会自动:

    • 下载所需的代理文件。

    • 根据需要下载并管理 Node.js 或 Python 运行环境。 若已存在兼容的运行环境,IDE 将自动复用。

    • 为代理做好使用准备。

  4. 如果希望代理程序访问来自 已配置的 MCP 服务器或 捆绑 MCP 服务器的工具,请配置 传递自定义 MCP 服务器 和 传递 IntelliJ MCP 服务器 设置

  5. 点击 确定 以应用更改。

因此,被选中的代理会被安装并可用于 AI 聊天。 要使用该代理程序,请发送消息以触发激活,并在需要时完成身份验证。

或者,您也可以手动添加自定义 ACP 兼容代理:

  1. 打开 AI 聊天 工具窗口。

  2. 在 AI 聊天 工具窗口右上角点击 按钮,选择 添加自定义代理人或代理程序 (Agent)。

    添加自定义代理
  3. 在 acp.json 文件中,填写代理配置详细信息。

自定义智能体即会出现在 AI 聊天中。

撤销智能体授权

如需使用其他身份验证方法或退出提供商账户,需撤销智能体授权。 为此:

  1. 请导航至 设置 | 工具 | AI Assistant | 提供商&API 密钥。

  2. 在 智能体授权 部分,点击 撤销 以撤销该代理程序的授权。

    撤销授权
  3. 点击 确定。

或者,可以直接在 AI Chat 中重置身份验证:

  1. 在聊天中,导航到对话的最开头。

  2. 将鼠标悬停在 已配置的身份验证 项上,然后点击 重置。

    位于对话开头的“已配置的身份验证”项中的“重置”按钮
  3. 点击 新建聊天 按钮或按 Alt+Insert 开始新的聊天。

  4. 选择要使用的身份验证方法。

在再次重置身份验证之前,智能体会一直使用所选方法。

2026年 11月 6日