解决 VsCode 中调用 Claude Agent 提示'无效请求'的问题
在 VSCode 里通过扩展或插件调用 Claude Agent 时，如果突然冒出'无效请求'的报错，先别急着重启。根据经验，这多半是参数配置或者网络环境的小细节没对上。下面整理了一些实际排查步骤，按顺序过一遍通常能解决问题。
检查 API 密钥配置
最常见的原因还是密钥没配对。打开 VSCode 的设置文件（settings.json），确认 claude.apiKey 字段是否完整且有效。
{
"claude.apiKey": "your_api_key_here",
"claude.endpoint": "https://api.claude.ai/v1"
}
如果密钥过期或者复制时多了空格，直接重新生成替换即可。有时候看似填了，其实只是格式不对，建议复制粘贴后仔细核对。
验证请求参数格式
Claude 接口对 JSON 结构比较敏感。如果发送的请求缺了必填项，或者类型不匹配，也会直接返回无效请求。
常见的坑包括：
- 少了
model或prompt字段。 max_tokens写成了字符串而不是数字。- 塞入了不支持的冗余字段。
一个标准的请求体应该长这样：
{
"model": "claude-2",
"prompt": "你的问题或指令",
"max_tokens": 100
}
调整网络代理设置
如果你在公司内网或者跨地域访问，网络代理经常是隐形杀手。防火墙拦截、代理配置错误都可能导致连接被拒。
可以先尝试临时关闭防火墙测试连通性，或者用 curl 和 Postman 绕过 VSCode 直接测一下 API 通不通。如果必须走代理，记得在 VSCode 里显式配置：
{
"http.proxy": "http://your_proxy_address:port",
"https.proxy"