tools.function.parameters is not a valid moonshot flavored json schema：Codex

Quick fix

升级到包含 #6863 修复的后续版本；它会将带同级关键字的 $ref 转为 Moonshot 可接受的 allOf。

Symptom

报错原文复制

CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Kimi For Coding; model: kimi-for-coding; upstream_status: HTTP 400; cause: tools.function.parameters is not a valid moonshot flavored json schema, details: <At path '$defs.__schema20': when using $ref, type should be defined in the referenced schema instead of the parent schema>

Cause

Codex 经 CC Switch 的 Responses → Chat 转换连接 Kimi/Moonshot 时，工具参数 schema 中可能出现 `$ref` 与 `type`、`format` 等同级关键字并存的 JSON Schema 2020-12 写法。Moonshot 的校验器拒绝该形式，因此上游返回 HTTP 400，导致该请求失败。

维护者说明该问题已在 `main` 的 #6863（commit `db41d7018`）修复：仅对 Moonshot/Kimi，将带同级关键字的 `$ref` 在转换后改写为 `allOf`，以保留描述和约束；维护者已端到端验证 HTTP 400 变为 200，并称将随下一版本发布。报告覆盖 cc-switch `3.19.2`、`3.20.0` 与 `3.20.1`；但线程中也有“依然没有修复”的未展开反馈，无法从原帖确认其使用的具体发布版本或复现条件。

Fix

1. 1

   升级到包含 #6863（commit `db41d7018`）修复的后续 cc-switch 发布版本。维护者称该修复会在 Moonshot/Kimi 转换工具 schema 时，将带同级关键字的 `$ref` 改写为 `allOf`。

2. 2

   升级后再次通过 Codex 经本地代理请求 Kimi For Coding；维护者的端到端验证显示该场景可从 HTTP 400 恢复为 HTTP 200。若仍复现，请按维护者说明在对应构建中重新打开源 issue。

Affected Versions

ToolCodex

Version3.19.2 - 3.20.1（受影响范围；修复将随后续版本发布）

PlatformsWindowsmacOS

Source Issues

本页汇总自 4 个真实 issue

• #6614[Bug] Codex 经本地代理接 Kimi：工具 schema 的 $ref 带同级关键字被 Moonshot 400 拒绝（附已验证修复）
• #6861CC Switch local proxy failed while handling Codex endpoint /responses. Provider: Kimi For Coding; model: kimi-for-coding; upstream_status: HTTP 400;
• #7000Codex /responses proxy fails with Kimi: tools.function.parameters is not a valid moonshot flavored json schema
• #7028CC Switch local proxy failed while handling Codex endpoint /responses.

FAQ

要怎么解决？

维护者表示应升级到包含 #6863（commit `db41d7018`）的后续发布版本；该修复针对 Moonshot/Kimi 的带同级关键字 `$ref` 工具 schema。

When can this fix be released to production?

维护者仅说明修复已在 `main`，并称会随下一版本发布；原帖没有给出具体发布日期。

我碰到和你一样的问题，目前只能在codex 终端中使用，打开chatgpt app就不行了

该线程的维护者确认并验证的是 Codex Desktop → 本地代理 → Kimi For Coding 的 schema 转换修复；原帖未提供 ChatGPT app 场景的单独可验证结论。

相关问题

missing field `call_id`：Codex 自动化 HTTP 400原帖尚无已发布的可验证修复；需在代理转发时规范化无 `call_id` 的孤立输出，并保留跨任务消息内容。4 issues mergedInvalid schema for function — Codex将 CC Switch 升级至包含 v3.18.0 修复的版本可解决 `parameters.type:null` 变体；其他 `null` schema 变体仍需跟踪原帖。13 issues mergedThe `content[].thinking` in the thinking该问题部分变体仍未修复：可将 CC Switch 升级到已包含 thinking 历史归一化修复的版本；Codex 经 DeepSeek 转发时需使用包含对应转换修复的版本。13 issues merged