Claude Code 安装与配置

在 Windows 上安装 Claude Code 2.x，绕开区域限制与强制登录，用 cc-switch 在多个模型供应商之间切换，并在终端与 VS Code 中启动。示例版本为 @anthropic-ai/claude-code@2.1.112。

目录

1. 安装
2. 启动前的两个问题
3. 安装 cc-switch
4. 启动使用

一、安装

环境：Windows。

1. 安装新版本 Node.js：https://nodejs.org/en/download。
2. 安装 Git：https://git-scm.com/install/windows。
3. 全局安装 claude：

npm install -g @anthropic-ai/claude-code@2.1.112

验证安装是否成功：

claude --version

直接启动会遇到两个问题：所在 IP 不支持使用；Claude Code 2.0 版本后需要强制登录。先完成下面的配置即可避开。

二、启动前的两个问题

1. 所在 IP 不支持使用

方式一：修改 .claude.json（推荐，无需代理）。

在 C:\Users\user\.claude.json 中，在 userID 字段下添加 "hasCompletedOnboarding": true：

{
  "userID": "e16422773aa9e371129de0c39f8ebd45c0aa715fc59",
  "hasCompletedOnboarding": true
}

方式二：创建或编辑 settings.json。

已有代理服务的情况下，在 C:\Users\user\.claude 下新建 settings.json：

{
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7897",
    "HTTPS_PROXY": "http://127.0.0.1:7897"
  }
}

2. 需要强制登录

配置 C:\Users\user\.claude\settings.json：

{
  "env": {
    "HTTP_PROXY": "http://127.0.0.1:7897",
    "HTTPS_PROXY": "http://127.0.0.1:7897",
    "primaryApiKey": "dev"
  }
}

primaryApiKey：当这个键存在且不为空时，会被视为一个信号，告诉程序「我已提供 API 密钥，请跳过官方登录流程」。

三、安装 cc-switch

cc-switch 能在多个 API 配置间一键切换，方便无缝使用不同的模型供应商。

下载地址：https://github.com/farion1231/cc-switch/releases

Windows 用户选择 .msi 或 Windows.zip，Mac 用户选择 macOS.zip。

以 Claude Code 的配置为例，点击右上角的「添加供应商」会弹出配置窗口，配置类型包括 Claude 官方，以及 DeepSeek、智谱 GLM、Qwen-Coder、Kimi-K2、魔搭等；切换后即可开始配置，大部分只需要配置 API Key 和主模型。

以智谱模型为例：该模型刚注册时送 3 天免费额度，访问 https://www.bigmodel.cn/glm-coding?ic=3VD5B7WKST 还能领取 7 天免费套餐，是目前优惠力度最大的。

1. 在大模型控制平台创建自己的 key。

   

2. 在 CC Switch 中选择 Zhipu GLM。

   

3. 填入自己的 key。

   

   

配置完成后，点击对应模型右侧的「启用」按钮即可完成模型切换。

四、启动使用

1. 在终端中运行

claude

2. 在 VS Code 中使用

1. 安装 Claude Code for VS Code 插件。

2. 点击文件图标。

   

3. 打开插件界面。

   

4. 面板似乎要求登录，不用处理，等几秒会自动进入。