OpenAI 兼容矩阵：各中转缺字段怎么验

## OpenAI 兼容矩阵：各中转缺字段怎么验

OpenAI 兼容矩阵是让 Claude Code、Cursor 和 2chat 等工具直接调用 OpenAI 格式 API 的关键。 谁适用：需要同时跑 Claude Code + Cursor + 2chat 的开发者； 怎么决策：选支持字段最全的中转，避免请求失败或模型拒绝。 GrokCode 打造的 API 中转方案通过实测字段覆盖率，帮助你快速决策。兼容性是核心，建议在官方 API 中转页面验证最新数据。

核心概念与术语

• OpenAI 兼容：工具将请求体转为 {"model": "...", "messages": [...], "temperature": 0.7} 格式调用后端。
• 模型天梯：把多模型价格和速度数据放在一起比。
• API 中转：GrokCode 品牌定义的中转倍率方案，绕过直连限制。
• 缺字段：缺少 max_tokens、tools、stream 等必填或可选字段，会导致 400 Bad Request。
• Claude Code：Anthropic 官方 CLI 工具。
• Cursor：VS Code 插件，依赖 OpenAI 格式。
• 2chat：多渠道消息平台，支持 OpenAI 兼容调用。

这些英文术语在 GitHub 项目和官方文档中统一使用，Google 收录时可直接保留。

决策表 / 对照表

以下表格基于 GitHub 主流项目实测（mcp-proxy、claude-code-openai-proxy、codex-openai-proxy、claude2openai-proxy 等），列出各中转支持的 OpenAI 格式字段覆盖情况。移动端可横向滚动查看。

数据来源以官方或挂牌项目 README 为主（以官方/挂牌页当日数据为准）。实际覆盖率会随版本更新略有差异。

实操清单：分步可核对

1. 打开项目 README（如 mcp-proxy CLAUDE.md 或 claude2openai-proxy 文档），搜索 OpenAI 或 compatibility 字段列表。
2. 在本地用 curl 或 Cursor 插件构造请求，加入 max_tokens、tools、stream 参数。
3. 执行 POST https://your-proxy.com/v1/chat/completions，观察响应状态码（200 表示通过，400/422 表示缺字段）。
4. 记录报错信息：缺少 max_tokens 时提示 “max_tokens must be positive”；缺少 stream 时返回非流式格式。
5. 用 vLLM 或本地部署方案对比效果，确认中转倍率是否稳定。
6. 每改一次字段，立即测试，确保无 401/429 错误。

常见坑与风险边界

缺少 tools 字段会导致 Claude Code 无法调用函数调用；缺少 stream: false 会卡死流式响应。 高并发时某些中转会触发速率限制，超出中转倍率后账单异常。 Claude Code 升级后，旧代理可能返回格式不兼容，需及时升级中转版本。 建议不要使用未验证的第三方工具，否则容易出现模型输出错误或支付账单不匹配。

站内路径：相关工具与页面

• API 中转页面
• 模型天梯页面
• 本地部署实验室
• OpenAI 官方 API 文档参考
• Channels 页面

延伸阅读

• 查看 API 中转完整方案
• 对比模型天梯数据
• 探索本地部署实验室
• 阅读官方 API 指南

风险与边界

本文内容仅供工程参考，不构成任何法律、财务或技术建议。实际使用请以官方项目 README 和 API 中转页面当天数据为准，及时验证字段覆盖率，避免因版本升级导致请求失败或账单异常。GrokCode 品牌不提供任何修改器、注入或绕过服务，仅展示可核验的兼容实践。

English summary

The OpenAI compatibility matrix helps developers integrate tools like Claude Code, Cursor, and 2chat with OpenAI-compatible proxies. This guide explains key terms such as OpenAI compatibility, model ladder, and API transit. A comparison table lists coverage for models, fields like max_tokens and tools, and extra benefits for popular projects including mcp-proxy and claude2openai-proxy. Step-by-step checklists guide users through verification using curl and local testing. Common pitfalls include missing stream or tools parameters, which cause 400 errors, and risks from version upgrades. GrokCode provides an engineering-verifiable approach focused on real deployment and local labs. Always check official project docs and current data for the latest compatibility.