把连接设置好，
回到你想做的事。

第一次使用 Codex，从这里开始

1. 从OpenAI 官方快速入门 ↗进入官方安装入口，安装适合 Windows 的桌面应用。当前官方界面可能显示为 ChatGPT 桌面应用，在应用选择器中选择 Codex；以你安装的版本为准。
2. 准备一个专用项目文件夹。首次尝试建议使用空文件夹或副本，不要直接选择包含重要资料的整个用户目录。
3. 从CC Switch 官方发布页 ↗安装并打开一次 CC Switch，再按下文创建豆苗密钥和添加提供商。
4. 在 CC Switch 手动启用“豆苗 API”，退出并重开 Codex，选择项目文件夹并新建对话。
5. 先请求“请回复连接成功”，在豆苗使用记录确认调用；再尝试“请介绍这个项目，暂时不要修改文件”。需要修改文件或执行命令时，请按任务需要确认权限。

官方依据：快速入门 · 项目和聊天。说明核对日期：2026-09-17。

创建属于你的 API 密钥

1. 登录豆苗 API 密钥管理，点击添加令牌或创建密钥。
2. 名称建议填写“我的 Codex”。选择能访问目标模型的分组；当前常用分组为 default，以账号实际选项为准。
3. 按使用计划设置额度与有效期。若设置模型限制，需包含准备使用的模型；不确定时先保留控制台默认值。
4. 保存后，在密钥列表中复制完整密钥。带星号的遮盖文字不能用于调用。

推荐：用助手添加到 CC Switch

1. 确认 Windows 10 / 11 已安装 Codex 和 CC Switch。打开豆苗配置助手下载页，阅读说明并下载。
2. 运行助手，粘贴自己的完整豆苗平台密钥。API 地址会自动填好，不需要输入服务器 IP。
3. 读取并选择可用模型，点击“添加到 CC Switch”。在 CC Switch 里核对应用为 Codex、名称为“豆苗 API”、地址为本站固定域名，再确认导入。
4. 保存好当前工作，手动启用“豆苗 API”。导入默认不自动切换，避免打断正在运行的对话。
5. 退出并重新打开 Codex，新建对话验证回复；需要切回原提供商时在 CC Switch 中选择原配置。

希望以后从网页一键打开？首次运行时点击“启用网页一键配置”，注册当前 Windows 用户的本机协议。之后在浏览器接入工具或控制台选择密钥与模型，点击打开豆苗助手，在本机再次核对。网页仅在你点击时通过 doumiaoapi:// 传递配置；无法唤起时可手动粘贴密钥。

密钥保存在本机配置中，请妥善保管配置与备份。程序当前未代码签名；如果安全软件阻止运行，请先核对来源或联系管理员，不要关闭安全保护。

方式 B：先在浏览器验证连接

1. 打开豆苗接入工具，粘贴刚复制的平台密钥。
2. 点击“读取可用模型”。工具只向本站 /v1/models 发请求，并显示这把密钥返回的模型列表。
3. 选择要在 Codex 中使用的模型。可用时优先预选 gpt-6-astra；没有时从你实际可用的模型中选择。
4. 点击“测试流式连接”。这会发送一条简短请求，产生少量正常模型用量。看到 response.completed 说明本次文本流式请求完成。

管理员的渠道测试成功，只证明那条测试路径可用；Codex 使用 Responses 接口，因此这里会单独验证它。文本测试也不替代 Codex 实际任务与工具调用的最终验证。独立助手用户也可以在这里单独诊断，但不必再执行 CC Switch 导入。

经助手添加到 CC Switch

1. 先从CC Switch 官方发布页 ↗安装适合你电脑的版本，并至少打开一次应用。
2. 在网页读取模型后，点击“打开豆苗配置助手”。首次使用须先运行助手并启用网页一键配置；浏览器提示打开外部应用时确认打开。
3. 在助手中核对模型，点击“添加到 CC Switch”。助手先检查原有配置；如提示无法安全保留，请停止并先处理提示。在 CC Switch 中确认应用为 Codex、名称为 豆苗 API、接口地址为下面的域名，再确认添加。
4. 导入默认不会自动切换正在使用的提供商。在 CC Switch 的 Codex 页面，手动启用“豆苗 API”。

网页只通过 doumiaoapi:// 将所选配置交给本机助手，不直接调用 CC Switch。密钥不写入网页地址、日志或浏览器本地存储；完成后可点击“清除密钥”。不使用助手时，可自行在 CC Switch 手动添加地址与密钥，并事先备份当前配置。

打开 Codex，发起新任务

1. 确认已安装 Codex。默认路线经豆苗助手添加到 CC Switch，请确认已手动启用“豆苗 API”；只有高级直接写入路线需确认配置已应用。
2. 彻底退出后重新打开 Codex，新建一个任务或对话。已有任务可能继续使用原连接。
3. 发送简单请求，例如“请回复连接成功”。
4. 在豆苗使用记录核对这次请求，确认模型、分组和用量符合预期。

连接失败，先看哪一步

遇到 stream disconnected before completion: builder error，先核对 HTTPS 地址、完整密钥和新会话使用的配置，再看实际请求日志；这一句话不能单独证明密钥创建错误。

读懂价格与额度

模型广场显示当前站点定价。输入、输出、缓存读取和缓存创建可能分别计费；部分模型还按上下文长度分档。不要只比较模型倍率，也不要把平台额度 $直接等同于人民币实付款。

例如，阶梯计费模型会在不同上下文区间采用不同单价。接入工具不会修改你的分组、充值套餐或额度设置；每次调用的实际扣费请查看使用记录。

缓存：固定前缀，区分命中与价格

把重复使用的固定资料放在请求前面，把每次变化的问题放在后面；连续调用尽量保持模型、工具定义与推理设置一致。这有利于复用相同前缀，但不保证命中。

以下报告是一次受控小样本：同一模型的三次普通请求，与三次固定前缀显式缓存请求。优化组保留首次冷启动，另外两次热请求的结果不能直接视为所有请求的命中率。报告来自完整 Responses 结束事件的 usage，并未缓存或复用模型回答。

{
  "model": "gpt-6-astra",
  "reasoning": { "effort": "low" },
  "prompt_cache_key": "non-sensitive-user-session-id",
  "prompt_cache_options": { "mode": "explicit", "ttl": "30m" },
  "input": [
    {
      "role": "developer",
      "content": [{
        "type": "input_text",
        "text": "此处放至少 1024 tokens、保持不变的固定资料……",
        "prompt_cache_breakpoint": { "mode": "explicit" }
      }]
    },
    { "role": "user", "content": "这里放本次变化的问题" }
  ],
  "stream": true
}

本次结果不足以证明响应延迟一定降低，也不能代表所有模型和用户。本站不自动改写用户提示词，不将不同请求的回答当作缓存直接返回；请按自己的工作负载验证。

查看脱敏测量数据（JSON）↗。记录仅包含日期、模型和用量计数，不包含 API 密钥或真实业务提示词。

以后换 IP，地址保持不变

CC Switch 和 Codex 始终使用 https://www.doumimiai.cn/v1。迁移时需完成：

1. 备份并迁移数据库与持久化数据，保留用户、原密钥、余额、渠道及计费设置。
2. 迁移应用配置，配置新服务器的 HTTPS 证书和反向代理，确认 Responses 流式响应可用。
3. 验证数据与旧密钥后，再更新域名解析到新服务器，并检查实际用量记录。

仅修改 DNS 不会迁移数据库或保留原密钥。只要域名与原数据完整保留，客户端一般无需重新配置；解析切换期间仍可能存在短暂延迟。