VsCode 集成 Claude Agent 报无效请求？参数配置与网络排查指南
当在 VSCode 中通过扩展调用 Claude Agent 接口时，如果遇到'无效请求'（Invalid Request）报错，大概率是配置细节没对齐。作为经常折腾这类集成的开发者，我整理了一套排查思路，帮你快速定位问题。
1. 检查 API 密钥配置
首先确认 settings.json 里的密钥是否生效。很多情况下是因为复制粘贴多了空格，或者密钥本身已过期。
{
"claude.apiKey": "your_api_key_here",
"claude.endpoint": "https://api.claude.ai/v1"
}
如果不确定密钥状态，建议重新生成一个替换进去。
2. 验证请求参数格式
Claude 的接口对参数校验很严格。常见的坑包括必填字段缺失、类型不匹配（比如把数字写成了字符串），或者传了不支持的冗余字段。
正确的请求体结构大致如下：
{
"model": "claude-2",
"prompt": "你的问题或指令",
"max_tokens": 100
}
3. 调整网络代理设置
如果是远程服务器环境，防火墙或代理设置很容易阻断请求。可以先尝试关闭本地安全软件测试，或者用 curl 直接通一下接口。
VSCode 内部也可以配置代理：
{
"http.proxy": "http://your_proxy_address:port",
"https.proxy": "http://your_proxy_address:port"
}
4. 更新插件和依赖
有时候接口变了，但插件还是旧版本，兼容性就会出问题。去扩展市场看看有没有更新，或者在终端运行命令刷新依赖：
npm update -g claude-agent
