Claude Code VSCode 扩展已配置 settings.json，为什么还是弹登录页？

在 VS Code 里使用 Claude Code 扩展时已经按照教程在设置里配置了环境变量但启动插件后还是会看到登录选择页明明ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY都写进去了为什么 Claude Code 还是提示登录这个问题的关键点在于只配置 VS Code 的settings.json还不够新版 Claude Code 还会检查用户目录下的顶层认证状态文件.claude.json。如果这个文件不存在或者里面缺少必要字段Claude Code 就会认为当前环境还没有完成初始化于是继续弹出登录页。一、常见配置方式只改 VS Code settings.json很多人会通过 VS Code 扩展设置界面配置 Claude Code按Ctrl ,打开 VS Code 设置。搜索Claude Code。找到Environment Variables。点击在settings.json中编辑。常见配置大概是这样{claudeCode.environmentVariables:[{name:ANTHROPIC_BASE_URL,value:https://**你的API地址**},{name:ANTHROPIC_API_KEY,value:sk-替换成你的完整密钥}]}这一步本身没有问题它的作用是把环境变量传给 VS Code 里的 Claude Code 扩展。但它只能解决“运行时读取哪个 API 地址和密钥”的问题不能完全解决“Claude Code 是否已经完成首次认证初始化”的问题。二、真正缺少的是用户目录下的.claude.json在 Windows 上需要检查用户主目录下的这个文件%USERPROFILE%\.claude.json展开后通常类似这样C:\Users\你的用户名\.claude.json注意这里容易看错不是 VS Code 项目目录里的配置文件。不是.claude文件夹里面的某个文件。而是和.claude文件夹同级、直接放在用户主目录下的.claude.json。也就是说它的位置通常是用户目录 ├─ .claude └─ .claude.json新版 Claude Code 启动时会先读取这个顶层认证状态文件用它判断是否已经完成初始化。只要这个状态文件缺失就算你在 VS Code 里配置了环境变量也可能继续看到登录页。三、解决方法手动创建.claude.json在当前用户主目录下新建一个文件文件名必须是.claude.json然后写入下面的内容{hasCompletedOnboarding:true,primaryApiKey:sk-替换成你的完整密钥,baseUrl:https://**你的API地址**}字段说明hasCompletedOnboarding: 告诉 Claude Code 已经完成首次初始化不再强制进入登录引导。primaryApiKey: 新版校验会读取这个字段建议填写完整 API Key。baseUrl: 填写你的中转地址。如果你使用的是别的中转地址就把baseUrl换成自己的地址。示例效果如下四、保存后还需要重启 VS Code.claude.json创建完成后建议按下面顺序操作一次保存.claude.json。完全关闭 VS Code。重新打开 VS Code。再启动 Claude Code 扩展。如果之前的配置都正确这时就不会再卡在登录选择页了。五、再检查 3 个容易踩坑的地方1. 文件名不要写错文件名必须是.claude.json不要写成claude.json .claude.json.txtWindows 默认可能隐藏文件扩展名如果你用记事本新建文件尤其要确认最后没有多出.txt。2. JSON 里不要保留多余逗号下面这种末尾多一个逗号的写法可能会导致读取失败{hasCompletedOnboarding:true,primaryApiKey:sk-替换成你的完整密钥,baseUrl:https://**你的API地址**,}正确写法是最后一项后面不要加逗号{hasCompletedOnboarding:true,primaryApiKey:sk-替换成你的完整密钥,baseUrl:https://**你的API地址**}3. 最后还是推荐下CC-switch更方便点如果你不想手动维护这些路径、字段和多个客户端配置还是更推荐使用CC-switch。它可以统一配置 Claude Code CLI、VS Code 扩展和 Cursor 插件后续切换模型、密钥和中转地址会方便很多。关于 CC-switch 的一键配置方法可以看上期文章。