VS Code 插件接入教程
VS Code 是目前最主流的代码编辑器,通过安装 Claude Code 官方插件可以获得完整的 AI 编程能力。
前置条件
⚡ Windows 用户:先安装 Git for Windows(必须)
⚠️ 跳过此步会导致 Claude Code 插件无法运行! 请务必先完成。
国内镜像(推荐,速度快): 👉 Git-2.47.1-64-bit.exe(npmmirror 镜像)
官方地址(备用): 👉 https://git-scm.com/downloads/win
下载后运行安装程序,保持所有默认选项,一路 Next 完成安装,然后重启 PowerShell。
Claude Code for VS Code 配置流程(共 4 步)
第一步:安装 Claude Code CLI
打开终端(PowerShell / Terminal),运行:
npm install -g @anthropic-ai/claude-code⚠️ 必须安装原版
@anthropic-ai/claude-code,这是 Anthropic 官方发布的包。
验证安装:
claude --version第二步:配置 API Key
运行一键配置工具,按提示输入你的 Key:
npx timesniper-api或手动创建/编辑 C:\Users\你的用户名\.claude\settings.json(macOS/Linux: ~/.claude/settings.json):
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_BASE_URL": "https://uau.cc",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}配置完成后,在终端运行 claude,确认可以正常对话,再继续下一步。
👉 详细说明请看 Claude Code CLI 完整教程
第三步:在 VS Code 里安装 Claude Code 插件
- 打开 VS Code,按
Ctrl+Shift+X打开扩展商店 - 搜索 Claude Code
- 找到发布者为 Anthropic 的官方插件,点击 安装
- 安装完成后重启 VS Code
第四步:打开插件 settings.json 配置环境变量
⚠️ 这一步是关键!不配置此项插件会无法连接到国内 API。
- 按
Ctrl+Shift+X打开扩展商店 - 搜索 Claude Code,找到已安装的 Claude Code 插件
- 点击该插件右下角的 ⚙️ 齿轮图标
- 在弹出菜单中点击 扩展设置(Extension Settings)
- 在打开的设置页面中往下翻,找到 在 settings.json 中编辑(通常是蓝色可点击的链接文字),点击它
- 在打开的 settings.json 中加入以下内容(
sk-替换为你的真实 Key):
{
"claude-code.environmentVariables": [
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "sk-你的Key"
},
{
"name": "ANTHROPIC_API_KEY",
"value": "sk-你的Key"
},
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://uau.cc"
}
]
}- 保存文件(
Ctrl+S),然后重启 VS Code - 再次点击侧边栏 Claude Code 图标,即可正常使用 ✅
自定义其他模型(可选)
Claude Code 默认调用 Claude 系列模型,但通过以下环境变量,可以将所有请求切换到 GPT、GLM、MiniMax、Kimi 等uau.cc支持的任意模型。
注意:切换到非 Claude 模型时,需要在令牌页面选择对应分组创建 API Key,例如:GPT 模型选
gpt分组,GLM 模型选glm分组,其他模型同理。
在 claude-code.environmentVariables 数组中追加以下条目(以 GLM 为例,完整 settings.json 示例):
{
"claude-code.environmentVariables": [
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" },
{ "name": "ANTHROPIC_API_KEY", "value": "sk-你的Key" },
{ "name": "ANTHROPIC_BASE_URL", "value": "https://uau.cc" },
{ "name": "ANTHROPIC_MODEL", "value": "glm-5.1" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "glm-5.1" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "glm-5.1" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "glm-5.1" },
{ "name": "ANTHROPIC_REASONING_MODEL", "value": "glm-5.1" }
]
}| 变量 | 说明 |
|---|---|
ANTHROPIC_MODEL | 主对话默认模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 级任务(日常编码、问答) |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 级任务(快速、轻量内部操作) |
ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 级任务(复杂推理、长文档分析) |
ANTHROPIC_REASONING_MODEL | 深度思考模式(/think 命令触发) |
将
glm-5.1替换为目标模型 ID 即可,支持 GPT、GLM、MiniMax、Kimi 等所有uau.cc支持的模型。
其他可选插件
以下插件无需依赖 Claude Code CLI,直接配置 API Key 即可使用。
Roo Code
扩展商店搜索 Roo Code 安装。
- API Provider:
Anthropic - API Key: 你的 Key(分组选
cc5或cc7) - Use custom base URL:
https://uau.cc
⚠️ 关闭「将 Anthropic API 密钥作为 Anthropic 标头传递」和「启用 1M 上下文」
Cline
扩展商店搜索 Cline 安装。
- API Provider:
OpenAI Compatible - Base URL:
https://uau.cc/v1 - API Key: 你的 Key
- Model ID:
claude-sonnet-4-5
Continue
扩展商店搜索 Continue 安装,编辑 ~/.continue/config.json,apiBase 填 https://uau.cc/v1。
常见问题与异常处理 (FAQ)
| 错误 | 原因 | 解决方案 |
|---|---|---|
| 插件提示登录 / 无法连接 | settings.json 未配置或未重启 | 完成第四步配置后重启 VS Code |
| CLI 安装失败 | Node.js 未安装或版本过低 | 安装 Node.js 18+ |
| Windows 启动报错 | 未安装 Git for Windows | 安装 Git 国内镜像 |
| 401 Unauthorized | API Key 错误 | 重新获取 API Key |
| 404 Not Found | Base URL 错误 | 检查 ANTHROPIC_BASE_URL 是否为 https://uau.cc |
| 429 Too Many Requests | 额度耗尽 | 前往充值页面充值 |
提示: 如果依然无法解决,请携带完整报错截图到客服群中寻求帮助。