Codex CLI 国内使用教程:安装、配置与常用命令
从安装 Node.js、登录与配置 API Key,到让 Codex CLI 读项目、改代码、跑测试和排查 401/429 的完整流程,附第三方中转配置思路。
教程 / Guides
这里收录 Codex、OpenAI API 和 ChatGPT 账号相关的实际用法:怎么装、怎么配、怎么少踩坑。 先看教程再决定买什么,比买完再研究更省钱。
学习路径
Codex 与 AI 编程
Codex 安装配置、AGENTS.md 规则、三种模式区别、权限与沙箱、定时任务、故障排查。
从安装 Node.js、登录与配置 API Key,到让 Codex CLI 读项目、改代码、跑测试和排查 401/429 的完整流程,附第三方中转配置思路。
讲清 Codex 的 AGENTS.md 指令链:全局与项目的发现顺序、override 与 fallback 文件名、32 KiB 上限、审查规则怎么写,以及怎么验证实际加载了哪些文件。
同一个 ChatGPT 里的三种模式:Chat 回答问题,Work 交付成品,Codex 面向开发者。对照官方说明讲清三者的定位、桌面端六处差别、共用额度关系,以及什么场景该切哪个。
把 Codex 的分支能力拆成三层:新对话时选 Local / Worktree / Cloud、用 Handoff 搬对话与 Git 状态、在 app-server 和 SDK 里用 thread fork 复制历史。附实操步骤与常见坑。
从 context pollution 讲到 [agents] 并发上限:Codex 子代理怎么触发、委派提示词怎么写、自定义 agent 的必填字段,以及权限继承和成本上升这些实际会踩的坑。
在手机上接管跑在 Mac 或 Windows 上的 Codex 对话:前提条件、扫码配对、主机提供的环境、Handoff 交接、SSH 远程项目,以及断连排查与安全边界。
Codex 能把命令跑在你的机器上,所以权限配置比提示词更重要。讲清 permission profiles 与旧 sandbox_mode 的关系、文件与网络规则怎么写、审批策略放哪一层。
讲清 Codex 与 ChatGPT 定时任务的创建入口、调度频率怎么写、本地项目与 worktree 的运行差异、无人值守时的沙箱设置,以及失败排查与四个可直接抄的用法。
ChatGPT 桌面端浏览器扩展怎么用:支持哪些浏览器、side chat 与快捷键、@ 提及标签页、右键 Ask ChatGPT、网站权限与浏览器历史授权、隐私边界和排错。
Codex、Claude Code、Cursor、GitHub Copilot 的七维度对比:入口形态、规则文件、审批与沙箱、并行、CI、合规、成本,外加三组组合建议和「别同时上五个」的理由。
从入口形态、订阅与额度、规则文件、审批与沙箱、并行与 CI 五个维度对比 Codex 与 Claude Code,两边各自的强项和短板都写清楚,最后给出选型表与并存、迁移的做法。
给 AI 编程工具下指令的实用方法:补上下文、限定范围、要求验证,附修 bug、加功能、重构、写测试和读陌生代码的提示词模板。
把 Codex 接进代码审查流程:用 AGENTS.md 写审查规则、让它先读 diff 再动手、人工验收与测试怎么配合,以及哪些判断不该交给模型。
按层排查 Codex 的典型故障:登录与认证失败、命令被沙箱拦、网络与企业 TLS、AGENTS.md 不生效、MCP 连不上、云端任务卡住、IDE 与 Windows/WSL 差异。
OpenAI 与 API
模型对比、提示词、结构化输出、Embeddings 与 API 排查。
对比 GPT-6 Astra、GPT-6.1 Sol、GPT-6 Luna 与上一代 GPT-5.x 的定位差异,给出按任务选模型、按难度调推理档位的判断清单。
推理模型不需要你教它思考。讲清 developer message、分隔符组织输入、约束与验收标准,以及用 Responses API 复用 reasoning items 省 token 的做法。
json_schema + strict 保证字段、必填键和枚举都符合 schema。含 schema 硬规则、Pydantic/Zod 写法、refusal 分支,以及和函数调用的分工。
从向量化原理到 text-embedding-3-small / large 的维度与成本取舍,再到余弦相似度检索、维度截断、混合检索和批量调用,讲清怎么把 Embeddings 接进自己的数据。
Work 的价值不在聊得更好,而在能交出可复核的文件。这篇给出一套提示词骨架、文件类产出的约束写法,以及周报、竞品调研、PPT 大纲三个能直接改的模板。
API Key 怎么创建、放在哪里、如何设置限额和告警;泄露后怎么吊销轮换;以及 401、403、429、insufficient_quota 等错误的分辨与处理。
账号与安全
ChatGPT 登录态、账号安全与合买风险、代充流程、凭证与 Session 安全。
讲清 ChatGPT 与 Codex 账号的安全要点:MFA 的开启差异、登录设备与会话管理、凭证最容易从哪泄漏、共享账号与合买的真实风险,以及团队为什么该用 Business。
Session JSON 是 ChatGPT 网页登录态凭证。解释它包含什么、为什么代充流程需要它、怎么获取,以及升级完成后必须做哪些安全操作。
订阅与计费
ChatGPT 与 Codex 额度、档位选型、订阅与 API 计费对比、Batch 半价与缓存省钱。
Batch API 用 50% 折扣跑不需要实时返回的任务:jsonl 输入格式、上传与创建批次、状态流转、用 custom_id 对齐结果,以及限额与过期规则。
前缀缓存默认开启,但只有前缀真的被复用才省钱。讲清最小可缓存长度、读写倍率、显式与隐式断点、常见失效原因和成本账的算法。
拆开 ChatGPT 与 Codex 的三套额度:订阅内的 5 小时用量、可购买的 credits、以及 API 按量计费。给出官方档位表、额度共享规则和真正有效的省额度做法。
把 Free、Go、Plus、Pro 三个价位、Business、Enterprise 和 API Key 摆到一张表上,讲清价格之外真正拉开差距的功能,以及额度用完时该升级还是买 credits。
ChatGPT 订阅和 API 是两套独立计费体系:Plus/Pro 面向聊天产品,API 按 token 计费。对比适用场景、额度和常见误区,帮你判断该买哪一种。
下一步
要升级官方 ChatGPT 账号,看会员代充;要在国内直接用,看 GPT 镜像;要在 IDE 里写代码,看 AI 编程中转。