一、codex login --device-auth 是什么？

codex login --device-auth 是 Codex CLI 的设备码登录方式，专门用于在无法弹出浏览器、端口被占用、服务器环境、WSL、无桌面环境等场景下安全登录 OpenAI 账号。

它的工作流程非常简单：

1. 终端生成一个配对码和一个登录网址

2. 你在任意浏览器打开网址，登录 OpenAI

3. 输入配对码完成授权

4. 终端自动获取并保存 Token，登录完成

这种方式不依赖本地端口，兼容性更强，也更安全。

二、配对后重启电脑，还需要重新配对吗？

不需要。

登录成功后，Codex 会把 Token 保存在本地配置文件中：

• Linux/macOS：~/.codex/auth.json

• Windows：%USERPROFILE%\.codex\auth.json

只要不删除文件、不主动登出、Token 不过期，重启电脑、重启终端都不需要重新登录。

三、--device-auth 和普通 codex login 的区别
方式 原理 适用场景 稳定性 
codex login 自动打开浏览器 + 端口回调 本地桌面环境 容易被防火墙/VPN/WSL 拦截 
codex login --device-auth 设备码授权 服务器、无桌面、端口被占用 稳定、兼容性强 

一句话总结：
普通登录方便，设备码登录更稳。

四、常用命令

登录（设备码方式）
codex login --device-auth
登出（清除 Token）
codex logout
查看登录状态
codex status