适用系统:Windows 10 / Windows 11、macOS、Linux、Windows + WSL2
本教程介绍如何将 静态住宅代理 IP 用于 Codex 桌面端、Codex CLI 及相关 IDE 集成,帮助用户完成代理配置、连接测试、出口 IP 验证和常见问题排查。
无论你是第一次使用代理 IP,还是已经配置好了静态住宅 IP,却发现 Codex 无法正常连接,都可以按照本指南逐步检查。
重要提示: 购买并配置静态住宅 IP,不代表 Codex 会自动使用该 IP。你还需要正确配置代理连接,并验证实际网络请求是否经过指定线路。
本文为第三方使用指南,并非 OpenAI 官方文档。Codex 不同版本、操作系统和运行环境的代理支持可能有所不同,请以实际版本的功能为准。
静态住宅IP推荐:https://www.ipdeep.cn/?extendid=44c2Zjc2NzI1OTI0MzA3OTA2NzIzOTEw
- 一、配置前需要准备什么
- 二、选择适合自己的代理配置方式
- 三、Windows 10 / Windows 11 配置教程
- 四、macOS 配置教程
- 五、Linux 配置教程
- 六、Windows WSL2 配置教程
- 七、如何验证 Codex 是否使用了静态 IP
- 八、常见问题及解决方法
- 九、如何恢复原来的网络配置
- 十、安全注意事项
- 十一、官方参考资料
- 十二、推荐IP纯净度检测工具
1.1 准备好静态住宅代理IP(如IPDEEP静态住宅IP)
开始配置前,请先确认已经购买 IPDEEP 静态住宅代理 IP,并从用户中心获取对应的连接信息。
通常需要以下信息:
| 配置项目 | 说明 |
|---|---|
| 代理服务器地址 | 服务商提供的 IP 地址或域名 |
| 代理端口 | 与所购代理产品对应的端口 |
| 代理协议 | HTTP、HTTPS 或 SOCKS5,以实际服务为准 |
| 代理用户名 | 如果代理需要账号认证,则需要填写 |
| 代理密码 | 如果代理需要密码认证,则需要填写 |
| 本地代理端口 | 如果使用本地代理客户端,需要查看客户端实际开放的端口 |
请使用自己账户中实际提供的连接信息。本文中的地址、用户名和端口均为示例,不能直接用于真实连接。
在配置 Codex 之前,需要先分清楚两种不同的代理连接方式。
方式一:直接连接 IPDEEP 远程代理
假设服务商提供以下信息:
代理服务器:proxy.example.com 代理端口:12345 用户名:your_username 密码:your_password 协议:HTTP
如果服务商提供的是 HTTP 代理接入,可以将其表示为:
http://proxy.example.com:12345(仅供参考,具体与IPDEEP代理商提供的为准)
如果代理需要认证,还需要根据所使用的客户端或应用支持的方式配置用户名和密码。
方式二:通过本地代理客户端连接
部分用户会先将 IPDEEP 静态住宅 IP 添加到兼容的代理客户端中,再由客户端提供本地代理入口。
例如:
本地 HTTP 代理:127.0.0.1:7890 本地 SOCKS5 代理:127.0.0.1:7891
以上仅为示例,实际地址和端口请以自己的客户端为准。
这种方式的连接流程为:
Codex ↓ 本地代理客户端 ↓ IPDEEP 静态住宅代理 IP ↓ 目标网络服务
注意:127.0.0.1 表示当前设备本身,不是 IPDEEP 的远程代理服务器。只有本地代理客户端确实在对应端口监听时,才能使用该地址。
代理协议必须与实际的连接入口保持一致。
HTTP 代理: 可以通过 HTTP 代理机制转发网页和 HTTPS 目标请求,具体取决于客户端支持。
HTTPS 代理: 通常指客户端与代理服务器之间使用 TLS 建立连接的代理方式,不能简单地将其等同于普通 HTTP 代理。
SOCKS5 代理: 使用 SOCKS 协议转发连接,需要应用或代理客户端支持 SOCKS5。
不要把 SOCKS5 端口直接填写到 HTTP 代理配置中,也不要假设所有 Codex 版本都支持相同的代理协议。
如果不确定应该使用哪种方式,可以先在代理客户端中配置 IPDEEP 静态 IP,再使用客户端实际提供的 HTTP 代理入口进行测试。
常见的配置方式有两种。
适合希望让多个应用共用同一条静态 IP 线路的用户。
操作步骤:
安装兼容当前操作系统的代理客户端。
添加 IPDEEP 静态住宅代理的地址、端口、协议和认证信息。
连接代理,确认客户端连接正常。
根据客户端支持情况,开启系统代理或合适的流量转发模式。
验证实际出口 IP。
重启 Codex 并测试实际请求。
需要注意,系统代理通常只影响遵循系统代理设置的应用;TUN 等流量转发模式的覆盖范围则取决于具体客户端配置。不能仅凭浏览器能够正常访问,就断定 Codex 的网络请求也经过了代理。
某些命令行程序和应用组件会读取环境变量中的代理配置。
例如:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890"
这种方法适合支持相关环境变量的程序,但不保证所有 Codex 桌面版本都会读取这些变量。
特别注意: 在终端中设置环境变量,并不意味着从 Windows 开始菜单、macOS Dock 或 Linux 桌面菜单启动的应用也会自动使用相同的代理配置。
因此,建议优先确认代理本身可以正常连接,再根据实际系统和 Codex 版本配置代理,最后验证结果。
Windows 用户可以先通过代理客户端建立连接,再测试 Codex 是否使用正确的网络线路。
第一步:添加 IPDEEP 静态住宅代理
打开自己使用的代理客户端,添加 IPDEEP 用户中心提供的连接信息:
代理协议
代理服务器地址
代理端口
用户名
密码
保存设置并连接代理。
第二步:确认代理客户端已正常连接
检查客户端的连接状态,确认没有出现认证失败、连接超时等错误。
如果客户端提供本地 HTTP 代理端口,请记录实际端口。例如:
127.0.0.1:7890
这个地址只是示例,不是固定配置。
第三步:设置适当的流量转发方式
根据客户端支持情况,检查以下功能:
系统代理
全局代理模式
TUN 模式
应用级代理规则
不同模式的作用范围可能不同。如果需要让 Codex 的网络请求通过代理,应确认所选模式能够覆盖实际运行 Codex 的进程及相关网络组件。
第四步:重启 Codex
完全退出 Codex,再重新打开。
发送一条简单的测试消息,确认应用能否正常完成请求。
如果仍然无法连接,请继续执行下面的代理验证步骤。
如果你使用的是支持环境变量的 Codex CLI 或其他应用组件,可以尝试此方法。
第一步:打开 PowerShell
按下 Win + X,打开 Windows 终端或 PowerShell。
第二步:设置当前终端的代理变量
假设本地代理客户端提供 HTTP 代理端口 7890,执行:
$env:HTTP_PROXY = "http://127.0.0.1:7890" $env:HTTPS_PROXY = "http://127.0.0.1:7890" $env:NO_PROXY = "localhost,127.0.0.1,::1"
请将端口替换为自己的真实端口。
这些变量只对当前 PowerShell 会话及其启动的子进程生效。
第三步:测试代理连接
执行:
curl.exe -x http://127.0.0.1:7890 https://api.ipify.org
如果连接成功,命令通常会返回当前请求使用的出口 IP。
如果返回连接错误,请检查代理客户端是否运行、端口是否正确,以及当前端口是否确实提供 HTTP 代理服务。
第四步:启动 Codex CLI
如果你使用 Codex CLI,可以在同一个 PowerShell 窗口中执行:
codex
然后测试实际请求。
注意:此步骤验证的是从当前终端启动的 CLI,不代表已经安装的 Codex 图形界面应用一定使用相同的代理。
如果希望变量在后续终端会话中继续生效,可以设置用户级环境变量。
操作步骤
1.1 打开 Windows 搜索。
1.2 搜索“编辑账户的环境变量”。
1.3 打开用户环境变量设置窗口。
1.4 添加或编辑以下变量。
| 变量名 | 示例值 |
|---|---|
| HTTP_PROXY | http://127.0.0.1:7890 |
| HTTPS_PROXY | http://127.0.0.1:7890 |
| NO_PROXY | localhost,127.0.0.1,::1 |
1.5 保存设置。
1.6 完全退出并重新打开需要使用代理的应用。
1.7 再次测试 Codex。
修改环境变量不会自动更新已经运行的进程。如果应用仍然无法连接,可以尝试注销并重新登录 Windows。
macOS 用户需要特别注意:终端环境变量与图形界面应用的启动环境并不完全相同。
通过终端启动的程序可以继承当前 Shell 的变量,但从 Finder 或 Dock 启动的应用不一定会继承这些设置。
第一步:添加代理信息
在兼容的代理客户端中添加 IPDEEP 静态住宅代理的地址、端口、协议和认证信息。
第二步:连接代理
确认代理客户端显示连接成功。
第三步:检查系统代理
根据客户端提供的功能,开启适当的系统代理或流量转发模式。
第四步:重启 Codex
完全退出 Codex,再重新打开并测试。
如果浏览器能够正常访问,但 Codex 仍然无法连接,请继续检查应用实际使用的网络配置。
第一步:打开终端
打开 macOS 自带的“终端”应用。
第二步:设置代理环境变量
假设本地 HTTP 代理端口为 7890,执行:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890" export NO_PROXY="localhost,127.0.0.1,::1"
请使用实际的代理地址和端口。
第三步:测试出口 IP
执行:
curl -x http://127.0.0.1:7890 https://api.ipify.org
如果成功,将返回当前请求使用的出口 IP。
第四步:启动 Codex CLI
如果已安装 Codex CLI,可以在当前终端中运行:
codex
发送测试请求,检查是否能够正常完成。
这种方式只验证当前终端环境下的 CLI。它不保证从 Dock 启动的图形界面应用也会读取相同的环境变量。
macOS 默认使用 Zsh 的用户,可以执行:
nano ~/.zshrc
在文件末尾添加:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890" export NO_PROXY="localhost,127.0.0.1,::1"
保存后执行:
source ~/.zshrc
检查是否生效:
env | grep -i proxy
如果输出中包含刚才设置的变量,说明当前 Shell 已经加载这些设置。
但是,这种方式主要影响加载该配置的 Shell 及其子进程,不代表所有图形界面应用都会使用这些变量。
打开:
系统设置 → 网络 → 当前使用的网络 → 详细信息 → 代理
不同 macOS 版本的菜单名称可能略有区别。
检查当前 HTTP 或 HTTPS 代理设置是否与代理客户端提供的地址一致。
修改后完全退出并重新打开 Codex,再次测试连接。
Linux 用户需要先确认自己使用的是 Codex CLI、IDE 扩展,还是其他受支持的运行方式。
不要假设所有 Linux 发行版都提供与 Windows、macOS 完全相同的 Codex 桌面应用。
打开终端,执行:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890" export NO_PROXY="localhost,127.0.0.1,::1"
请将端口替换为自己的真实代理端口。
检查变量:
env | grep -i proxy
测试代理:
curl -x http://127.0.0.1:7890 https://api.ipify.org
如果测试成功,并且你使用 Codex CLI,可以在当前终端中执行:
codex
再测试实际请求。
如果使用 Bash:
nano ~/.bashrc
如果使用 Zsh:
nano ~/.zshrc
在文件末尾添加:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890" export NO_PROXY="localhost,127.0.0.1,::1"
保存文件。
Bash 用户执行:
source ~/.bashrc
Zsh 用户执行:
source ~/.zshrc
再次检查:
env | grep -i proxy
如果环境变量已加载,就可以继续测试 Codex。
如果你是在 IDE 中使用 Codex,但终端测试成功、IDE 中仍然无法连接,可以重点检查:
IDE 是否使用了正确的代理配置。
IDE 是否在设置代理之前已经启动。
IDE 扩展是否继承了预期的环境变量。
IDE 是否具有独立的网络配置。
当前版本的 Codex 集成是否支持所设置的代理方式。
修改后重启 IDE,再测试实际请求。
如果你使用 Windows,但在 WSL2 环境中运行 Linux 开发工具,需要额外检查 Windows 与 WSL2 之间的网络连接。
第一步:确认 Windows 代理正常
先在 Windows 中确认:
IPDEEP 静态住宅代理已连接。
代理客户端运行正常。
本地代理端口正确。
第二步:检查 WSL2 环境变量
打开 WSL2 终端,执行:
env | grep -i proxy
如果没有看到预期的变量,可以在当前终端中设置:
export HTTP_PROXY="http://127.0.0.1:7890" export HTTPS_PROXY="http://127.0.0.1:7890"
注意:这里的 127.0.0.1 是 WSL2 环境中的本地地址,不一定等同于 Windows 主机的本地代理地址。
只有在 WSL2 能够通过该地址访问代理服务时,这种写法才有效。
第三步:测试代理连接
执行:
curl -I -x http://127.0.0.1:7890 https://example.com
如果连接失败,请检查:
WSL2 网络模式。
Windows 主机地址。
本地代理客户端的监听地址。
Windows 与 WSL2 之间的端口可达性。
代理客户端是否允许来自 WSL2 的连接。
不要为了排查问题而随意将代理监听端口暴露到所有网络接口。
第四步:分别验证 Windows 与 WSL2
如果你使用 Windows Codex 桌面应用操作 WSL2 项目,需要分别检查:
Windows 桌面应用是否正常连接。
WSL2 中的命令行程序是否正常连接。
两者是否使用相同的出口 IP。
实际执行任务的进程是否继承了正确的代理配置。
Windows 终端测试成功,并不能直接证明 WSL2 中的所有请求都经过同一条代理线路。
建议分三个步骤检查代理配置。
第一步:测试代理端口
Windows PowerShell:
Test-NetConnection 127.0.0.1 -Port 7890
macOS / Linux:
nc -vz 127.0.0.1 7890
请将端口替换为实际端口。
如果测试成功,说明本地端口可以建立 TCP 连接,但还不能证明代理认证成功或外部请求能够正常完成。
第二步:测试出口 IP
如果使用 HTTP 代理:
curl -x http://127.0.0.1:7890 https://api.ipify.org
如果直接使用远程 HTTP 代理:
curl -x http://proxy.example.com:12345 https://api.ipify.org
如果代理需要用户名和密码,可以使用:
curl -x http://proxy.example.com:12345
--proxy-user 'your_username:your_password'
https://api.ipify.org
以上地址和凭据均为示例。请替换为自己的真实信息。
注意:将真实密码直接写入命令可能会留下 Shell 历史记录。建议使用更安全的凭据输入方式,并避免公开包含认证信息的日志。
如果使用 SOCKS5,并且本地代理端口确实提供 SOCKS5 服务,可以测试:
curl --proxy socks5h://127.0.0.1:7891 https://api.ipify.org
成功后,命令会返回当前请求的出口 IP。
请将返回结果与 IPDEEP 分配的预期出口 IP 对比。
如果两者不一致,需要检查代理客户端的节点选择、流量转发规则和实际网络路径。
第三步:测试 Codex 实际请求
完成代理设置后:
完全退出 Codex。
重新启动应用。
登录账号。
新建一个对话。
发送一条简单的测试消息。
确认请求可以正常完成。
必要时检查代理客户端日志或服务端连接记录。
能够正常对话,只能证明这次请求成功完成,不能单独证明 Codex 的所有请求都使用了指定 IP。
如果需要确认实际出口,应结合代理日志、网络诊断信息或服务端记录进一步核验。
可能原因:
浏览器和 Codex 使用了不同的代理设置。
桌面应用没有继承终端环境变量。
代理客户端只转发了部分应用的流量。
代理地址、端口或协议配置错误。
当前网络连接存在其他问题。
建议先单独测试代理,再检查 Codex 实际使用的网络配置。
如果报错中包含:
127.0.0.1:7890
请先确认本地代理客户端是否运行,以及对应端口是否正确。
常见原因包括:
客户端没有启动。
端口填写错误。
客户端使用了其他监听端口。
该端口不是 HTTP 代理端口。
本地代理服务没有成功启动。
请检查:
用户名和密码是否正确。
代理服务器地址是否正确。
端口与产品是否匹配。
代理协议是否正确。
用户名或密码中的特殊字符是否需要 URL 编码。
不要在公开的 GitHub Issue 中提交真实代理账号或密码。
建议依次检查:
IPDEEP 代理是否正常连接。
本地代理客户端是否正常运行。
代理端口是否可达。
代理协议是否匹配。
Codex 是否真正使用了代理。
当前目标网络服务是否可以正常访问。
不要仅凭超时报错就认定是 IP 纯净度问题。
这种情况通常需要检查两个运行环境之间的差异。
终端环境变量只会影响当前 Shell 及其子进程;从图形界面直接启动的应用不一定继承相同变量。
可以尝试:
检查应用是否遵循系统代理设置。
确认代理客户端的流量转发范围。
完全退出并重新启动 Codex。
检查当前 Codex 版本的网络代理支持。
使用日志进一步确认实际连接路径。
请检查:
代理客户端是否连接到正确节点。
是否有其他代理规则覆盖当前设置。
测试请求是否绕过了代理。
当前环境是否存在额外的网络转发或 NAT。
是否在不同设备或不同网络环境中进行了对比。
应尽量在同一台设备、同一个运行环境中进行验证。
并非所有网络相关错误都由代理造成。
Codex 还可能受到账号登录状态、应用版本、网络服务状态、工具执行权限或安全限制的影响。
建议记录完整错误信息,先确认代理连接正常,再根据具体错误检查对应功能,不要直接关闭所有安全限制。
如果不再需要代理,可以删除自己添加的变量并恢复之前的网络设置。
如果只在当前 PowerShell 会话中设置过变量,可以执行:
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue Remove-Item Env:NO_PROXY -ErrorAction SilentlyContinue
如果曾经修改 Windows 用户环境变量,还需要在环境变量设置界面中删除自己新增的变量。
如果修改过系统代理设置,请恢复原来的值。
如果只在当前终端设置过变量,可以执行:
unset HTTP_PROXY HTTPS_PROXY NO_PROXY unset http_proxy https_proxy no_proxy
如果修改过 ~/.zshrc 或 ~/.bashrc,请删除自己添加的代理配置,再重新加载对应文件。
如果使用了代理客户端,也需要根据实际情况关闭代理或恢复之前的流量转发模式。
注意:只删除自己添加的设置,不要误删原有的公司网络或其他应用所需的代理配置。
使用静态住宅代理 IP 时,请注意以下事项:
不要将真实代理用户名、密码或带认证信息的完整连接地址上传到公开 GitHub 仓库。
不要将本文示例中的 IP、域名或端口直接当作真实连接信息使用。
不要把 SOCKS5 端口直接当作 HTTP 代理端口使用。
不要为了排查问题而随意将本地代理端口暴露到外部网络。
不要仅凭浏览器的出口 IP 判断 Codex 的所有请求都经过了指定线路。
修改系统网络设置之前,建议记录原始配置,以便恢复。
遇到连接问题时,优先确认协议、地址、端口和认证信息是否正确,再排查应用本身的网络行为。
建议在使用过程中参考以下官方文档,确认当前版本的实际功能和兼容性。
注意:Codex 项目中的网络代理实现与外部住宅代理服务并不是同一个概念。具体的代理支持方式应以当前安装版本的官方文档和实际测试结果为准。