Windows系统下快速体验Claude code

一、参考资料

Claude Code 教程 | 菜鸟教程

Claude Code的安装并连接VScode（使用CC Switch或ollama连接）-CSDN博客

二、快速体验Claude code

1. 安装Node.js

下载地址：Node.js

配置环境变量：

验证是否安装成功：

bash 复制代码

node -v
npm -v

切换npm镜像：

bash 复制代码

# 切换国内镜像源
npm config set registry https://registry.npmmirror.com

# 恢复官方镜像源
npm config set registry https://registry.npmjs.org

2. 安装Claude code

方式一：npm方式

bash 复制代码

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

# 切换国内镜像
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

方式二：脚本方式

bash 复制代码

curl -fsSL https://claude.ai/install.sh | bash

验证是否安装成功：

bash 复制代码

claude --version

3. 卸载Claude code

方式一：npm方式

bash 复制代码

npm uninstall -g @anthropic-ai/claude-code

方式二：脚本方式

bash 复制代码

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

删除配置文件：

bash 复制代码

# 删除全局用户设置和状态
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# 删除当前项目的本地设置（在项目目录中执行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

4. 设置环境变量

配置优先级

配置的优先级（从高到低）：

Managed（组织管理配置，不可覆盖）
命令行参数（临时会话覆盖）
Local （.claude/settings.local.json，仅本项目本人）
Project （.claude/settings.json，团队共享）
User （~/.claude/settings.json，全局个人）

设置 claude API Key

bash 复制代码

# linux
export ANTHROPIC_AUTH_TOKEN "你的API_KEY"

# windows
setx ANTHROPIC_AUTH_TOKEN "你的API_KEY"

常用环境变量：

环境变量	解释说明
`ANTHROPIC_API_KEY`	官方 API Key
`ANTHROPIC_BASE_URL`	自定义 API 端点
`ANTHROPIC_AUTH_TOKEN`	认证 Token（覆盖 API Key）
`ANTHROPIC_MODEL`	默认模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 别名指向的模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 别名指向的模型
`CLAUDE_CODE_USE_BEDROCK`	启用 Bedrock
`CLAUDE_CODE_USE_VERTEX`	启用 Vertex AI
`CLAUDE_CODE_USE_FOUNDRY`	启用 Azure Foundry
`HTTPS_PROXY`	HTTP 代理

示例（以deepseek为例）：

bash 复制代码

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_API_KEY="sk-your-proxy-key"
export ANTHROPIC_MODEL=deepseek-chat
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-chat

export API_TIMEOUT_MS=600000

# 禁用非必要流量检查
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000  # 1 小时

`settings.json` 配置文件

通过 ~/.claude/settings.json 集中管理所有配置。

json 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-code.com.cn",
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  },
  "model": "sonnet",
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git *)"
    ]
  }
}

5. 启动claude

bash 复制代码

claude

# 登陆
/login

claude 常用指令：

bash 复制代码

# 查看版本
claude --version

# 启动
claude

# 启动时指定模型
claude --model opus

# 切换模型，运行中切换模型
/model sonnet

# 查看当前状态（模型、账户、配置）
/status

# 退出当前账户
/logout

# 打开配置界面
/config

# 查看帮助
/help

6. Claude连接CC Switch（API Key管理工具）

CC Switch 一键切换 API | 菜鸟教程

厂商/品牌	简介	API 申请入口（点击即达）
DeepSeek（国产高性价比）	官方模型：deepseek-chat / deepseek-reasoner	https://platform.deepseek.com/api_keys
阿里百炼（通义千问）	阿里云大模型统一入口，支持千问、GLM、Kimi 、MiniMax 等最新版本模型	https://bailian.console.aliyun.com
GLM（智谱清言）	清华系 ChatGLM 系列，支持 GLM-4、GLM-3-Turbo 等	https://open.bigmodel.cn
MiniMax	国产多模态，支持文本、语音、图像混合调用	https://platform.minimaxi.com

安装CC Switch

下载地址：cc-switch

windows安装包：CC-Switch-v3.13.0-Windows.msi

申请API Key

进入deepseek官网：https://www.deepseek.com/，点击API开放平台。

添加API Key

添加成功：

Claude连接CC Switch

注意：如果提示余额不足，则进入deepseek官网充值。

（可选）自定义配置（Ollama）

在CC Switch中也可以配置ollama本地模型：

json 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:11434",
    "ANTHROPIC_AUTH_TOKEN": "ollama",
    "ANTHROPIC_MODEL": "qwen3.5:0.8b",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.5:0.8b",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5:0.8b",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5:0.8b",
    "ANTHROPIC_REASONING_MODEL": "qwen3.5:0.8b"
  },
  "includeCoAuthoredBy": false
}

7. Claude连接本地Ollama

下载Ollama：Download Ollama

安装Ollama，并拉取大模型，详细步骤请参考：

DeepSeek本地部署（ollama、Cherry Studio）设置本地ollama-CSDN博客

LLama3大模型本地部署仅需6步完成对话模型本地安装部署。附送可视化ui安装、自定义模型目录，修改模型保存地址，第三方微调模型、中文模型下载地址-CSDN博客

新开一个终端，启动claude：

bsah 复制代码

ollama launch claude --model qwen3.5:0.8b

8. vscode对接Claude

配置Ollama的环境变量：

变量名	变量值	说明
`ANTHROPIC_BASE_URL`	`http://localhost:11434`	指向 Ollama 本地服务地址（默认端口 11434）
`ANTHROPIC_AUTH_TOKEN`	`ollama`	伪造的认证 Token（随意填一个字符串即可）

三、FAQ

Q：无法启动Claude code

bash 复制代码

C:\Users\Administrator>claude
Welcome to Claude Code v2.1.101
..............................................................................................................................................................................

     *                                       █████▓▓░
                                 *         ███▓░     ░░
            ░░░░░░                        ███▓░
    ░░░   ░░░░░░░░░░                      ███▓░
   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓
                                             ░▓▓███▓▓░
 *                                 ░░░░
                                 ░░░░░░░░
                               ░░░░░░░░░░░░░░░░
       █████████                                        *
      ██▄█████▄██                        *
       █████████      *
.....................█ █   █ █..............................................................................................................................

 Unable to connect to Anthropic services

 Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

 Please check your internet connection and network settings.

 Note: Claude Code might not be available in your country. Check supported countries at
 https://anthropic.com/supported-countries

错误原因：无法访问Claude code海外服务。

解决方法：推荐使用国内API Key方式。

（1）修改 .claude.json 配置文件。

文件路径：C:\Users\Administrator\.claude.json

末尾新增一行：

bash 复制代码

"hasCompletedOnboarding":true

（2）重新启动claude

Q：未登录Claude账号

解决方法：有Claude账号的直接登录，没账号的则连接国内大模型。

Windows系统下快速体验Claude code

一、参考资料

二、快速体验Claude code

1. 安装Node.js

2. 安装Claude code

方式一：npm方式

方式二：脚本方式

3. 卸载Claude code

方式一：npm方式

方式二：脚本方式

4. 设置环境变量

配置优先级

设置 claude API Key

settings.json 配置文件

5. 启动claude

6. Claude连接CC Switch（API Key管理工具）

安装CC Switch

申请API Key

添加API Key

Claude连接CC Switch

（可选）自定义配置（Ollama）

7. Claude连接本地Ollama

8. vscode对接Claude

三、FAQ

Q：无法启动Claude code

Q：未登录Claude账号

`settings.json` 配置文件