Flex247 Docs

简体中文

English
Bahasa Malaysia

简体中文

English
Bahasa Malaysia

外观

CC Switch 接入 Flex AI ​

CC Switch 是一个跨平台的第三方桌面工具，用于管理 Claude Code、Codex、OpenCode 等应用的供应商配置，并可通过本地路由服务记录请求、统计用量和执行故障转移。

只从官方渠道下载

CC Switch 官方文档明确建议只使用 ccswitch.io、GitHub Releases 或项目源码仓库。不要向非官方安装包提供 API Key 或登录凭据。

1. 安装 ​

  • Windows：下载 Windows.msi，或使用 Windows-Portable.zip 免安装版。
  • macOS：下载 .dmg，或执行 brew install --cask cc-switch。
  • Linux：选择 .deb、.rpm 或 .AppImage。

安装后先确保 Codex 已安装并至少启动过一次。

2. 添加 Flex247 供应商 ​

  1. 在 CC Switch 顶部选择 Codex。
  2. 点击右上角 +。
  3. 选择 应用专属供应商，再选择 自定义。
  4. 填写以下参数。
字段填写内容
名称Flex247
API Endpoint / Base URLhttps://api.noflex.work/v1
API Key你的 Flex247 专用密钥
Wire API / API 格式Responses
模型模型广场中的完整 Responses 模型 ID
需要本地路由映射关闭；只有上游仅支持 Chat Completions 时才开启

填写 API Key 与端点后，可以点击模型输入框旁的 获取模型。CC Switch 会调用 /v1/models 并让你直接选择模型。

CC Switch 新增 Codex 供应商官方界面截图
图 1：CC Switch 官方 Codex 供应商表单示例。截图中的名称、端点和模型仅为官方示例；接入本站时请按上表替换成 Flex247 参数。图片来自项目官方仓库。

推荐先测试 gpt-5.6-luna，或从模型广场选择其他支持 Responses API 的模型。

3. 保存并切换 ​

  1. 保存供应商。
  2. 在主界面选中 Flex247，点击 启用 / Enable。
  3. 重新启动 Codex 或打开新的终端窗口。
  4. 发送一个只读测试请求，并在 Flex247 使用日志中确认调用。

如果自定义页面要求手动编辑 Codex 配置，核心内容如下；API Key 仍应保存在 CC Switch 的密钥字段中，不要写进公开文件。

toml
model = "gpt-5.6-luna"
model_provider = "flex247"

[model_providers.flex247]
name = "Flex247"
base_url = "https://api.noflex.work/v1"
wire_api = "responses"
requires_openai_auth = true

4. 可选：开启本地路由 ​

需要请求日志、用量统计或故障转移时：

  1. 打开 设置 → 高级 → 路由服务。
  2. 启动路由服务。
  3. 在 应用路由区域开启 Codex 路由。

开启后，Codex 会连接 CC Switch 的本地入口，默认形如 http://127.0.0.1:15721/v1，再由 CC Switch 转发至 Flex247。不要把本地地址误填回 Flex247 供应商的上游 Base URL。

CC Switch Codex 本地路由官方界面截图
图 2：CC Switch 官方文档中的 Codex 本地路由界面；开启后请使用界面显示的本地地址。图片来自项目官方仓库。

Chat Completions 模型 ​

如果目标模型只支持 /v1/chat/completions：

  1. 将供应商协议改为 Chat Completions。
  2. 开启 需要本地路由映射。
  3. 配置 Codex 模型映射并保持路由服务运行。

Codex 原生使用 Responses API，因此没有本地协议转换时，Chat Completions 模型不能直接工作。

常见问题 ​

获取不到模型 ​

检查 API Key、Base URL 和账户余额；Base URL 应是 https://api.noflex.work/v1。

启用后没有生效 ​

重新启动 Codex 与终端，并确认 CC Switch 当前应用面板是 Codex，不是 Claude Code 或其他应用。

本地路由显示未运行 ​

先在高级设置启动路由服务，再开启 Codex 路由。确认本机 15721 端口未被其他程序占用。

官方参考 ​