注册
ChatGPTCodex

Codex 报错 401 Unauthorized 怎么办：登录状态、API 密钥、自定义模型提供方与 WSL 登录缓存的排查

Codex 提示 401 Unauthorized，字面意思是服务端不认你的登录凭据。官方没有单独解释这条报错，但认证文档写清了登录方式、缓存位置、API 密钥和自定义提供方的用法。本文按官方文档给出从 codex login status 开始的排查顺序。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-10-27 · 依据官方文档与公开资料整理 Plus 账号
本文根据 Codex 官方文档《Authentication》、配置参考、环境变量文档和 Windows 应用文档整理，资料核对于 2026-10-27。官方没有专门解释 401 这条报错。401 是通用的 HTTP 状态码，字面意思是「未授权」，一般指服务端没收到有效的登录凭据。本文列的是官方文档里与登录凭据有关的做法。配图为本站整理的示意图，不是软件截图。

适用于谁

  • 在 Codex 里发消息或启动时看到 401 Unauthorized、unexpected status 401 Unauthorized 的人；
  • 之前能用，某天开始就报 401 的人；
  • 在 Windows 和 WSL 两边都装了 Codex，一边正常一边报错的人；
  • 自己配置了第三方或公司网关作为模型提供方的人。

结论先说

  1. 先确认现在登录的是什么。 命令行运行 codex login status，官方说它会显示当前的认证方式。桌面 App 和 IDE 插件在个人资料菜单里能看到当前账号或 API 密钥状态。
  2. 重新登录一次。 codex logout 清除当前凭据，再 codex login 在浏览器里完成登录。桌面 App 选 Log out，再重新登录。
  3. 用 API 密钥的人，密钥要从 OpenAI 平台的 API 密钥页面获取，并用官方给的写法传入，见下文。
  4. Windows 和 WSL 两边都装了，要知道两边的登录缓存默认不共享。
  5. 自己配了模型提供方的人，401 多半出在 env_key 或认证方式的配置上。
  6. 都不行，看官方状态页，并收集 codex-login.log 反馈。

Codex 401：先对照这张表

图：本站根据 Codex 官方文档：Authentication 整理的示意图

报错原文怎么读

text
unexpected status 401 Unauthorized

意思是服务端对 Codex 发出的请求回了 401，也就是不接受请求里带的凭据。凭据可能是你的 ChatGPT 登录令牌，也可能是 API 密钥，或者你自己配置的第三方服务的密钥。所以第一步永远是弄清楚 Codex 用的是哪一种凭据。 GitHub 的 openai/codex 问题列表里有不少以 401 为题的反馈，说明不少人遇到过，但官方文档没有逐条解释。

一、确认登录方式，然后重新登录

官方认证文档说，Codex 在使用 OpenAI 模型时支持两种登录方式：用 ChatGPT 账号登录（走订阅），或用 API 密钥登录（按用量计费）。桌面 App、命令行和 IDE 插件都支持这两种；Codex 云端只能用 ChatGPT 登录。

重新登录 Codex 的 3 步

图：本站根据 Codex 官方文档：Authentication 整理的示意图

各入口的官方写法：

入口查看当前状态登出ChatGPT 登录
命令行codex login statuscodex logoutcodex login
桌面 App个人资料菜单Log out登录页点 Continue to sign in
IDE 插件个人资料菜单Log out登录页点 Sign in with ChatGPT

官方还写明：登录信息会被缓存并复用，命令行和插件共用同一份；在其中一个里登出，下次启动命令行或插件就需要重新登录。ChatGPT 登录的令牌，Codex 在使用中会在到期前自动刷新，正常情况下不需要反复登录。缓存位置是 ~/.codex/auth.json 或系统的凭据库，具体由 cli_auth_credentials_store 决定。auth.json 里是访问令牌，要当成密码保管，不要提交、不要贴进聊天。

二、用 API 密钥登录时

官方写法（命令行）：从标准输入把密钥交给登录命令。

shell
printenv OPENAI_API_KEY | codex login --with-api-key

桌面 App 在未登录界面选 Sign in another way，输入密钥后点 Continue；IDE 插件选 Use API Key，输入后点 OK。API 密钥到 OpenAI 平台的 API 密钥页面获取。官方提醒：API 密钥登录按标准 API 价格计费，不使用 ChatGPT 套餐里包含的额度，依赖 ChatGPT 工作区或云服务的功能会受限。密钥失效、被删除或没有可用的账户余额，都属于要到 OpenAI 平台账户页面去检查的范围，不在 Codex 文档的讨论里。

非交互场景里，官方环境变量文档列了 CODEX_API_KEY（给 codex exec 等非交互进程提供 API 密钥）和 CODEX_ACCESS_TOKEN（给受信任的自动化提供访问令牌，要持久登录就用 codex login --with-access-token）。

三、Windows 和 WSL 两边的登录缓存不共享

官方 Windows 应用文档写明：Windows 桌面 App 使用和原生 Windows 版 Codex 相同的主目录 %USERPROFILE%\.codex；如果同时在 WSL 里运行命令行，命令行默认用 Linux 的主目录，不会自动共享配置、登录缓存和会话历史。想共享，有两个办法：同步两个 .codex 目录，或在 WSL 里设置 CODEX_HOME：

bash
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

写进 ~/.bashrc 或 ~/.zshrc 就能对每个终端生效。如果 WSL 里报 401，而 Windows 上正常，先在 WSL 里单独登录一次，或者用上面的办法让两边指向同一目录。

四、自己配置了模型提供方

在 config.toml 里定义自定义模型提供方后，官方认证文档列了几种认证方式：

  • requires_openai_auth = true：使用 OpenAI 的认证，之后可以用 ChatGPT 或 API 密钥登录，适用于经过 LLM 代理访问 OpenAI 模型；
  • env_key = "环境变量名"：从本机名为该变量的环境变量里读取该提供方的 API 密钥；
  • 两者都不设置：Codex 认为该提供方不需要认证，适合本地模型。

官方配置参考还说明：auth 命令式认证不要与 env_key、experimental_bearer_token 或 requires_openai_auth 混用；直接把令牌写进 experimental_bearer_token 是不推荐的，应使用 env_key。出 401 时，先确认 env_key 指向的环境变量在启动 Codex 的那个终端里确实已设置、值是该服务的有效密钥，再确认没有同时配置多种认证。第三方模型怎么配，见 /guides/codex-third-party-models-deepseek-gemini-grok 和 /guides/deepseek-codex-setup。

五、管理员限制登录方式或工作区

官方认证文档「Enforce a login method or workspace」一节：在受管环境里，管理员可以用 forced_login_method 规定只能用 ChatGPT 登录或只能用 API 密钥登录，用 forced_chatgpt_workspace_id 限定工作区。如果当前凭据与这些限制不符，Codex 会让用户登出并退出。 遇到这种情况，要换成符合要求的登录方式，具体问管理员。

六、仍然不行

常见问题

Q：是不是我的 Plus 过期了？

订阅状态在 ChatGPT 账号设置里看，套餐区别见 /guides/chatgpt-plans-comparison。官方文档没有把 401 和订阅到期联系在一起。想重新开通可以看 /chongzhi/chatgpt-plus。

Q：重新登录后马上又 401？

先 codex login status 看实际生效的认证方式，再检查是否有环境变量或配置在覆盖登录，例如自定义提供方的 env_key、被管理员强制的登录方式。

Q：登出会丢对话吗？

官方认证文档只说登出会清除当前凭据，没有说会清除会话记录；会话记录保存在 $CODEX_HOME/sessions，默认 ~/.codex/sessions。

参考资料

  • Codex 官方文档：Authentication — https://learn.chatgpt.com/docs/auth
  • Codex 官方文档：Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
  • Codex 官方文档：Environment variables — https://learn.chatgpt.com/docs/config-file/environment-variables
  • Codex 官方文档：ChatGPT desktop app for Windows — https://learn.chatgpt.com/docs/windows/windows-app
  • OpenAI 状态页 — https://status.openai.com/
需要开通或续费？ChatGPT Plus 充值 →

Nathaniel 的更多内容

  1. 01

    Claude 登录报错对照（账号被停用以外）：There was an error logging you in、收不到登录邮件、验证码、Google 登录的处理

    Claude 登录不上，除了账号被停用，还有登录出错、收不到登录邮件、在另一台设备点链接、想设密码、Google 登录异常等情况。本文按官方登录帮助整理各提示的原文和处理，账号被停用另见专门文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎么办：限额、消息过长、容量紧张、登录出错的官方报错对照

    Claude 报 Something went wrong 或别的错误？官方《Troubleshoot Claude error messages》把常见错误分成限额、消息过长、登录出错、容量紧张四类，并给了各自的原文和处理。本文逐项整理，并说明官方没有单独解释笼统的出错提示。

    Claude0
  3. 03

    DeepSeek 除了「服务器繁忙」还有哪些报错：网页版提示对照和 API 错误码 400、401、402、422、429、500、503

    DeepSeek 报错不只有服务器繁忙。本文把官方常见问题里的网页版提示（上传失败、运行环境异常、账号停用、邮箱域名不支持）和 API 错误码汇成对照表，给出官方的原因和处理，并链到各篇详细文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此账号无法使用」（Can't access this service）怎么办：账号类型、年龄、Family Link 与工作学校账号的官方条件

    Gemini 提示 Can't access this service，意思是这个账号目前不符合使用条件。官方写明了可用的账号类型、年龄要求和 Family Link 账号不能用。本文按账号类型对照，并给出 Something went wrong 的处理。

    Gemini0
  5. 05

    Gemini Pro 免费试用、学生优惠到期后怎么办：自动转付费、重新验证 SheerID、取消后会失去什么

    Google AI Pro 学生优惠或试用到期后会怎样？官方说会自动转为正常付费的 Plus 或 Pro，会提前通知；没有按时重新验证 SheerID 会失去优惠。本文按官方帮助中心整理到期规则、取消后失去的内容和第三方订阅的处理。

    Gemini0
  6. 06

    Gemini 怎么切换模型：Flash-Lite、Flash、Pro、Argon 的选择步骤、思考等级和自动选择

    Gemini 网页版怎么手动切换模型？官方步骤是点聊天框底部当前模型再选，需要有 Google AI 方案，带锁图标的要升级。本文按官方说明整理各方案可选模型、思考等级默认值和自动模型选择。

    Gemini0

同产品的其他教程

  1. 01

    Codex 常见报错总表：429、401、登录失败、连接中断、缺少环境变量、沙箱、Computer Use、远程控制，看到哪条读哪篇

    把 Codex 最常见的报错和问题汇成一张对照表：429、401、Token exchange failed、stream disconnected、missing environment variable、Windows 沙箱失败、Computer Use 找不到、远程控制连不上，各给一句处理方向并链到详细文章。

    ChatGPTCodex0
  2. 02

    Codex 插件在哪装：桌面 App 的 Plugins 标签、CLI 的 /plugins、IDE 为什么没有，以及插件和技能、MCP 的区别

    Codex 的插件在 ChatGPT 桌面 App 的 Plugins 标签里装，命令行输入 /plugins，IDE 插件不支持。本文按官方文档讲各入口怎么装、装完怎么用、用 API 密钥登录时有什么限制，以及插件、技能、MCP 服务器的区别。

    ChatGPTCodex0
  3. 03

    Codex Windows 版怎么下载安装：ChatGPT 桌面 App 官方入口、winget 命令、开发工具与 WSL 设置

    Windows 上的 Codex 现在是 ChatGPT 桌面 App 里的一个入口。官方给了微软商店下载地址和 winget 安装命令，原生用 PowerShell 加 Windows 沙箱，也可切到 WSL2。本文按官方文档讲安装、登录、建议装的开发工具、管理员运行和常见小问题。

    ChatGPTCodex0
  4. 04

    Codex 远程控制授权失败怎么办、远程 SSH 怎么用：手机配对电脑、Remote Control、连接 SSH 主机的官方步骤

    用手机远程控制电脑上的 Codex，配对不成功或授权失败？官方 Remote connections 文档写了配对步骤和五类常见问题，也讲了怎么把桌面 App 连到 SSH 主机、怎么在主机之间交接对话。本文按官方文档整理，并给出一张排查对照图。

    ChatGPTCodex0
  5. 05

    Codex 沙箱初始化失败怎么办（Windows）：沙箱设置失败、错误 1385、Everyone 可写警告与 MXC、elevated、unelevated 怎么选

    Windows 上 Codex 沙箱设置失败、命令跑不起来、提示错误 1385 或 Everyone 可写？官方文档列了常见原因和处理，本文逐项整理，并说明 mxc、elevated、unelevated 三种实现的区别。

    ChatGPTCodex0
  6. 06

    Codex 找不到 Computer Use 怎么办：插件在哪装、地区限制、macOS 权限与 Windows 前台运行说明

    ChatGPT 桌面 App 的 Computer Use 能让 Codex 看屏幕、点鼠标、操作桌面应用，但官方写明它只在支持的地区可用，需要装 Computer Use 插件并开启开关。本文按官方文档讲插件在哪装、macOS 要给哪两个权限、Windows 为什么会占用前台，以及找不到时的排查。

    ChatGPTCodex0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～