Recurdream Docs

切换深浅色

客户端接入 - Codex ​

本文介绍如何通过 ccswitch 接入 Codex，并配置两种常用模式：

  • Codex 编程：用于日常读代码、改代码、写测试、跑项目。
  • Codex 生图：用于调用生图模型，根据提示词生成图片。

推荐把两种模式分别做成两个供应商预设。平时写代码使用 Codex 编程，需要生成图片时切换到 Codex 生图，这样不用反复手动修改 config.toml。

一、准备工作 ​

开始前请确认你已经具备：

  1. 一个可用的 API 中转站账号，可见快速开始和充值与计费。
  2. 一枚可用的 API Key。
  3. 已安装 Codex CLI 或 Codex 桌面端。
  4. 已安装并打开 ccswitch。
  5. 中转站支持 OpenAI Responses 格式接口。

常见接口信息如下：

text
API Key:  sk-xxxxxxxxxxxxxxxx
Base URL: https://api.recurdream.com

如果你的后台显示的是 https://api.recurdream.com/v1，也可以直接填写后台提供的完整地址。实际以控制台显示为准。

二、配置 Codex 编程 ​

Codex 编程 用于正常的 AI 编程任务，例如解释项目、修改代码、生成脚本、修复报错、编写测试等。

在 ccswitch 中按以下步骤配置：

  1. 打开 ccswitch。
  2. 进入 Codex 客户端配置。
  3. 点击添加供应商或编辑已有供应商。
  4. 供应商名称建议填写：
text
Codex 编程
  1. 填写 API Key。
  2. 填写 API 请求地址：
text
https://api.recurdream.com

如果使用后提示接口路径错误，可以改成：

text
https://api.recurdream.com/v1
  1. 模型名称选择适合编程的模型，例如：
text
gpt-5.5

或：

text
gpt-5.3-codex-spark
  1. 保存配置。
  2. 回到主界面，启用 Codex 编程。
  3. 重启 Codex 或重新打开终端。

配置完成后，可以在项目目录中启动 Codex：

bash
codex

输入测试任务：

text
解释一下这个项目的目录结构，并指出入口文件在哪里

如果 Codex 能正常分析项目，说明 Codex 编程 已接入成功。

三、配置 Codex 生图 ​

Codex 生图 用于调用图片生成模型。适合生成封面图、海报图、产品示意图、文章配图、视觉素材等。

在 ccswitch 中再新建一个供应商预设：

  1. 打开 ccswitch。
  2. 进入 Codex 客户端配置。
  3. 点击添加供应商。
  4. 供应商名称建议填写：
text
Codex 生图
  1. 填写同一枚 API Key，或填写专门用于生图的 API Key。
  2. API 请求地址填写：
text
https://api.recurdream.com

如果接口要求完整路径，则填写：

text
https://api.recurdream.com/v1
  1. 模型名称选择：
text
gpt-image-2
  1. 保存配置。
  2. 需要生图时，在 ccswitch 主界面切换到 Codex 生图。
  3. 重启 Codex 或重新打开终端。

进入 Codex 后，可以输入类似下面的任务：

text
使用 gpt-image-2 生成一张 1024x1024 的图片：一张适合小红书封面的科技感海报，主题是 AI 编程工具，画面包含电脑、代码界面、蓝紫色霓虹光效，文字区域保持干净，保存为 cover.png。

也可以生成产品图或插画：

text
生成一张 1024x1024 的图片：白色极简风格的 AI API 控制台产品宣传图，界面干净，适合放在教程封面，保存为 api-cover.png。

如果 Codex 返回图片文件并保存到当前目录，说明 Codex 生图 已接入成功。

四、两种模式怎么切换 ​

建议日常这样使用：

  • 写代码、改项目、查报错：切换到 Codex 编程。
  • 生成封面、海报、配图：切换到 Codex 生图。

每次在 ccswitch 中切换供应商后，建议关闭当前 Codex 窗口或终端，再重新打开。这样可以确保新的模型和接口配置已经生效。

五、常见问题 ​

1. 选了生图模型后，Codex 不会正常写代码 ​

这是正常现象。gpt-image-2 是图片生成模型，主要用于生成或编辑图片，不适合作为日常编程模型使用。

解决方法：

  • 写代码时切回 Codex 编程。
  • 生图时再切到 Codex 生图。

2. 提示模型不存在 ​

通常是模型名称填写错误，或当前中转站没有开放该模型。

请检查：

  • 模型名是否为 gpt-image-2。
  • 中转站后台是否能看到该模型。
  • 当前 API Key 是否有该模型权限。

3. 提示 401 或鉴权失败 ​

通常是 API Key 无效、复制不完整或余额不足。

请检查：

  • API Key 是否完整。
  • API Key 是否仍然有效。
  • 中转站账号余额是否充足。
  • 是否把测试 Key 删除或重置过。

4. 提示 404 或接口路径错误 ​

通常是 API 请求地址填写方式和中转站要求不一致。

可以在下面两个地址之间切换测试：

text
https://api.recurdream.com
text
https://api.recurdream.com/v1

以实际可用的地址为准。

5. 切换后仍然使用旧模型 ​

请重启 Codex 或重新打开终端。ccswitch 会更新 Codex 配置文件，但已经打开的 Codex 会话可能仍然沿用旧配置。

六、安全建议 ​

  • 不要把 API Key 发到公开群、文档、截图或视频里。
  • 录教程时建议使用临时 Key，录完后立即删除或重置。
  • 如果截图中不小心露出 Key，请立刻去后台重置。
  • 团队使用时建议给不同成员分配不同 Key，方便限额和统计。

七、推荐配置总结 ​

使用场景ccswitch 预设名称推荐模型
日常编程Codex 编程gpt-5.5 / gpt-5.3-codex-spark
图片生成Codex 生图gpt-image-2

一句话总结：

text
写代码用 Codex 编程，生成图片用 Codex 生图，需要哪个就在 ccswitch 里切哪个。

Recurdream 官方使用文档

Copyright © 2026 Recurdream