| 方法 | 路径 | 用途 |
|---|---|---|
HEAD |
/ |
存活探测 |
GET |
/ |
人类可读的落地页(版本 + 端点列表) |
GET |
/health |
健康检查 —— {"status":"ok","version":"x.y.z"} |
GET |
/v1/models |
模型发现 —— 返回你的 [[models]] 条目 |
GET |
/routes |
shunt 原生路由发现 —— 逐字返回配置的 [[routes]] 表(model → provider/upstream_model/effort 映射,包括 claude 前缀的发现别名);区别于 /v1/models,后者提供更窄的 Anthropic 协议发现响应(仅 id/display_name) |
POST |
/v1/messages |
推理 —— 按请求的 model id 路由 |
POST |
/v1/messages/count_tokens |
Token 计数 |
GET |
/admin |
管理仪表盘(HTML);未登录时重定向到 /admin/login |
GET, POST |
/admin/login |
管理员 token 登录表单与浏览器会话创建 |
POST |
/admin/logout |
清除浏览器会话 |
GET |
/admin/accounts |
Claude 账户存储元数据:名称、类型、过期时间和 UUID;绝不返回 token 材料 |
GET |
/admin/accounts/codex |
Codex 账户存储元数据:名称、过期时间和 ChatGPT 账户 ID;绝不返回 token 材料 |
GET |
/admin/pool |
claude_oauth / chatgpt_oauth provider 的池状态;Codex 不发送配额 header,因此使用率字段为空 |
POST |
/admin/accounts/claude |
用 {name, mode} 开始 Claude 浏览器预配;mode 为 oauth 或 setup_token,省略时默认为 setup_token;返回 {authorize_url} |
POST |
/admin/accounts/claude/{name}/complete |
用包含 <code>#<state> 的 {code} 完成 Claude 预配;存储账户并报告其是否生效 |
DELETE |
/admin/accounts/claude/{name} |
删除指定 Claude 账户的存储文件 |
POST |
/admin/accounts/codex |
用 {name} 开始 ChatGPT OAuth;返回 {authorize_url} |
POST |
/admin/accounts/codex/{name}/complete |
用包含完整 localhost redirect URL 或 <code>#<state> 的 {code} 完成 Codex 预配 |
DELETE |
/admin/accounts/codex/{name} |
删除指定 Codex 账户的存储文件 |
POST |
/backend-api/codex/responses |
入站 Codex CLI 透传 —— 镜像真实 ChatGPT 后端路径 |
POST |
/responses |
入站 Codex CLI 透传 —— 裸 base_url 形式 |
POST |
/v1/responses |
入站 Codex CLI 透传 —— 带 /v1 后缀的 base_url 形式 |
POST |
/backend-api/codex/analytics-events/events |
Codex CLI 分析 sink —— 接收后丢弃，仅记录净化后的事件名称计数器 |
POST |
/codex/analytics-events/events |
Codex CLI 分析 sink —— 根路径式 chatgpt_base_url 形式 |
/admin* 路由仅在配置了 [server.admin] 时存在;没有该表时,它们一个都不会注册。
入站 Codex Responses 和分析路由仅在配置了 [server.codex_endpoint] 时存在。Responses 路由逐字中继 OpenAI Responses 请求和响应。两个分析路由采用相同的入站认证策略，不转发或保留客户端 payload，并在认证后对无效 JSON 或超大正文也返回 200 {}。只有净化后的事件名称会记录到 shunt.codex_client_events；未配置指标 sink 时，它们是纯丢弃 sink。
即使启用了 [server.auth],GET / 和 GET /health 也保持开放(健康检查工具通常无法附带 token),并且不暴露任何敏感信息 —— 只有状态、版本以及已经公开的端点列表。
网关协议
shunt 实现官方的 Claude Code LLM 网关协议:正确的头部和正文字段转发、特性透传以及系统提示归属处理。网关自身产生的错误以 Anthropic 错误形状返回,上游上下文溢出错误被重写为 Anthropic 的 prompt is too long 措辞,以便触发 Claude Code 的 压缩并重试,而流式响应无缓冲地中继(带可选的 keepalive ping)。