Claude/Codex API Smart Router

统一代理 Claude 与 Codex 请求的 Cloudflare Worker：

Claude 路由支持多端点按优先级切换（/v1/messages、/v1/chat/completions 等）
Codex 路由支持单端点主备源重试（/codex/v1）
对 4xx/5xx 与网络异常自动故障转移，并保持上游接口兼容

🎁 获取 API Key - 注册获取 Claude/Codex API 访问权限

📘 Claude Code 配置指南 - 查看如何在 Claude Code CLI 和 VSCode 扩展中使用

功能特性

价格优先: 按价格从低到高排序（ultra < super < claude）
指定端点路由: 支持通过路径指定优先使用的端点（如 /claude/ultra/v1/messages）
OpenAI 兼容接口: 支持 OpenAI Chat Completions API 格式，自动转换为 Claude API
智能故障转移: 遇到 4xx/5xx 错误自动切换到下一个端点
双源互备: 主源 (newcli) 和备源 (dm-fox) 相互备份，单个端点失败时先尝试备源的相同端点
Codex 兼容代理: 支持 /codex/v1 路由主备重试；/responses 透传，/chat/completions 自动格式转换
跨协议备用: Claude 全挂时自动切换到 Codex，Codex 全挂时自动切换到 Claude（自动协议转换）
内存状态管理: 使用全局内存缓存记录端点健康状态（同一实例内共享）
自动冷却: 连续失败 3 次的端点会被标记为不可用 1 分钟
自动恢复: 冷却期结束后端点自动恢复可用
零成本: 完全免费运行

快速开始

部署 Worker（见下方部署步骤）
获取你的 Worker URL：https://your-worker.workers.dev（建议绑定自定义域名）
配置 Claude Code，编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的API Key",
    "ANTHROPIC_BASE_URL": "https://your-worker.workers.dev"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

开始使用！Claude 请求会自动选择可用端点，Codex 请求走 /codex/v1 主备源重试

提示：

Claude 默认使用自动路由，从最低价层级（ultra）开始尝试
Codex 统一使用 https://your-worker.workers.dev/codex/v1/... 路径
Claude Code 可通过 x-force-codex: true 强制走 GPT/Codex
你也可以指定 Claude 特定端点，如 https://your-worker.workers.dev/claude/ultra
Claude Code 详细配置请查看 Claude Code 配置指南

部署步骤

1. 安装 Wrangler CLI

npm install -g wrangler

2. 登录 Cloudflare

wrangler login

3. 部署 Worker

wrangler deploy

部署成功后会得到一个 URL，类似：https://claude-api-router.your-subdomain.workers.dev

4. 绑定自定义域名（推荐）

⚠️ 重要: workers.dev 域名在中国大陆无法访问，强烈建议绑定自定义域名。

在 Cloudflare Dashboard 中打开你的 Worker
进入 Triggers 标签页
点击 Add Custom Domain
输入你的域名（如 api.yourdomain.com）
Cloudflare 会自动配置 DNS 和 SSL 证书

绑定后使用自定义域名：https://api.yourdomain.com

使用方法

按路由类型使用：

Claude：/v1/messages、/v1/chat/completions、/claude/*
Codex：/codex/v1/*

Claude 路由：自动路由（默认）

将所有 Claude API 请求发送到你的 Worker URL，Worker 会自动选择最便宜的可用端点：

curl https://your-worker.workers.dev/v1/messages \
  -H "x-api-key: your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

Worker 会自动：

优先尝试最低价层级端点（/claude/ultra）
默认不会自动升级到更高价层级（ultra/super/claude）
若请求头 x-ccr-tier: true，才会继续尝试更高价层级
所有允许范围内的 Claude 端点都失败时，自动切换到 Codex（协议自动转换）
记录失败状态，连续失败 3 次后暂时跳过该端点

可通过 Claude Code 的 ANTHROPIC_CUSTOM_HEADERS 注入开关头：

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "x-ccr-tier: true"
  }
}

ANTHROPIC_CUSTOM_HEADERS 格式为多行 Header: value： "Header1: value1\nHeader2: value2"

Claude 端点配置速查

下表中的“尝试顺序”表示 默认不加 x-ccr-tier: true 时的行为：

场景	`ANTHROPIC_BASE_URL`	`ANTHROPIC_CUSTOM_HEADERS`	默认尝试顺序
最省钱（推荐默认）	`https://your-worker.workers.dev`	不设置	`ultra`
固定从 ultra 开始	`https://your-worker.workers.dev/claude/ultra`	不设置	`ultra`
固定从 super 开始	`https://your-worker.workers.dev/claude/super`	不设置	`super -> ultra`
固定从 claude 开始	`https://your-worker.workers.dev/claude`	不设置	`claude -> ultra -> super`

如果要允许走更高等级端点，在 ANTHROPIC_CUSTOM_HEADERS 加： x-ccr-tier: true

Claude 路由：指定端点

通过在路径中指定端点名称，可以优先使用特定端点：

# 优先使用 ultra 端点
curl https://your-worker.workers.dev/claude/ultra/v1/messages \
  -H "x-api-key: your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, Claude"}
    ]
  }'

# 优先使用 super 端点
curl https://your-worker.workers.dev/claude/super/v1/messages \
  -H "x-api-key: your-api-key" \
  ...

支持的端点路径：

/claude/ultra/v1/messages - 优先使用 ultra 端点（最便宜）
/claude/super/v1/messages - 优先使用 super 端点
/claude/v1/messages - 优先使用 claude 端点（最高等级）
/v1/messages - 自动路由（默认行为）

Claude 路由：OpenAI 兼容接口

使用 OpenAI Chat Completions API 格式调用 Claude API，Worker 会自动进行格式转换：

curl https://your-worker.workers.dev/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'

OpenAI 接口支持的功能：

✅ 自动将 OpenAI 请求格式转换为 Claude Messages API 格式
✅ 自动将 Claude 响应格式转换为 OpenAI Chat Completions 格式
✅ 支持 system、user、assistant 角色
✅ 支持 temperature、top_p、max_tokens、stop 等参数
✅ 支持流式响应（stream: true），实时转换 SSE 格式
✅ 支持 /v1/models 接口获取可用模型列表
✅ 完整的端点路由和故障转移支持
✅ 自动过滤无效参数（如字符串 "[undefined]"）

指定端点的 OpenAI 格式调用：

# 优先使用 ultra 端点的 OpenAI 格式调用
curl https://your-worker.workers.dev/claude/ultra/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{...}'

获取可用模型列表：

curl https://your-worker.workers.dev/v1/models \
  -H "Authorization: Bearer your-api-key"

响应示例：

{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-4-6",
      "object": "model",
      "created": 1677652288,
      "owned_by": "anthropic"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1677652288,
      "owned_by": "anthropic"
    },
    {
      "id": "claude-haiku-4-5-20251001",
      "object": "model",
      "created": 1677652288,
      "owned_by": "anthropic"
    }
  ]
}

说明：

非流式和流式响应都会自动转换为 OpenAI 兼容格式（含 SSE）
建议直接用 OpenAI SDK/LangChain/LlamaIndex 按 OpenAI 方式接入

Codex 路由：透传代理 + Chat Completions 兼容

Codex 默认上游路由是 https://code.newcli.com/codex/v1。通过本 Worker 时，请使用相同路径前缀：

curl https://your-worker.workers.dev/codex/v1/responses \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-codex",
    "input": "Write a haiku about retries."
  }'

如果你希望在 Codex 路由下直接使用 OpenAI Chat Completions 格式，也可以调用：

curl https://your-worker.workers.dev/codex/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.3-codex",
    "messages": [
      {"role": "user", "content": "Write a haiku about retries."}
    ]
  }'

行为说明：

/codex/v1/models：返回 OpenAI Models 列表格式的 Codex 模型清单（用于 SDK 探活/模型枚举，含 gpt-5.4）
/codex/v1/models/{model}：返回单模型元数据（含 context_length/max_output_tokens 等字段，默认按 GPT-5 系列 400k/128k）
/codex/v1/responses：请求和响应都会原样透传，不做 Claude/OpenAI 格式转换
/codex/v1/chat/completions：自动转换为 Codex Responses 请求并将响应转换回 OpenAI Chat Completions（支持 SSE 与 tools/tool_calls）
先尝试主源 https://code.newcli.com，失败（4xx/5xx 或网络错误）后自动尝试备源 https://dm-fox.rjj.cc
当两个源都失败时，自动切换到 Claude 端点作为备用（协议自动转换）
如果仍然失败，优先返回最后一个上游错误响应体，保持 Codex 错误格式兼容

Claude Code 强制走 GPT（Codex）

如果你希望 Claude Code 请求不走 Claude 端点，而是直接走 Codex/GPT，可在 ~/.claude/settings.json 注入自定义头：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://your-worker.workers.dev",
    "ANTHROPIC_CUSTOM_HEADERS": "x-force-codex: true"
  }
}

验证示例：

curl https://your-worker.workers.dev/v1/messages \
  -H "x-api-key: your-api-key" \
  -H "Authorization: Bearer your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-force-codex: true" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "ping"}]
  }' -i

返回头中出现 X-Route-Type: codex-fallback 即表示已走 GPT/Codex。

说明：在 x-force-codex: true 模式下，/v1/messages 的 tools/tool_choice 会透传到 Codex，并将工具调用结果回转为 Claude tool_use 格式；stream: true 时返回 Claude SSE 事件流（不降级为 JSON）。另外，当 x-force-codex: true 且所有 Codex 源都失败时，会直接返回 Codex 错误响应（X-Fallback-Reason: forced-by-header），不会再回退到 Claude 路由。

调试

响应头中包含调试信息：

X-Route-Type: 路由类型（claude、codex、codex-fallback、claude-fallback）
X-Used-Endpoint: 实际使用的端点路径
X-Endpoint-Index: 端点索引（0=ultra, 1=super, 2=claude）
X-Used-Base-URL: 实际使用的基础 URL（主源或备源）
X-Base-URL-Index: 基础 URL 索引（0=主源 newcli, 1=备源 dm-fox）
X-Preferred-Endpoint: 请求指定的优先端点（如果有）
X-Format-Conversion: 格式转换标记（例如 OpenAI 或 openai-chat<->codex-responses）
X-Fallback-Reason: 跨协议备用原因（forced-by-header、all-claude-endpoints-failed 或 all-codex-sources-failed）
X-Allow-Higher-Tier-Fallback: 是否允许向更高等级端点降级（true/false）

说明：X-Used-Endpoint、X-Endpoint-Index、X-Preferred-Endpoint、X-Format-Conversion 主要用于 Claude/OpenAI 路由；Codex 路由重点查看 X-Route-Type、X-Used-Base-URL、X-Base-URL-Index。

查看日志：

wrangler tail

本地预演（wrangler dev）

为了避免“部署后才发现 Codex/Claude Code 不可用”，可以先在本地跑完整回归：

bash scripts/verify_local_wrangler_dev.sh

该脚本会自动：

启动本地 wrangler dev（默认 http://127.0.0.1:8787）
运行完整验证（/codex/v1/models、/codex/v1/chat/completions、tools、x-force-codex）
测试结束后自动关闭本地进程

可选环境变量：

CCR_LOCAL_PORT：本地端口（默认 8787）
WRANGLER_HOME_DIR：wrangler HOME 目录（默认 /tmp/wrangler-home-$USER，用于规避日志权限问题）

配置调整

修改 worker.js:24-32 中的配置：

const HEALTH_CHECK_CONFIG = {
  COOLDOWN_TIME: 60,     // 冷却时间（秒），默认 1 分钟
  MAX_FAILURES: 3,       // 触发冷却的连续失败次数
};

状态管理说明

存储方式: 使用全局内存缓存（Map）存储端点健康状态
共享范围: 同一 Worker 实例内的所有请求共享状态
成本: 完全免费，无任何限制
性能: 内存访问，零延迟
持久性: Worker 重启后状态重置，会自动重新学习端点健康状况

路由摘要

Claude/OpenAI 路由：/v1/messages、/v1/chat/completions、/claude/*
Codex 路由：/codex/v1/*
Claude 默认只尝试当前价格层级及以下，设置 x-ccr-tier: true 才允许更高层级
每个端点先试主源 code.newcli.com，再试备源 dm-fox.rjj.cc
Claude 全挂自动切 Codex；Codex 全挂自动切 Claude（协议自动转换）

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
scripts		scripts
tasks		tasks
.gitignore		.gitignore
CLAUDE_CODE_SETUP.md		CLAUDE_CODE_SETUP.md
README.md		README.md
worker.js		worker.js
wrangler.toml		wrangler.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Claude/Codex API Smart Router

功能特性

快速开始

部署步骤

1. 安装 Wrangler CLI

2. 登录 Cloudflare

3. 部署 Worker

4. 绑定自定义域名（推荐）

使用方法

Claude 路由：自动路由（默认）

Claude 端点配置速查

Claude 路由：指定端点

Claude 路由：OpenAI 兼容接口

Codex 路由：透传代理 + Chat Completions 兼容

Claude Code 强制走 GPT（Codex）

调试

本地预演（wrangler dev）

配置调整

状态管理说明

路由摘要

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Claude/Codex API Smart Router

功能特性

快速开始

部署步骤

1. 安装 Wrangler CLI

2. 登录 Cloudflare

3. 部署 Worker

4. 绑定自定义域名（推荐）

使用方法

Claude 路由：自动路由（默认）

Claude 端点配置速查

Claude 路由：指定端点

Claude 路由：OpenAI 兼容接口

Codex 路由：透传代理 + Chat Completions 兼容

Claude Code 强制走 GPT（Codex）

调试

本地预演（wrangler dev）

配置调整

状态管理说明

路由摘要

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages