Claude Code 教程：VS Code 插件与终端配置

打开下载页，下载对应系统的安装包

它是管配置的小工具，装好只是先把软件准备好，这一步不用填任何东西。

• 打开下面的官网 → 挑自己系统的安装包（Windows / macOS 都有）→ 下载 → 安装，全程保持默认。

• 软件很小，不需要注册账号，装完先不用配置，下一步直接换 Key。
• 杀毒软件提示未知来源时选「仍要运行」，这是开源小工具。

在管理后台把卡密换成 API Key

这把 sk- 开头的密钥就是后面全程要用的 API Key；激活码、Key 都会留在后台里，刷新页面随时能再看。

• 打开下面的管理后台 → 在「我的面板」或「提取 Key」页面粘贴激活码 → 提交激活 → 在「提取 Key」页面拿到你的 Key。

• 先复制保存一份到密码管理器；忘了也不要紧，回管理后台用同一把激活码随时能再看，刷新页面不会丢。

在管理后台点「一键导入配置」

这一步让管理后台和 CC Switch 对上号，不用你手抄地址和密钥。

• 回到管理后台 → 点「一键导入配置」→ CC Switch 会自动弹出接收窗口 → 确认导入。

• 点了没反应多半是 CC Switch 没启动，先打开它再点。
• 导入窗口里直接确认导入，不要改里面的 Base URL。
• 同名配置会覆盖，重复导入不会叠加。
• 窗口里提示「需在客户端中点击启用后写入配置文件」，下一步就做这件事。

打开 CC Switch 进去获取模型

先确认配置确实进了 CC Switch。

• 打开 CC Switch → 看左侧的 Claude 配置，标签显示「使用中」就说明已经导进来了。

点高级选项，获取模型列表

让 CC Switch 知道网关这边有哪些模型可用。

• 双击这条配置进入「编辑供应商」→ 点「获取模型列表」，下面就会列出可用模型。

• 列表为空通常是 Base URL 或 Key 填错了，回上一步核对一遍。
• 带 -5-5、-4-8 这样后缀的是不同版本，不确定就用列表里的最新几个。

选择你需要的模型并保存

把要用的模型加进来，不保存下一步启用后模型列表会是空的。

• 把 claude-fable-5-1、claude-opus-5-5、claude-opus-4-8、claude-sonnet-5-5 都添加进去，然后点「保存」。

• 完整的模型介绍见模型广场。

点「启用」，再点「检测链路」

启用后配置才会写进 CC Switch，检测显示运行正常就算配完了。

• 回到 CC Switch 主界面 → 点「启用」→ 再点「检测链路」，显示运行正常即可。

• 检测失败先看常见问题 · 使用与配置：多数情况是模型没保存，或者 Base URL 多带了 /v1。
• 终端里的 claude、VS Code 里的 Claude Code 插件都直接生效，打开就能用。
• 需要切换模型时，在终端里用 /model 这个指令，命令与参数见命令速查。

没装过 VS Code 的先下载安装

开始使用要先有 VS Code 本体。

• 打开下面这个官网，挑自己电脑的系统下载，一路下一步保持默认安装。

• 已经装了 VS Code 的跳过这一步，直接装下面那个插件。

安装 Claude Code 的官方插件

装好后直接在上面聊天、写代码，用的就是前面配好的那把 Key，不用再输一遍。

• 打开 VS Code 的扩展面板（Ctrl+Shift+X）→ 搜索「Claude Code」→ 确认发布者是 Anthropic → 安装。

• 认准发布者是 Anthropic，同名的第三方插件不要装。
• 插件里的 API Key / 登录方式选「使用已有的 API 配置 / API Key」，不需要登录 Anthropic 账号。
• 如果提示配置缺失，回 CC Switch 确认配置已启用，然后重启 VS Code。