1. codex login 卡住时，先把模型通道定下来

1.1 原文速查表里 login 和 config 为什么容易混

原始速查表把 codex login、codex logout、codex whoami 放在基础全局命令里，又把 codex config edit、codex config list 放在配置相关里。这种分法本身没错，但实际使用时，登录态和模型通道是两套东西：codex login 管的是账号身份，codex config 管的是请求往哪个地址发、用哪个模型 ID。你如果只跑了 codex login，却没有在配置文件里声明自定义 provider，Codex CLI 仍然可能默认走官方通道，或者在启动时提示模型不可用。

更常见的卡点发生在公司电脑或已经登录过官方账号的环境里。你执行 codex whoami 看到的是一个旧账号，执行 codex config list 又只看到默认配置，于是开始怀疑是不是 Key 没生效。其实要先做的是把「身份」和「通道」拆开：身份可以用 codex logout 清掉，通道则通过 ~/.codex/config.toml 里的 model_provider 和 base_url 重新指向 TaoToken。原文里的 codex config edit 仍然是打开配置文件的命令，只是这次编辑的内容要换成下面这套 provider 配置。

1.2 去 TaoToken 创建 Key，拿到 Base URL

在改任何配置文件之前，先处理凭证。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，注册并进入控制台，创建一把 API Key。创建时建议按用途命名，比如 codex-cli-dev，这样以后在用量页面看到异常调用也能对上号。Key 只显示一次，复制后先放到密码管理器或本地环境变量里，不要直接写进会提交到 Git 的脚本。

这一步对应原文「登录/重新登录」的位置，但动作从「在终端里等浏览器授权」变成了「在网页上拿 Key」。TaoToken 在这里承担的是统一 API 通道的角色：你拿到一把 Key，再把它交给 Codex CLI。模型 ID 不要凭记忆写，去模型广场看当时列表里可用的名称；本文所有示例里的模型 ID 都用 YOUR_MODEL_ID 占位，你替换成模型广场里实际存在的那个即可。

1.3 把 Codex CLI 的 provider 写进 ~/.codex/config.toml

Codex CLI 的自定义通道写在 ~/.codex/config.toml。如果你之前没建过这个文件，直接新建；如果已有内容，保留原有格式，只追加 model_provider 和 [model_providers.taotoken] 这一段。注意 Base URL 填 https://taotoken.net/api，末尾不要加 /v1，也不要在这里带任何查询参数。Key 通过环境变量传入，配置文件里只写环境变量名。

保存后，在 shell 里导出 Key。临时测试可以用下面这种写法，长期使用建议写进 ~/.zshrc 或 ~/.bashrc，但不要把真实 Key 提交到仓库。

如果你更习惯让 Codex CLI 直接读 auth.json，可以先确认当前版本是否支持该方式；本文以 config.toml 加环境变量的写法为准。配置完成后不要急着改代码，先跑 codex config list 看输出里有没有 model_provider = "taotoken"，再用 codex whoami 确认当前登录态不会覆盖自定义 provider。

2. 基础全局命令：codex --version、codex whoami、codex logout

2.1 先确认版本和当前登录态

原文第一条是 codex --version，这条命令在排障时比想象中重要。不同版本的 Codex CLI 对 model_providers 的支持程度不一样，如果你在 config.toml 里写了自定义 provider，但启动时仍然走默认通道，先看版本号是否过旧。接着执行 codex whoami，它回答的是「当前 CLI 认为你是谁」，而不是「当前请求发往哪里」。所以看到旧账号不要慌，执行 codex logout 把官方登录态清掉，再重新打开终端让新的环境变量生效。

codex logout 只清登录态，不会删你的 config.toml。清完之后再跑一次 codex whoami，如果提示未登录或不再显示旧账号，说明身份层的干扰已经排除。此时 Codex CLI 会更多依赖配置文件里的 model_provider 和环境变量里的 Key。原文把 codex app 放在基础命令里，那是桌面版入口；如果你只使用终端，可以跳过，不影响后续命令。

2.2 codex whoami 看不到期望通道时怎么查

codex whoami 不一定会直接展示 Base URL，所以不能只靠它判断通道。更可靠的做法是组合检查：先 codex config list 看 model_provider 和 model，再确认当前 shell 里 echo $TAOTOKEN_API_KEY 有值。如果环境变量为空，Codex CLI 即使读到了 provider，也会在请求时因为缺少 Key 而失败。

还有一种情况是配置文件路径不对。Codex CLI 默认读用户目录下的 ~/.codex/config.toml，如果你在项目目录里放了同名文件，CLI 不一定优先读取。用 codex config edit 打开它实际读取的那个文件，看看内容是否和你刚写的一致。这一步对应原文「打开配置文件」，只是我们把编辑目标从默认配置改成了 TaoToken provider 配置。

3. 核心对话命令：codex start、codex reset、codex clear 怎么配合项目

3.1 在当前项目里启动会话

原文把 codex start 标成「在当前项目下 AI 辅助开发（最常用）」，这个判断很准。配置好通道后，进入你的项目根目录，再执行 codex start。它启动的是一个持续会话，后续的 codex edit、codex diff 都会在这个项目上下文里工作。如果你直接运行不带参数的 codex，那是一次性提问，适合解释语法或写小片段；要改项目文件，还是用 codex start 更稳。

启动后可以先问一个低风险问题，比如让 Codex 解释当前目录下某个模块的入口函数。这样做有两个目的：一是确认模型通道真的通了，二是让会话先加载项目结构。如果这一步就报 401 或 404，不用继续后面的编辑命令，直接跳到本文第 6 节的报错对照。如果它能正常回答，说明 Base URL、Key、模型 ID 这三项至少已经对上了。

3.2 上下文重置与历史清空

codex reset 和 codex clear 经常被混用。按原文的标注，codex reset 是重置当前会话上下文，codex clear 是清空所有会话历史。实际使用时可以这样理解：如果你只是想让当前对话忘记刚才讨论的临时方案，用 codex reset；如果你准备切换项目，或者会话历史已经太长导致响应变慢，用 codex clear 更彻底。两者都不会动你的代码文件，也不会改 config.toml。

有一点要注意：清空历史不会清掉环境变量里的 Key。如果你在排障时怀疑配置串了，可以先用 codex reset 开一段干净对话，再跑一条简单请求。这样即使模型回答不符合预期，也能排除旧上下文干扰，把问题定位到配置层或模型层。

4. 文件编辑三件套：codex edit 文件名.py、codex diff、codex accept/reject

4.1 codex edit 的正确打开方式

原文给的例子是 codex edit 文件名.py 帮我加参数校验和异常捕获，这个格式比纯文字描述精准很多。实际使用时，文件名要写相对项目根目录的路径，比如 services/user_service.py。描述里最好带上约束：是加类型校验还是加 try/except，异常要抛出还是记录日志，是否允许改动函数签名。你给的信息越具体，codex diff 出来的改动越接近可直接接受的状态。

codex edit 本身只负责生成修改建议，不会直接覆盖你的文件。它会把改动放进 diff 视图，等你用 codex accept 或 codex reject 决定。这一点和很多编辑器插件不同：Codex CLI 把最终决定权留给命令行里的你。配置 TaoToken 之后，这个流程不变，变的只是模型请求发往 https://taotoken.net/api，命令行为本身仍由 Codex CLI 控制。

4.2 codex diff 复盘，再决定 accept 还是 reject

codex diff 是速查表里最值得养成的习惯。看到模型说「已修改」不算数，要打开 diff 逐段看：变量名有没有被改乱，异常处理有没有吞掉不该吞的错误，格式化是否引入无关变更。如果改动符合预期，执行 codex accept 应用全部修改；如果只是部分可用，可以先 codex reject 放弃，再把需求拆小，重新执行 codex edit。

这里要强调一次：TaoToken 不替代 codex edit、codex diff、codex accept、codex reject 这些命令。它提供的是 Key 和 Base URL，让 Codex CLI 的请求有地方可去。命令的语义、diff 的生成方式、接受或放弃的决策，仍然由 Codex CLI 和你的判断完成。把这两层分清楚，排障时就不会把「模型没返回」和「diff 逻辑不对」混成一类问题。

5. 上下文与配置管理：codex context add/list/remove、codex config edit/list

5.1 把项目目录加进上下文

原文的 codex context add . 是把当前目录加入项目上下文，codex context list 查看已加载文件，codex context remove 文件名 移除某个文件。这三个命令在大型项目里很实用：你不需要让模型每次扫描整个仓库，而是手动把关键目录和文件喂进去。比如只加 src/ 和 tests/，不加 node_modules/ 或 dist/，既省 token，也减少模型被无关文件干扰的概率。

执行 codex context add . 之后，最好再用 codex context list 确认一遍。如果列表里出现大量自动生成文件，及时用 codex context remove 移除。这个动作和 TaoToken 的用量也有关：上下文越干净，单次请求消耗越可控。你可以在控制台看每次调用的用量记录，再回头调整 context add 的范围。

5.2 配置查看与再次编辑

codex config list 是查看当前配置的只读命令，codex config edit 是打开配置文件继续编辑。配好 TaoToken 之后，建议把这两条命令当成日常检查项：升级 Codex CLI 后跑一次 codex config list，确认 model_provider 没有被重置；换项目或换模型 ID 时，用 codex config edit 改完再 codex config list 复查。不要只改环境变量就以为万事大吉，文件里的 model 字段同样会影响请求。

如果你在 config.toml 里写了 env_key = "TAOTOKEN_API_KEY"，那么环境变量名必须和这里完全一致。大小写不同、拼写多一个下划线，都会导致 Codex CLI 找不到 Key。最稳妥的验证方式是：开一个新终端，先 echo $TAOTOKEN_API_KEY，再 codex config list，最后 codex start 发一条消息。三步都通过，才说明配置链路完整。

6. 验证请求有没有走 TaoToken：从 codex start 到 codex diff

6.1 跑一条最小编辑任务

验证不要一上来就改核心文件。新建一个 test_codex.py，内容只写一个简单函数，然后执行：

如果 codex diff 能正常展示改动，并且改动内容合理，说明请求已经走通。此时你可以用 codex accept 应用，或者 codex reject 放弃后再试更复杂的任务。确认没问题后，回到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的控制台，看看这次调用是否记上了账。用量记录里通常会显示模型、时间、token 数，如果你看到记录，就说明 Codex CLI 确实通过 TaoToken 发出了请求。

6.2 常见报错对照：401、404、base_url 多了 /v1

401 一般指 Key 无效或没传进去。先检查 echo $TAOTOKEN_API_KEY 是否为空，再检查 config.toml 里的 env_key 是否和变量名一致。如果 Key 是从别处复制来的，注意有没有带空格或换行。重新在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建一把新 Key 替换测试，是最快的排除法。

404 通常和模型 ID 或 Base URL 有关。模型 ID 必须去模型广场核对，不要自己拼日期后缀或版本号。Base URL 必须是 https://taotoken.net/api，末尾不要加 /v1。有些工具默认会在后面拼 /v1/chat/completions，如果你手动又加了 /v1，最终路径会变成 /api/v1/v1/...，服务端只能返回 404。改完配置后记得重开终端，让 Codex CLI 重新读取环境变量和配置文件。

7. 把速查表用顺：常用命令串成工作流

7.1 一次改文件的完整节奏

把上面的命令串起来，一次典型的 Codex CLI 工作流是这样的：进入项目目录，codex start 启动会话；用 codex context add . 加入源码目录；用 codex edit 文件名.py 具体需求 生成修改；用 codex diff 逐段检查；确认后 codex accept 应用，不满意就 codex reject 重来；任务结束后用 codex reset 清理上下文，或 codex clear 清空历史。需要换模型时，用 codex config edit 改 model 字段，再 codex config list 复查。

这套流程里，TaoToken 只在两个位置出现：创建 Key，以及把 Base URL 写进 config.toml。其余命令都是 Codex CLI 自身的功能。把边界记清楚，你就不容易在报错时乱改配置。比如 diff 不符合预期，先看提示词是否具体，而不是去改 Base URL；请求不通，才回头检查 Key、模型 ID 和地址。

7.2 下一步：去控制台看用量，按需升级

配通之后，建议用同一把 Key 在 TaoToken 模型对话 里发一条测试消息，确认模型 ID 和通道都没填错。如果你准备长期用 Codex CLI 写代码，可以打开 Coding Plan 看套餐是否覆盖日常用量；Key 不够用时，在 控制台 API Keys 里再创建一把专门给 CLI 用。速查表里的命令不会变，变的是你不用再为登录和通道配置反复试错。