错误信息: Claude Code returned an error result: API Error: 400 {"error":{"type":"400...
错误信息
AI 解决方案
好的，我看到用户提供的错误信息了。这个错误看起来挺有意思的，是关于API调用时JSON格式问题的。
让我先看看这个错误信息的核心内容。用户显示的是一个AI_ProviderSpecificError，具体是Claude Code返回的API错误。错误信息是"Invalid JSON payload received. Unknown name \"propertyNames\" at 'tools[0].function_declarations[9].*.properties[1].value': Cannot find field."。
我需要把这个错误信息翻译成中文，这样能帮助用户更好地理解问题。原文说收到了无效的JSON载荷，在特定的路径下有一个未知的字段名"propertyNames"。
从技术角度来看，这个错误发生在调用Claude API时，发送的请求体中包含了一个API不支持的字段。具体是在tools数组的第一个元素的function_declarations数组的第10个元素（索引是9）下的某个属性中，有一个叫"propertyNames"的字段，但API不认识这个字段。
为什么会这样呢？我猜可能是用户使用的AI SDK或应用框架在构建请求时，使用了与Claude API版本不兼容的JSON Schema字段。"propertyNames"这个字段在标准的JSON Schema中是存在的，但可能Claude的API实现不支持这个特定字段。
我需要给出具体的解决方案。从错误信息看，问题出在请求的JSON结构上。用户应该检查他们的API调用代码，特别是构建tools参数的部分。需要查看function_declarations数组中第10个元素的结构，找到包含"propertyNames"的属性定义，然后移除这个字段。
如果用户是在使用某个AI SDK，可能需要更新SDK到最新版本，或者检查是否有专门针对Claude API的配置选项。如果用户是自己构建请求，那么需要手动修改JSON Schema的定义。
为了避免以后出现类似的问题，我建议用户在使用API前先仔细阅读官方文档，了解支持的JSON Schema字段。还可以在开发过程中使用JSON验证工具，提前发现不兼容的字段。另外，保持AI SDK更新到最新版本也很重要，这样能确保兼容性。
我觉得这样的分析应该能帮用户解决这个问题。错误很明确，就是请求格式问题，解决方案也很直接。
🔍 错误分析
#### 1. 🌐 错误翻译
原文：Invalid JSON payload received. Unknown name "propertyNames" at 'tools[0].function_declarations[9].***.properties[1].value': Cannot find field.
译文：收到了无效的JSON负载。在 ‘tools[0].function_declarations[9].***.properties[1].value’ 路径下发现未知字段名 "propertyNames"。
#### 2. 🎯 原因分析
tools 参数下的 function_declarations 数组中的一个工具定义里。具体路径指向某个工具属性（properties）中的一个值（value），该位置使用了一个名为 propertyNames 的字段，但API无法识别。propertyNames 通常是JSON Schema规范中的一个关键字。此错误表明，您使用的AI应用框架（Cherry Studio）或底层的AI SDK在构建工具调用请求时，可能使用了与Claude API当前版本要求不兼容的JSON Schema字段或结构。#### 3. 💡 解决方案
此问题通常需要修改发送给API的工具定义结构。您需要检查并修改生成工具定义的代码。
1. 检查并修改工具定义：
定位到构建 function_declarations 的代码，找到第10个工具定义（索引为9）。检查其中 properties 的定义，移除或替换不兼容的 propertyNames 字段。
例如，将：
{
"name": "example_tool",
"parameters": {
"type": "object",
"properties": {
"my_property": {
"type": "string",
"propertyNames": { ... } // 移除此行
}
}
}
}
修改为Claude API支持的标准格式，通常
propertyNames 并非必需，直接移除或使用其他方式（如 pattern）验证属性名。2. 更新AI SDK或应用框架：
如果您正在使用Cherry Studio或某个AI SDK，检查是否有可用更新。开发者可能已在新版本中修复了此兼容性问题。
#### 4. 🛡️ 预防措施