主要分为两个部分：
- 安装 AI Assistant：解决插件无法启用、远程 IDE 版本不一致等问题。
- 激活 Codex：用户地区调整、使用 ChatGPT 账号登录 Codex，验证 AI 模型调用是否正常。
一、安装AI Assistant
1.1 安装 JetBrains AI Assistant
- 在 PyCharm 中打开：
Settings → Plugins → Marketplace搜索：JetBrains AI Assistant - 选择 JetBrains 官方发布的插件，点击
Install（安装），安装完成后按提示重启 IDE。 - 安装完成后，通常可以通过右侧工具栏的 AI Assistant 图标打开 AI 聊天界面。
注意：PyCharm Pro 许可证与 AI 服务的使用额度并不完全等同。Codex 可以根据集成方式选择 ChatGPT 账号、JetBrains 授权或 API Key。
1.2 AI 插件下载报错解决
安装并启用 AI Assistant 后，AI 功能无法正常使用，界面出现JetBrains AI: URL 解析失败，访问https://api.jetbrains.ai/ping时返回 HTTP 451。
解决方案：
- 打开 PyCharm，进入
Help → Check for Updates，将 IDE 更新到适用的较新版本。 - 更新完成后重启 PyCharm。
- 进入
Settings → Plugins → Installed，找到AI Assistant。 - 更新 AI Assistant 至与当前 PyCharm 版本兼容的版本。
- 再次重启 IDE，打开 AI Chat。
1.3 远程开发中的插件安装问题
在 SSH 远程开发模式下，插件管理器会区分：
| 插件位置 | 对应环境 |
|---|---|
| 主机（Host） | Linux 服务器上的 IDE Backend |
| 客户端（Client） | Windows 上的 JetBrains Client |
在前面将本地 PyCharm 已升级至 2026，但打开以前的 SSH 远程项目后，实际使用的 Backend 仍为 2025.1，AI Assistant 安装异常。
解决方案：
- 关闭当前远程项目，返回 Remote Development。
- 找到已有的 SSH 远程项目。
- 通过项目菜单切换远程 IDE Backend 版本。
- 选择 PyCharm 2026.x。
- 重新连接服务器上的原项目目录。
二、激活 Codex
2.1 地区修改
AI Assistant 插件安装完成后，Codex 未能直接进入后续登录流程。这是因为JetBrains AI 不直接面向中国大陆提供codex服务，我们手动切换地区即可。
操作步骤：
- 打开 PyCharm 的
Settings（设置）。 - 找到
Language & Region（语言与地区）。 - 将
Region（地区）调整为Americas（美洲）。 - 点击
Apply / OK保存。 - 如 IDE 提示需要重启，按提示重启 PyCharm。
- 重新打开 AI Assistant，检查 Codex 是否可以进入身份验证界面。
2.2 在 AI Assistant 中激活 Codex
- 打开 PyCharm 右侧的 AI Chat，选择
Codex，发送一条测试消息。
首次使用时，可能需要接受服务条款并安装 Codex Agent。
- 选择身份验证方式
| 方式 | 说明 |
|---|---|
| JetBrains | 使用 JetBrains AI 授权 |
| API 密钥 | 使用 OpenAI API Key，独立计费 |
| ChatGPT | 通过浏览器登录 ChatGPT 账号 |
| ChatGPT (device code) | 通过设备授权码登录 |
| Skip (use CLI auth) | 使用已配置的 Codex CLI 身份验证 |
如果能够直接选择ChatGPT，通过浏览器完成 OAuth 授权即可。
2.3 验证 Codex 是否激活成功
在 AI Chat 中新建聊天，发送：
你好，请只回复 OK如果返回OK，说明 Codex 已能够正常进行模型调用。
需要区分两个状态：
- 登录成功：说明账号授权完成。
- 模型正常回复：说明认证、网络通信和模型调用基本正常。
只有完成第二项测试，才算验证了 Codex 的实际可用性。
参考文档：
PyCharm 接入 Codex 的全面指南_pycharm codex-CSDN博客
PyCharm 中安装并使用 Codex：实战指南_pycharm codex-CSDN博客
中国大陆用户如何使用Jetbrains内置的AI插件AI Assistant_jetbrains ai-CSDN博客
