Claude Code VS Code

本页只覆盖 Claude Code 在 VS Code 工作流中的配置，不代表 Cline、Copilot、Continue、Roo Code 或其他扩展已完成版本化验证。请先按 Claude Code 安装当前官方版本并创建专用 Key。

准备与系统差异

在开始前用专用 Key 请求 GET /v1/models，只选择返回的模型 ID。

Windows：将用户级配置保存在 %USERPROFILE%\.claude\settings.json，不要提交到工作区。
macOS：使用 ~/.claude/settings.json，并通过当前 Claude Code 官方方式从 VS Code 启动。
Linux / WSL：使用 Linux 用户的 ~/.claude/settings.json；不要把 Windows 用户目录当作 WSL 配置目录。

关闭所有 VS Code 窗口、集成终端和 Claude Code 进程后再重开，避免旧环境变量继续生效。

配置 Anthropic Messages

Claude 兼容客户端使用站点根地址，由客户端追加 /v1/messages。控制台生成的当前契约使用 ANTHROPIC_AUTH_TOKEN：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.tavonilo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-own-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

不要把完整 /v1/messages 写进 Base URL，也不要用过期示例的 ANTHROPIC_API_KEY 覆盖控制台生成的鉴权方式。

最小验证与恢复

从 VS Code 发起一条不含敏感代码的短消息。基础对话成功后，再验证项目读取、工具调用或流式输出。

401：检查 ANTHROPIC_AUTH_TOKEN、文件路径和残留的旧环境变量。
403：确认 Key 分组、模型可见性、余额和路由权限。
404：Base URL 应为 https://ai.tavonilo.com，不能是完整消息 endpoint。
429：按 Retry-After 和队列策略降低并发。
5xx 或超时：只对明确可安全重试的请求有限重试；保存脱敏诊断信息。

API Key、完整 settings.json、私有代码和认证码都不应发送给客服。