1. Codex 登录失败 os error 10013 到底卡在哪Codex 在 Windows 上登录时报failed to start login server后面跟着以一种访问权限不允许的方式做了一个访问套接字的尝试。(os error 10013)这个报错本质不是账号问题也不是网络问题而是 Codex 想在本地起一个登录回调服务绑定某个端口时被系统拒绝了。os error 10013 在 Windows 上对应的是WSAEACCES翻译成人话就是这个端口要么已经被别的进程占了要么被系统保留、被安全策略拦住了你的程序没权限去监听它。Codex 登录默认走的是本地1455端口它会在这个端口上起一个临时 HTTP 服务用来接收登录完成后的回调。只要这个端口起不来登录流程就直接断在第一步界面只会给你一句failed to start login server不会告诉你具体是谁占了端口。所以排查思路很明确先确认 1455 到底被谁占了再决定是结束进程、换端口还是把登录通道收敛到统一的 Key/API 通道上避免每次都跟本地端口较劲。这篇面向的是在 Windows 上用 Codex 的开发者尤其是那种「昨天还能登录今天突然 10013」的情况。我会先带你用命令定位端口占用再给出可复制的config.toml和settings.json骨架最后用 TaoToken 的统一 Key 把登录配置收敛掉让 Codex 不再依赖那个脆弱的本地登录服务。整套流程我自己在 Windows 11 PowerShell 上跑过命令都可以直接抄。需要先说明一点os error 10013 有两种成因一种是端口被普通进程占用另一种是端口落在 Windows 的排除端口范围excluded port range里后者是系统保留的普通用户进程根本绑不上。这两种情况的处理方式不一样所以第一步的检测必须做扎实不能上来就taskkill。2. 前置准备TaoToken 统一 Key 与 API 通道在动手排障之前先把 TaoToken 这一侧的准备工作做完这样后面配置config.toml时可以直接填。TaoToken 的作用是把模型访问收敛到一个统一的 Key 和 API 地址上Codex 这类工具只要指向这个通道就不用再依赖它自带的登录服务器去换凭证从根上绕开本地端口冲突。你需要拿到两样东西一个是 API Key一个是 API 基地址。API 基地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填进配置即可。API Key 在控制台的 API Keys 页面创建建议单独给 Codex 建一个 Key方便后面按工具维度做额度管理和吊销。创建 Key 的入口在这里控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面验证一下 Key 是否可用确认通道通了再往 Codex 里配模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite对于长期在 Codex 里做编码、跑 Agent 任务的场景用 Coding Plan 会更省心额度模型和按量计费不一样适合高频调用Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入文档建议开着配置字段的准确写法以文档为准接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite官网首页在这里需要看整体能力再决定官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content把 Key 复制到剪贴板或者一个临时文本里下一步配置会用到。这里提醒一句Key 不要提交到 Git 仓库也不要用截图发群里后面我会给出用环境变量引用的写法。3. 可复制配置先定位端口再写 config.toml 与 settings.json3.1 定位 1455 端口占用以管理员身份打开 PowerShell这一步很重要非管理员权限下netstat能看到连接但taskkill会失败。先查 1455netstat -ano | findstr :1455典型输出长这样TCP 0.0.0.0:1455 0.0.0.0:0 LISTENING 5140最后一列5140就是占用进程的 PID。拿到 PID 后查进程名tasklist /fi PID eq 5140输出里会显示映像名称比如svchost.exe、node.exe、Code.exe。如果是node.exe、Code.exe、chrome.exe这类普通用户进程基本可以直接结束taskkill /PID 5140 /F但如果是svchost.exe千万别直接杀它托管着系统服务。先查它托管了哪个服务tasklist /svc /fi PID eq 5140输出会给出服务名比如iphlpsvc。这时候要判断这个服务能不能停。iphlpsvc是 IP Helper负责 IPv6 隧道相关很多机器上停掉不影响日常使用但如果你不确定就不要动它改用下面的换端口方案。3.2 检查端口是否落在系统保留范围如果netstat查不到任何进程占用 1455但 Codex 依然报 10013那大概率是端口被 Windows 保留了。查保留范围netsh int ipv4 show excludedportrange protocoltcp输出会列出若干起止端口段。如果 1455 落在某个段里比如1400 1500那这个端口就是系统保留的普通进程绑不上。解决办法有两个一是换一个不在保留段里的端口给 Codex 用二是用管理员权限把这段保留范围调整掉不推荐可能影响 Hyper-V 和 WSL。更稳的做法是换端口。3.3 Codex 的 config.toml 骨架Codex 的配置文件在用户目录下的.codex/config.tomlWindows 上一般是C:\Users\你的用户名\.codex\config.toml。把模型通道指向 TaoToken同时把登录相关配置收敛掉# ~/.codex/config.toml model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat # 登录服务端口避开被占用或被保留的 1455 [login] port 1465这里有两个关键点。第一base_url填https://taotoken.net/api不要带尾斜杠也不要加 UTM 参数API 地址就是纯地址。第二env_key指定从环境变量读 Key而不是把 Key 明文写进文件这样配置文件可以安全地放进版本控制或同步盘。[login]段的port改成 1465是为了绕开 1455 的占用或保留。你可以先用netstat -ano | findstr :1465确认这个端口是空的再填进去。3.4 settings.json 骨架如果你用的是 VS Code 里的 Codex 扩展或者有别的工具读settings.json可以加一段统一配置。位置在C:\Users\你的用户名\AppData\Roaming\Code\User\settings.json{ codex.apiBaseUrl: https://taotoken.net/api, codex.apiKeyEnv: TAOTOKEN_API_KEY, codex.loginPort: 1465, codex.telemetry: false }codex.apiKeyEnv同样指向环境变量名不写明文。codex.loginPort和config.toml里的端口保持一致避免两个工具抢同一个端口。3.5 设置环境变量在 PowerShell 里临时设置当前会话有效$env:TAOTOKEN_API_KEY 你的Key永久设置写入用户环境变量重开终端生效[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key, User)设置完可以用echo $env:TAOTOKEN_API_KEY确认读得到。注意别把 Key 写进config.toml或settings.json的明文字段一旦文件被同步或提交Key 就泄露了。4. 验证请求确认登录成功与通道可用配置写完后先别急着开 Codex 图形界面用命令行验证通道是否通。最直接的方式是发一个最小请求到 TaoToken 的 APIcurl.exe https://taotoken.net/api/v1/models -H Authorization: Bearer $env:TAOTOKEN_API_KEY如果返回模型列表的 JSON说明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整、环境变量是否在当前会话生效。如果返回连接超时检查本机网络和代理设置注意不要用任何非正规的网络工具。通道验证通过后启动 Codex。这时候观察两件事一是登录流程是否还报failed to start login server二是netstat -ano | findstr :1465是否能看到 Codex 在监听新端口。如果登录界面正常走完说明端口冲突已经绕开。再验证一次端口释放情况确认没有残留netstat -ano | findstr :1465登录完成后这个端口应该被释放如果还挂着 LISTENING说明 Codex 进程没正常退出登录服务可以手动结束对应 PID。最后在 Codex 里跑一个真实的小任务比如让它读一个本地文件并总结确认模型调用走的是 TaoToken 通道。如果任务能正常返回说明config.toml里的model_provider和base_url都生效了。5. 本篇常见错排查5.1 改了端口还是报 10013说明新端口也被占了或被保留。用netstat -ano | findstr :1465和netsh int ipv4 show excludedportrange protocoltcp两条命令交叉确认。如果落在保留段换到 15000 以上的高位端口比如 15873高位端口被保留的概率低很多。5.2 taskkill 提示拒绝访问九成是没用管理员权限开 PowerShell。关掉当前窗口右键「以管理员身份运行」再执行。如果已经是管理员还拒绝说明目标进程是受保护的系统进程不要强杀直接换端口。5.3 停了 iphlpsvc 之后网络异常iphlpsvc停掉可能影响 IPv6 和某些隧道功能。如果停完后发现网络不对劲用sc config iphlpsvc start auto恢复自启再sc start iphlpsvc启动然后改用换端口方案别跟系统服务较劲。5.4 环境变量读不到PowerShell 里用$env:TAOTOKEN_API_KEYcmd 里用%TAOTOKEN_API_KEY%两个语法不一样。另外用SetEnvironmentVariable写入的变量已经打开的终端读不到必须新开一个终端。Codex 如果是从图形界面启动的可能继承的是启动时的环境改完变量后要重启 Codex。5.5 配置改了但 Codex 没生效Codex 可能缓存了旧配置。确认config.toml路径正确Windows 上注意.codex目录是不是在C:\Users\你的用户名\下而不是在项目目录里。改完配置后完全退出 Codex 再启动不要只关窗口。5.6 返回 401 或 403Key 无效或没有对应模型的权限。去控制台确认 Key 状态必要时重新创建一个。注意base_url不要写成带/v1的完整路径TaoToken 的基地址就是https://taotoken.net/api路径拼接由客户端处理。6. 把登录配置收敛到统一通道端口占用和套接字权限这类问题本质是 Codex 自带的登录服务器太依赖本地环境。每次换机器、换网络、装个新软件都可能把 1455 或你换的端口占掉然后又是一轮 10013。与其反复排障不如把登录和模型访问都收敛到 TaoToken 的统一 Key 上Codex 只负责发请求不再自己起登录服务。如果你只是偶尔用 Codex按上面的config.toml配好 Key 和端口就够了。如果你每天都在 Codex 里跑编码任务、挂 Agent建议直接上 Coding Plan额度模型更适合高频场景也省得每次登录都提心吊胆Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteKey 管理和轮换在控制台做建议给 Codex 单独建 Key出问题直接吊销不影响其他工具API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite配置字段拿不准的时候以接入文档为准文档里的字段名和示例是最新的接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后留一个我踩过的坑换端口之后记得把config.toml和settings.json里的端口改成一致我有一次只改了 toml结果 VS Code 扩展还在用旧端口登录照样失败查了半天才发现是两个文件不同步。 Codex 登录失败 os error 10013：用 TaoToken 统一 Key 排查端口占用与套接字权限
1. Codex 登录失败 os error 10013 到底卡在哪Codex 在 Windows 上登录时报failed to start login server后面跟着以一种访问权限不允许的方式做了一个访问套接字的尝试。(os error 10013)这个报错本质不是账号问题也不是网络问题而是 Codex 想在本地起一个登录回调服务绑定某个端口时被系统拒绝了。os error 10013 在 Windows 上对应的是WSAEACCES翻译成人话就是这个端口要么已经被别的进程占了要么被系统保留、被安全策略拦住了你的程序没权限去监听它。Codex 登录默认走的是本地1455端口它会在这个端口上起一个临时 HTTP 服务用来接收登录完成后的回调。只要这个端口起不来登录流程就直接断在第一步界面只会给你一句failed to start login server不会告诉你具体是谁占了端口。所以排查思路很明确先确认 1455 到底被谁占了再决定是结束进程、换端口还是把登录通道收敛到统一的 Key/API 通道上避免每次都跟本地端口较劲。这篇面向的是在 Windows 上用 Codex 的开发者尤其是那种「昨天还能登录今天突然 10013」的情况。我会先带你用命令定位端口占用再给出可复制的config.toml和settings.json骨架最后用 TaoToken 的统一 Key 把登录配置收敛掉让 Codex 不再依赖那个脆弱的本地登录服务。整套流程我自己在 Windows 11 PowerShell 上跑过命令都可以直接抄。需要先说明一点os error 10013 有两种成因一种是端口被普通进程占用另一种是端口落在 Windows 的排除端口范围excluded port range里后者是系统保留的普通用户进程根本绑不上。这两种情况的处理方式不一样所以第一步的检测必须做扎实不能上来就taskkill。2. 前置准备TaoToken 统一 Key 与 API 通道在动手排障之前先把 TaoToken 这一侧的准备工作做完这样后面配置config.toml时可以直接填。TaoToken 的作用是把模型访问收敛到一个统一的 Key 和 API 地址上Codex 这类工具只要指向这个通道就不用再依赖它自带的登录服务器去换凭证从根上绕开本地端口冲突。你需要拿到两样东西一个是 API Key一个是 API 基地址。API 基地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填进配置即可。API Key 在控制台的 API Keys 页面创建建议单独给 Codex 建一个 Key方便后面按工具维度做额度管理和吊销。创建 Key 的入口在这里控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面验证一下 Key 是否可用确认通道通了再往 Codex 里配模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite对于长期在 Codex 里做编码、跑 Agent 任务的场景用 Coding Plan 会更省心额度模型和按量计费不一样适合高频调用Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入文档建议开着配置字段的准确写法以文档为准接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite官网首页在这里需要看整体能力再决定官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content把 Key 复制到剪贴板或者一个临时文本里下一步配置会用到。这里提醒一句Key 不要提交到 Git 仓库也不要用截图发群里后面我会给出用环境变量引用的写法。3. 可复制配置先定位端口再写 config.toml 与 settings.json3.1 定位 1455 端口占用以管理员身份打开 PowerShell这一步很重要非管理员权限下netstat能看到连接但taskkill会失败。先查 1455netstat -ano | findstr :1455典型输出长这样TCP 0.0.0.0:1455 0.0.0.0:0 LISTENING 5140最后一列5140就是占用进程的 PID。拿到 PID 后查进程名tasklist /fi PID eq 5140输出里会显示映像名称比如svchost.exe、node.exe、Code.exe。如果是node.exe、Code.exe、chrome.exe这类普通用户进程基本可以直接结束taskkill /PID 5140 /F但如果是svchost.exe千万别直接杀它托管着系统服务。先查它托管了哪个服务tasklist /svc /fi PID eq 5140输出会给出服务名比如iphlpsvc。这时候要判断这个服务能不能停。iphlpsvc是 IP Helper负责 IPv6 隧道相关很多机器上停掉不影响日常使用但如果你不确定就不要动它改用下面的换端口方案。3.2 检查端口是否落在系统保留范围如果netstat查不到任何进程占用 1455但 Codex 依然报 10013那大概率是端口被 Windows 保留了。查保留范围netsh int ipv4 show excludedportrange protocoltcp输出会列出若干起止端口段。如果 1455 落在某个段里比如1400 1500那这个端口就是系统保留的普通进程绑不上。解决办法有两个一是换一个不在保留段里的端口给 Codex 用二是用管理员权限把这段保留范围调整掉不推荐可能影响 Hyper-V 和 WSL。更稳的做法是换端口。3.3 Codex 的 config.toml 骨架Codex 的配置文件在用户目录下的.codex/config.tomlWindows 上一般是C:\Users\你的用户名\.codex\config.toml。把模型通道指向 TaoToken同时把登录相关配置收敛掉# ~/.codex/config.toml model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat # 登录服务端口避开被占用或被保留的 1455 [login] port 1465这里有两个关键点。第一base_url填https://taotoken.net/api不要带尾斜杠也不要加 UTM 参数API 地址就是纯地址。第二env_key指定从环境变量读 Key而不是把 Key 明文写进文件这样配置文件可以安全地放进版本控制或同步盘。[login]段的port改成 1465是为了绕开 1455 的占用或保留。你可以先用netstat -ano | findstr :1465确认这个端口是空的再填进去。3.4 settings.json 骨架如果你用的是 VS Code 里的 Codex 扩展或者有别的工具读settings.json可以加一段统一配置。位置在C:\Users\你的用户名\AppData\Roaming\Code\User\settings.json{ codex.apiBaseUrl: https://taotoken.net/api, codex.apiKeyEnv: TAOTOKEN_API_KEY, codex.loginPort: 1465, codex.telemetry: false }codex.apiKeyEnv同样指向环境变量名不写明文。codex.loginPort和config.toml里的端口保持一致避免两个工具抢同一个端口。3.5 设置环境变量在 PowerShell 里临时设置当前会话有效$env:TAOTOKEN_API_KEY 你的Key永久设置写入用户环境变量重开终端生效[Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, 你的Key, User)设置完可以用echo $env:TAOTOKEN_API_KEY确认读得到。注意别把 Key 写进config.toml或settings.json的明文字段一旦文件被同步或提交Key 就泄露了。4. 验证请求确认登录成功与通道可用配置写完后先别急着开 Codex 图形界面用命令行验证通道是否通。最直接的方式是发一个最小请求到 TaoToken 的 APIcurl.exe https://taotoken.net/api/v1/models -H Authorization: Bearer $env:TAOTOKEN_API_KEY如果返回模型列表的 JSON说明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整、环境变量是否在当前会话生效。如果返回连接超时检查本机网络和代理设置注意不要用任何非正规的网络工具。通道验证通过后启动 Codex。这时候观察两件事一是登录流程是否还报failed to start login server二是netstat -ano | findstr :1465是否能看到 Codex 在监听新端口。如果登录界面正常走完说明端口冲突已经绕开。再验证一次端口释放情况确认没有残留netstat -ano | findstr :1465登录完成后这个端口应该被释放如果还挂着 LISTENING说明 Codex 进程没正常退出登录服务可以手动结束对应 PID。最后在 Codex 里跑一个真实的小任务比如让它读一个本地文件并总结确认模型调用走的是 TaoToken 通道。如果任务能正常返回说明config.toml里的model_provider和base_url都生效了。5. 本篇常见错排查5.1 改了端口还是报 10013说明新端口也被占了或被保留。用netstat -ano | findstr :1465和netsh int ipv4 show excludedportrange protocoltcp两条命令交叉确认。如果落在保留段换到 15000 以上的高位端口比如 15873高位端口被保留的概率低很多。5.2 taskkill 提示拒绝访问九成是没用管理员权限开 PowerShell。关掉当前窗口右键「以管理员身份运行」再执行。如果已经是管理员还拒绝说明目标进程是受保护的系统进程不要强杀直接换端口。5.3 停了 iphlpsvc 之后网络异常iphlpsvc停掉可能影响 IPv6 和某些隧道功能。如果停完后发现网络不对劲用sc config iphlpsvc start auto恢复自启再sc start iphlpsvc启动然后改用换端口方案别跟系统服务较劲。5.4 环境变量读不到PowerShell 里用$env:TAOTOKEN_API_KEYcmd 里用%TAOTOKEN_API_KEY%两个语法不一样。另外用SetEnvironmentVariable写入的变量已经打开的终端读不到必须新开一个终端。Codex 如果是从图形界面启动的可能继承的是启动时的环境改完变量后要重启 Codex。5.5 配置改了但 Codex 没生效Codex 可能缓存了旧配置。确认config.toml路径正确Windows 上注意.codex目录是不是在C:\Users\你的用户名\下而不是在项目目录里。改完配置后完全退出 Codex 再启动不要只关窗口。5.6 返回 401 或 403Key 无效或没有对应模型的权限。去控制台确认 Key 状态必要时重新创建一个。注意base_url不要写成带/v1的完整路径TaoToken 的基地址就是https://taotoken.net/api路径拼接由客户端处理。6. 把登录配置收敛到统一通道端口占用和套接字权限这类问题本质是 Codex 自带的登录服务器太依赖本地环境。每次换机器、换网络、装个新软件都可能把 1455 或你换的端口占掉然后又是一轮 10013。与其反复排障不如把登录和模型访问都收敛到 TaoToken 的统一 Key 上Codex 只负责发请求不再自己起登录服务。如果你只是偶尔用 Codex按上面的config.toml配好 Key 和端口就够了。如果你每天都在 Codex 里跑编码任务、挂 Agent建议直接上 Coding Plan额度模型更适合高频场景也省得每次登录都提心吊胆Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteKey 管理和轮换在控制台做建议给 Codex 单独建 Key出问题直接吊销不影响其他工具API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite配置字段拿不准的时候以接入文档为准文档里的字段名和示例是最新的接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后留一个我踩过的坑换端口之后记得把config.toml和settings.json里的端口改成一致我有一次只改了 toml结果 VS Code 扩展还在用旧端口登录照样失败查了半天才发现是两个文件不同步。