一、推荐方式：浏览器一键授权（新手首选）
全程自动跳转，不用手动复制密钥，是最稳妥的登录方式：
- 打开登录入口：点击 VS Code 左侧边栏的 Codex 图标，打开插件主面板。面板顶部会显示「登录 OpenAI 账号」按钮，点击进入登录流程。
- 跳转浏览器确认：点击登录后，VS Code 会自动唤起系统默认浏览器，跳转到 OpenAI 官方授权页面。如果浏览器没有自动弹出，可复制面板中显示的授权链接，手动粘贴到浏览器打开。
- 完成账号授权：在浏览器页面登录你已开通订阅的 OpenAI 账号，核对授权信息后点击「Allow（允许）」，确认授权 VS Code 访问你的账号权限。
- 返回编辑器生效：授权成功后，浏览器会提示「已完成授权，可返回 VS Code」。切换回 VS Code，插件会自动同步账号信息，面板顶部显示你的账号头像，即登录成功。
小补充：如果浏览器授权后没有自动跳转，页面会生成一串 6 位授权码，复制该授权码，粘贴回 VS Code 的弹窗输入框，也可完成登录。
二、备用方式：API 密钥登录（浏览器授权失败时使用）
如果网络环境导致浏览器授权不成功，可使用 API 密钥直接连接服务。
⚠️ 重要提醒：此方式走 API 按量计费，不消耗 ChatGPT 订阅额度，产生的调用会单独扣费，新手不建议默认使用。
- 提前按照 1.3 节的步骤，在 OpenAI 后台获取你的 API 密钥。
- 打开 VS Code 设置（快捷键：Windows 按
Ctrl + ,，Mac 按Cmd + ,），在搜索框输入Codex。 - 找到「API Key」配置项，将你的
sk-开头的密钥填入对应输入框，保存设置。 - 按下
Ctrl + Shift + P/Cmd + Shift + P调出命令面板，输入「Reload Window」重新加载窗口，插件自动生效。
三、登录状态验证
- 插件侧边栏顶部显示账号头像或邮箱前缀，不再出现登录按钮；
- 新建一个代码文件，输入一行注释描述需求，按
Tab键能触发代码补全，即代表功能正常。
四、实用注意事项
- 权限匹配：必须使用已开通 Plus/Pro/Team 订阅的账号登录，才能使用完整的 Codex 编码功能；免费账号仅支持有限的基础体验，高峰期限速明显。
- 网络稳定：登录全程需保持可正常访问 OpenAI 服务的网络，网络波动容易导致授权失败。
- 公共设备安全：在他人电脑、公共设备上使用时，不要勾选「记住登录状态」，使用完毕后点击账号头像选择「退出登录」。
- 避免频繁切换：不要短时间内频繁切换多个账号登录，容易触发平台风控，导致账号功能受限。