OpenAI Codex CLI 使用教程(2026):国内安装、登录与代理设置
OpenAI Codex CLI 使用教程:Codex 怎么用、国内怎么安装、登录失败怎么办、代理怎么设置。给出安装脚本、npm、Homebrew 三种官方命令,讲 ChatGPT 账号与 API 密钥登录、1455 回调端口、终端代理、常用命令、和 Claude Code 的区别与连接失败排查。
这篇 OpenAI Codex CLI 使用教程先说结论:Codex CLI 的官方安装方式有四种:安装脚本、Windows 的 PowerShell 脚本、npm 和 Homebrew,命令见下文。登录首选用 ChatGPT 账号,浏览器授权后会回调本机的 1455 端口。它是命令行程序,不读系统代理,最稳妥的办法是打开代理客户端的 TUN 模式;只想让终端走代理,就在启动前设置 HTTP 代理环境变量。节点要落在 OpenAI 支持的地区,并且固定不变。下文的命令都来自官方仓库和文档,命令会更新,以官方页面为准。
OpenAI Codex CLI 使用教程:它是什么,需要什么账号
Codex CLI 是 OpenAI 开源的命令行编程助手,在终端里读代码、改文件、运行命令。代码仓库在 https://github.com/openai/codex,官方文档从 https://developers.openai.com/codex 进入,目前会跳转到 OpenAI 的新文档站。
账号有两种用法,官方仓库的说明是:
| 登录方式 | 计费 | 说明 |
|---|---|---|
| ChatGPT 账号 | 走订阅额度 | 官方推荐,说明里列出的套餐是 Plus、Pro、Business、Edu、Enterprise |
| API 密钥 | 按用量计费 | 需要 OpenAI 平台账号和额外设置 |
套餐范围会调整,以官方页面为准。ChatGPT 账号本身的注册、支持地区和报错处理见 ChatGPT 使用教程。
除了命令行版本,Codex 还以桌面应用和 IDE 扩展的形式提供,入口都在官方文档里,本文以命令行为主,其他形态的网络差异放在下一节。
Codex 国内怎么用:准备和顺序
Codex 走的是 OpenAI 的账号和地区体系,所以国内使用的前提和 ChatGPT 一样:账号能正常登录,出口在 OpenAI 支持的地区。多出来的是终端这一层,命令行程序不读系统代理,这是国内用户最常卡住的地方。按这个顺序准备:
- 先在浏览器里把 ChatGPT 用顺。 账号注册、节点挑选都在 ChatGPT 使用教程 里,浏览器能稳定对话,说明账号和节点没有问题。
- 决定终端怎么走代理。 想省事就开 TUN 模式;只想影响终端,就用环境变量。两种办法见下文「代理设置」。
- 在终端里确认出口。 curl 查一次出口 IP,地区和浏览器一致。
- 运行官方安装命令。 安装脚本从境外服务器下载,必须在终端走代理之后再运行。
- 登录。 运行
codex,选 ChatGPT 账号登录,留意 1455 端口的回调不能被代理扩展转发。 - 先小任务后长任务。 确认节点在长连接下也稳定,再固定下来。
安装到一半没反应、浏览器授权成功但终端报错,这两种情况在国内最常见,几乎都是终端没走代理或出口不一致造成的,下文都有对应的处理。
Codex 的几种形态与各自的网络要求
同叫 Codex,运行的位置不同,对你本机网络的要求也不同。弄清楚自己用的是哪一种,排查时才不会找错方向。
| 形态 | 在哪里运行 | 你这边的网络要做什么 |
|---|---|---|
| 命令行 CLI | 本机终端 | 终端必须走代理,见下文的 TUN 或环境变量 |
| IDE 扩展 | 本机编辑器 | 跟随编辑器的代理设置;从图形界面启动的编辑器不继承终端变量,TUN 最省事 |
| 桌面应用 | 本机 | 和 ChatGPT 桌面应用相同,连不上就开 TUN |
| 网页上的云端任务 | OpenAI 的服务器 | 只需要浏览器能正常打开页面;任务运行环境的联网方式由官方设置决定,以官方说明为准 |
云端任务需要先连接代码仓库,具体流程以官方页面当时的说明为准。它和本机的 CLI 共用 ChatGPT 账号,所以网页和终端最好走同一个地区的出口,避免同一账号同时出现在两个国家。
Codex CLI 安装:官方命令与各平台差异
下面四条命令来自官方仓库的说明文件,动手前建议到仓库首页再核对一次。
macOS 与 Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm:
npm install -g @openai/codex
Homebrew:
brew install --cask codex
装完后在项目目录里运行:
codex
官方文档写的升级方式是重新运行一次安装脚本。用 npm 或 Homebrew 安装的,按各自包管理器的升级方式处理。
Windows 与 WSL。 除了上面的 PowerShell 脚本,官方文档还有一页专门讲 WSL:在管理员权限的 PowerShell 里运行 wsl --install 装好 WSL2,然后进入 WSL 的终端,用 Linux 的安装脚本安装并运行 codex。文档建议把代码仓库放在 Linux 的主目录下,而不是 /mnt/c/ 里,那样读写更快,权限问题也更少。文档同时说明 WSL1 已经不再支持。原生 Windows 和 WSL 两种方式的沙箱机制不同,怎么选以官方文档当前的建议为准。
各平台的差异。 下面这张表把几种系统上容易出问题的地方放在一起:
| 平台 | 推荐安装方式 | 代理变量写法 | 需要留意 |
|---|---|---|---|
| macOS | 安装脚本或 Homebrew | export,可写进 ~/.zshrc |
从程序坞启动的编辑器不继承终端变量 |
| Linux | 安装脚本或 npm | export,可写进 ~/.bashrc |
服务器上没有浏览器,登录用设备码或端口转发 |
| 原生 Windows | PowerShell 安装脚本 | $env:,只对当前窗口有效 |
沙箱机制和类 Unix 系统不同,以官方文档为准 |
| WSL2 | 在 WSL 里用 Linux 安装脚本 | export,地址不能写 127.0.0.1 |
在 Windows 侧开 TUN,或用 Windows 主机地址并允许局域网连接 |
Codex 的个人配置放在用户目录下的 .codex 文件夹里,登录凭据也在这里。换电脑时不要把整个文件夹打包发到聊天软件里,里面有访问令牌。
安装时的网络。 安装脚本从 chatgpt.com 获取,官方说明程序本体默认从 releases.openai.com 下载,失败时回退到 GitHub Releases。所以安装这一步,终端就必须能访问这些域名。没走代理时的典型表现是命令长时间没有输出,或者报连接超时。先让终端走代理再安装,做法见下文。
Codex 怎么登录:浏览器授权、回调端口与登录失败
第一次运行 codex 时,选择用 ChatGPT 登录,浏览器会打开授权页面,完成后自动回到终端。相关命令来自官方的认证文档:
codex login # 浏览器登录,默认方式
codex login status # 查看当前登录方式
codex logout # 退出登录
用 API 密钥登录:
printenv OPENAI_API_KEY | codex login --with-api-key
这个登录流程有几个和网络相关的细节,值得单独说。
回调端口 1455。 浏览器授权完成后,会跳转到本机的 localhost:1455,把结果交还给终端里的 Codex。这一跳是本机内部的访问,不应该经过代理。如果你的浏览器代理扩展把所有地址都转发给代理,包括 localhost,这一步就会失败,表现为网页显示无法连接,终端一直等待。解决办法是在代理扩展里把 localhost 和 127.0.0.1 设为直连,或者登录时临时改用系统代理加规则模式。
浏览器和终端要走同一个出口。 网页授权走浏览器的代理,令牌交换走终端的代理。两边出口地区不一致,或者终端根本没走代理,会出现网页显示成功、终端却报错的情况。
在远程机器或没有浏览器的环境登录。 官方文档给了三种办法:
- 设备码登录:
codex login --device-auth。文档标注为测试功能,并且需要先在 ChatGPT 的安全设置或工作区权限里启用设备码登录。 - 在有浏览器的电脑上登录好,把凭据文件复制到远程机器的相同路径。
- 用 SSH 转发回调端口,再在这个会话里运行
codex login,把打印出来的地址放到本地浏览器打开:
ssh -L 1455:localhost:1455 user@remote
凭据存放位置。 登录信息缓存在 ~/.codex/auth.json,或者操作系统的凭据存储里。官方文档的原话是把这个文件当作密码对待,因为里面是访问令牌。
用 API 密钥登录时要注意什么
不用 ChatGPT 账号、改用 API 密钥的人,多出几件事要留意:
- 密钥在 OpenAI 平台账号里创建,按用量计费。 充值、账单和用量上限都在平台页面设置,以官方当前说明为准。
- 请求发往 OpenAI 的 API 域名。 它在 openai.com 后缀下,下文分流规则里的那一条已经覆盖。
- API 同样有支持地区的要求。 出口不在支持地区时,请求会直接被拒绝,和网页版的道理一样。
- 两种方式都配置过时,先确认当前用的是哪一种。 运行
codex login status查看,避免以为在用订阅额度,实际在按量扣费。 - 密钥只放在环境变量或系统凭据里。 不写进项目文件,怀疑泄露就在平台上删除并重建。
Codex 代理设置:TUN 模式或环境变量
Codex CLI 和所有命令行程序一样,默认不读系统代理。本文更新时,官方文档里没有专门的代理配置页面,所以下面两种办法里,第一种更有保证。
办法一:TUN 模式。 打开代理客户端的 TUN 模式,由虚拟网卡在网络层接管全部流量,Codex 不需要任何配置,它在执行任务时调用的 git、包管理器等工具也一并走代理。这是对程序自身代理支持没有任何依赖的做法,原理见 规则、全局与 TUN 模式。在 Clash Verge Rev 里的开启位置见 Clash Verge Rev 使用教程,TUN 打不开见 TUN 模式开不了。
办法二:环境变量。 多数命令行程序会读取标准的代理环境变量,在启动 codex 之前设置。端口换成你客户端显示的混合端口,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
codex
$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"
codex
三点说明:
- 优先用
http://开头的 HTTP 代理地址,而不是 SOCKS 地址。Clash 系客户端的混合端口同时提供两种协议,填 HTTP 即可。 NO_PROXY那一行是为了让登录回调的本机访问不走代理。- 环境变量方式是否对 Codex 的所有连接都生效,取决于具体版本,官方没有书面承诺。设置之后仍然连不上,不要反复折腾变量,直接换成 TUN。
更完整的终端代理写法,包括 Git、npm、Docker 各自的配置,见 终端、Git、npm、Docker 走代理。在 WSL 里使用时,127.0.0.1 指向的是 WSL 自己,需要在 Windows 侧开 TUN,或者把代理地址换成 Windows 主机的地址并允许局域网连接,见 局域网共享代理。
Codex 用什么节点:地区、IP 类型与分流规则
Codex 用的是 OpenAI 的账号体系,网络要求和 ChatGPT 一致:
- 地区。 出口 IP 要在 OpenAI 支持的国家和地区内,名单以官方帮助中心为准。香港节点通常不可用,原因见 香港节点适合做什么。
- IP 类型。 共享的机房 IP 更容易被限流或要求验证,标注原生 IP 或家宽 IP 的节点一般更稳,但倍率更高。这些都是机场的官方标注,本站未验证。概念见 机房 IP 与 AI 风控。
- 固定节点。 Codex 的任务是长连接,一次可能跑很久。策略组用手动选择,不要用自动测速或负载均衡。
分流规则把 OpenAI 相关域名放进同一个手动选择的策略组。如果订阅已经自带 AI 或 OpenAI 策略组,直接给它选节点即可;否则参考下面的示意,节点名换成订阅里真实存在的名称:
proxy-groups:
- name: AI
type: select
proxies: [美国节点甲, 日本节点乙]
rules:
- DOMAIN-SUFFIX,openai.com,AI
- DOMAIN-SUFFIX,chatgpt.com,AI
- DOMAIN-SUFFIX,oaistatic.com,AI
- DOMAIN-SUFFIX,oaiusercontent.com,AI
Codex 执行任务时还会访问 GitHub、npm 源、PyPI 等开发常用站点。这些不必和 AI 走同一个节点,但要保证它们能连上,否则会出现模型正常回复、安装依赖却卡住的情况。网页版 ChatGPT 和 Codex 最好共用同一个出口,避免同一账号同时出现在两个国家。整体思路见 AI 工具的网络环境怎么配。
Codex 怎么用:第一次任务与常用命令
网络和登录都通了以后,进入项目目录运行 codex,用自然语言描述任务即可。它会读文件、给出修改方案,按你设置的批准方式改文件和运行命令。常用的入口如下,会话里输入 / 会列出当前版本支持的命令,不同版本略有差异,以实际显示为准:
| 用法 | 作用 |
|---|---|
codex |
在当前目录启动交互式会话 |
codex "任务描述" |
启动时直接带上第一条任务 |
codex exec "任务描述" |
非交互方式运行一次,适合放进脚本 |
codex resume |
继续之前的会话 |
/model |
切换模型,可选范围取决于账号套餐 |
/init |
生成一份给 Codex 看的项目说明文件 |
/status |
查看当前账号、模型和会话状态 |
/diff |
查看本次会话改动了哪些文件 |
/new、/compact |
开新会话、压缩过长的上下文 |
上手建议:
- 在 git 仓库里用。 每次让它动手之前先提交一次,改坏了能回退。
- 写一份项目说明。 用
/init生成后,补上构建命令、测试命令和代码风格约定,它之后会照着执行。 - 批准方式从严到松。 刚开始让它每次运行命令都先问你,熟悉之后再按官方文档放宽。
- 任务描述具体。 写清楚要改什么、不能动什么、改完怎么验证,比笼统地说「优化一下」有效得多。
Codex 和 Claude Code 有什么区别
两者都是终端里的编程助手,用法相近,差别主要在账号和网络:
| 对比 | Codex CLI | Claude Code |
|---|---|---|
| 账号 | ChatGPT 账号或 OpenAI API 密钥 | Claude 付费套餐或 Console 账号 |
| 地区名单 | OpenAI 支持名单 | Anthropic 支持名单,另有手机号验证门槛 |
| 登录回调 | 本机 1455 端口 | 浏览器授权后回到终端,或粘贴代码 |
| 代理 | 环境变量或 TUN,官方没有专门的代理文档 | 官方写明支持 HTTPS_PROXY,不支持 SOCKS |
已经有 ChatGPT 订阅的,用 Codex 不需要另外注册账号;已经在用 Claude 的,看 Claude Code 使用教程。更习惯在编辑器里写代码的,也可以看 GitHub Copilot 使用教程。各家的套餐和功能更新很快,以官方说明为准。
节点地区怎么判断合不合适
浏览器里能用 ChatGPT,只能说明浏览器那条路是通的。给 Codex 挑节点要在终端里验证:
- 终端出口和浏览器一致。 在终端里用 curl 访问任意查询出口 IP 的服务,地区要在 OpenAI 支持名单内,并且和浏览器查到的相同。
- 能连上服务。 运行
curl -I https://chatgpt.com,能返回响应头即可。 - 登录状态正常。
codex login status显示已登录。 - 跑一个小任务。 让它解释一个函数或补一段注释,确认往返正常。
- 跑一个长任务。 让它做一件需要读多个文件、运行几次命令的事,观察中途有没有断开重连。
- 晚高峰复测。 长任务在晚上也能稳定跑完,这个节点才值得固定。
| 现象 | 判断 | 处理 |
|---|---|---|
| 终端查到的地区和浏览器不同 | 终端没走代理,或走了另一个策略组 | 开 TUN,或检查环境变量 |
| 小任务正常,长任务中途断开 | 节点或线路不稳,或策略组在自动切换 | 固定节点,换线路对比 |
| 频繁要求重新登录 | 出口地区在变,或凭据文件被清理 | 固定节点,检查 .codex 目录 |
| 白天晚上都稳定 | 合适 | 固定使用,同地区备一个 |
连接失败的排查顺序
按从外到内的顺序排查,每一步都能明确排除一类原因。
- 代理客户端是否正常。 浏览器打开 chatgpt.com,能正常进入对话页面,说明节点和账号没有问题,问题在终端这一侧。
- 终端是否走了代理。 运行下面的命令。能返回 HTTP 响应头就说明终端到 OpenAI 是通的,状态码是多少不重要;超时或连接被重置,说明终端的流量没有进入代理。
curl -I https://chatgpt.com
- 出口地区是否正确。 在同一个终端里用任意查询出口 IP 的服务确认地区。浏览器和终端查到的结果应该一致。
- 规则是否命中。 到代理客户端的连接页面,看来自 codex 进程的请求走了哪个策略组、哪个节点。
- 登录状态。 运行
codex login status。凭据失效就先codex logout再重新登录。 - 节点稳定性。 能连上但任务中途频繁断开,是节点质量问题,换一个同地区节点对比,见 节点超时怎么办。
| 现象 | 多半的原因 | 处理 |
|---|---|---|
| 安装脚本没反应或超时 | 终端没有走代理 | 先设置环境变量或开 TUN 再安装 |
| 浏览器授权后页面显示无法连接 localhost | 回调被代理扩展转发,或在远程机器上登录 | localhost 设为直连,或用端口转发、设备码登录 |
| 网页授权成功,终端报错 | 终端没走代理,或出口地区与浏览器不同 | 统一出口,优先用 TUN |
| 提示所在国家或地区不支持 | 出口 IP 不在支持地区 | 换节点 |
| 请求过多或被限流 | IP 被共用过度,或账号额度用尽 | 换同地区节点;额度问题只能等待,见 ChatGPT 提示请求过多 |
| 任务跑到一半反复重连 | 节点抖动,或策略组在自动切换 | 固定节点,避开晚高峰不稳的线路 |
| 模型正常,安装依赖失败 | GitHub、npm 等站点没走代理 | 开 TUN,或为对应工具单独配置代理 |
| 报错里带有 stream disconnected 一类字样 | 流式连接在回答完成前断开 | 多见于节点抖动或出口切换,固定节点后重试 |
| 提示未授权或令牌无效 | 登录凭据过期或被撤销 | codex logout 后重新登录 |
| 提示用量达到上限 | 套餐额度用完 | 与网络无关,等待重置或按官方页面处理 |
账号安全注意事项
- 保护
auth.json。 不要发给别人,不要提交进仓库,不要放进公开的网盘或聊天记录。换电脑或怀疑泄露时,先codex logout,再到账号的安全设置里检查登录设备。 - API 密钥不落盘到项目里。 用环境变量传入,并确认
.env之类的文件在.gitignore里。 - 不要共享账号。 一个 ChatGPT 账号在多个国家的机器上同时跑 Codex,是典型的风控场景。
- 只用官方安装渠道。 第三方打包的"中转版""免登录版"会经手你的代码和令牌。
- 看清权限提示。 Codex 会在本机执行命令,批准模式和沙箱设置按官方文档理解清楚再放宽,重要仓库先提交一次再让它动手。
不同国家和地区的规定不同,请遵守当地法律和服务条款。
Codex 配置文件与 AGENTS.md:让它按项目规矩干活
结论:Codex 的行为由两类文件决定,一类是用户目录下的配置文件,管模型、批准方式、沙箱和外部工具;另一类是项目里的 AGENTS.md,管这个项目怎么构建、怎么测试、有哪些约定。
配置文件。 官方文档里的位置是用户目录下 .codex 文件夹中的 config.toml,登录凭据也在这个文件夹里。常改的项有默认模型、批准方式、沙箱模式,以及接入外部工具的设置。字段名称会随版本调整,写之前对照官方配置文档,不要照抄网上的旧配置。需要在不同场景切换整套设置的,可以按官方文档定义多个配置档,启动时指定使用哪一个。
AGENTS.md。 这是写给 Codex 看的项目说明,放在仓库根目录,/init 生成的就是它。官方说明它可以分层:用户级的一份写个人通用习惯,仓库根目录写项目约定,子目录里还能再放一份写局部规则,越靠近当前目录的越具体。建议写进去的内容:
| 写什么 | 举例 |
|---|---|
| 构建和测试命令 | 安装依赖、运行测试、代码检查分别用哪条命令 |
| 代码风格 | 命名习惯、格式化工具、注释语言 |
| 不能动的地方 | 自动生成的目录、数据库迁移文件、第三方代码 |
| 提交习惯 | 提交说明的格式,改完是否必须跑测试 |
| 环境说明 | 需要走代理才能拉取依赖的,写明代理已由 TUN 接管,不要在命令里另加代理参数 |
AGENTS.md 会被提交进仓库,团队成员都能看到,所以不要在里面写密钥、内网地址和个人信息。
Codex 沙箱与批准方式:权限怎么放
结论:新手用「工作区可写加按需批准」的组合,Codex 能改项目里的文件,但运行命令和访问网络前会问你;完全放开的模式只在一次性的隔离环境里用。
官方把权限拆成两部分:沙箱决定它在技术上能碰到什么,批准方式决定什么时候停下来问你。下表是常见组合的含义,具体的模式名称和默认值以官方文档和 /status 的显示为准。
| 沙箱 | 能做什么 | 适合 |
|---|---|---|
| 只读 | 只能读文件,不能改 | 先让它熟悉一个陌生项目、只想要分析报告 |
| 工作区可写 | 能改当前项目目录里的文件,项目外和网络受限 | 日常写代码,推荐的默认选择 |
| 完全访问 | 不做限制 | 只在容器、虚拟机等用完即弃的环境里用 |
和代理相关的一点:沙箱可能限制命令访问网络,这时它运行 npm install、pip install 一类命令会失败,看起来像代理坏了,其实是权限没放开。遇到依赖安装失败,先看它是不是在请求联网权限,再查代理。
在脚本和 CI 里用 codex exec
结论:codex exec 适合把固定的检查或修改任务放进脚本,但在 CI 里要用 API 密钥而不是个人 ChatGPT 账号,并且权限收到最小。
- 密钥放进 CI 的密钥管理。 在流水线的加密变量里存 OpenAI API 密钥,以环境变量传给 Codex,不要写进仓库或日志。
- 不要把个人账号凭据复制到服务器。 把
auth.json拷到共享的构建机上,等于把账号交给所有能登录那台机器的人。 - CI 机器的出口也要在支持地区。 构建机在不支持的地区时,它自己要走代理,和你本机开没开代理无关。
- 限定权限。 CI 里一般只需要读代码、输出建议或生成补丁,用只读或工作区可写,不要用完全访问。
- 输出给人看。 让它的结果以评论或补丁的形式交给人审核,不要直接推送到主分支。
常见问题
Codex CLI 怎么安装?
macOS 和 Linux 运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh,也可以用 npm install -g @openai/codex 或 brew install --cask codex。Windows 有官方的 PowerShell 安装脚本,也可以装在 WSL2 里。命令以官方仓库为准。
Codex 免费吗,需要 ChatGPT Plus 吗?
Codex CLI 本身开源免费,但调用模型要消耗账号额度。官方说明推荐用 ChatGPT 账号登录,列出的套餐包括 Plus、Pro、Business、Edu、Enterprise;也可以改用 API 密钥按量计费。免费账号是否可用、各套餐额度多少,以官方页面的当前说明为准。
Codex 登录时浏览器显示无法访问 localhost 1455,怎么办?
这是授权完成后回调本机端口失败。检查浏览器代理扩展是否把 localhost 也转发给了代理,把它设为直连。如果是在远程服务器上登录,用 SSH 转发 1455 端口,或者使用设备码登录。
浏览器能用 ChatGPT,Codex 却连不上,为什么?
浏览器读取系统代理,命令行程序不读。打开代理客户端的 TUN 模式,或者在启动 codex 之前设置 HTTP 代理环境变量。
Codex CLI 怎么设置代理?
官方文档目前没有专门的代理配置说明。通用做法是设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量,地址用 http:// 开头;不生效时改用 TUN 模式,它不依赖程序自身的代理支持。
Codex 用哪个地区的节点?
和 ChatGPT 一样,选 OpenAI 支持地区内的节点,机场里常见的是美国、日本、新加坡、台湾。选定之后固定使用,网页版和命令行共用同一个出口。
用 Codex 一个月要多少流量?
很少,主要是文本传输,再加上任务里拉取依赖的流量。一般每月几个 GB 以内。选机场时更应该关心节点的地区和稳定性,候选见 AI 用机场怎么选。
用 Codex 网页上的云端任务,也要配终端代理吗?
不需要。云端任务在 OpenAI 的服务器上运行,你这边只要浏览器能正常打开页面。终端代理只和本机运行的 CLI、IDE 扩展有关。两者共用一个账号,网页和终端的出口地区保持一致即可。
Codex 的配置文件在哪里?
官方文档写的是用户目录下的 .codex 文件夹,配置文件名为 config.toml,登录凭据 auth.json 也在同一个文件夹里。配置项的名称以官方配置文档的当前版本为准。
AGENTS.md 是什么,必须写吗?
它是写给 Codex 的项目说明文件,不是必须的,但写了之后它会按你的构建命令、测试命令和代码约定工作,返工明显减少。可以先用 /init 生成,再手动补充,写法见上文配置一节。
Codex 安装依赖总是失败,是代理的问题吗?
不一定。先确认终端能连上 npm、PyPI 等站点;如果能连上,再看是不是沙箱限制了命令联网,它会请求联网权限,批准后再试。两者都排除了,才去换节点。