在windows11上安装配置ClaudeCode+CC Switch

本文面向中国用户,介绍如何在 Windows 11 上安装 Claude Code,并通过 CC Switch 工具配置API代理

文章目录


前置准备

请确保你的环境满足以下条件:

  • 操作系统:Windows 11
  • 已有 API聚合平台账号、中转账号
  • 终端工具:PowerShellCMD(推荐)

安装 Node.js

Claude Code 依赖 Node.js 18 或更高版本

步骤

  1. 访问 https://nodejs.org,下载 LTS(长期支持版) 安装包
  2. 双击安装包,按照向导默认安装,勾选"Add to PATH"选项
  3. 安装完成后,打开 PowerShell,验证安装:
powershell 复制代码
node -v   # 应输出 v18.x.x 或更高  
npm -v    # 应输出对应的 npm 版本  

# 注意:以下命令适合在乎C盘空间的用户执行
npm config set prefix "D:\ProgramFiles\nvm\npm_global"
npm config set cache "D:\ProgramFiles\nvm\npm_cache"
# 还需要将npm_global加入到PATH环境变量中。
# 如果要在powershell中执行claude命令,还需要执行下面的命令
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

安装ClaudeCode

安装方式有多种,如下会逐一介绍

官方一键安装脚本

官方提供的一键安装脚本,根据你的系统选择对应的命令执行:

macOS、Linux、WSL:

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

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

通过npm安装

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

安装验证

C:\Users\Administrator>claude -v

2.1.126 (Claude Code)

安装配置CC Switch

步骤

访问 CC Switch 的 GitHub Release 页面:
CC Switch 官网链接

在最新版本的 Assets 中,下载适用于 Windows 的安装包:

安装版(推荐):CC-Switch-vX.X.X-Windows.msi

便携版(免安装):CC-Switch-vX.X.X-Windows-Portable.zip

双击 .msi 文件按向导安装(或解压便携版直接运行)

安装完成后,桌面或开始菜单会出现 CC Switch 图标,双击打开。

打开主界面后,添加供应商。可以某个特定的api供应商,也可以是api聚合平台。


在这里选中新增的统一供应商,点同步


启动ClaudeCode

配置好CC Switch,就可以正常使用Claude Code了。(Claude Code默认不支持中国地区)

去一个你要打开claude的工作目录,输入claude

bash 复制代码
D:\Workspace\doc>claude
Welcome to Claude Code v2.1.126
..............................................................................................................................................................................

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

 Let's get started.

 Choose the text style that looks best with your terminal
 To change this later, run /theme

 ❯ 1. Auto (match terminal)
   2. Dark mode ✔
   3. Light mode
   4. Dark mode (colorblind-friendly)
   5. Light mode (colorblind-friendly)
   6. Dark mode (ANSI colors only)
   7. Light mode (ANSI colors only)

 ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
  1  function greet() {
  2 -  console.log("Hello, World!");
  2 +  console.log("Hello, Claude!");
  3  }
 ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
  Syntax theme: Monokai Extended (ctrl+t to disable)

第一项,是让你选择主题,是暗黑模式,还是亮色模式,你可以选择第一个自动Auto。按回车

然后还会提醒你,问你是否信任当前目录,全选是就行了。

接下来就顺利进入Claude的操作页面了。

bash 复制代码
D:\Workspace\doc>claude
Welcome to Claude Code v2.1.126
..............................................................................................................................................................................

     *                                       █████▓▓░
                                 *         ███▓░     ░░
            ░░░░░░                        ███▓░
    ░░░   ░░░░░░░░░░                      ███▓░
   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓
╭─── Claude Code v2.1.126 ─────────────────────────────────────────────────────────────────────────────────────────────╮
│                                    │ Tips for getting started                                                        │
│            Welcome back!           │ Run /init to create a CLAUDE.md file with instructions for Claude               │
│                                    │ ─────────────────────────────────────────────────────────────────────────────── │
│               ▐▛███▜▌              │ What's new                                                                      │
│              ▝▜█████▛▘             │ The `/model` picker now lists models from your gateway's `/v1/models` endpoint... │
│                ▘▘ ▝▝               │ - Added `claude project purge [path]` to delete all Claude Code state for a pr... │
│                                    │ `--dangerously-skip-permissions` now bypasses prompts for writes to `.claude/`... │
│   Sonnet 4.6 · API Usage Billing   │ /release-notes for more                                                         │
│          D:\Workspace\doc          │                                                                                 │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
> 请统计一下当前目录下有多少文件

● Searched for 1 pattern, read 1 file (ctrl+o to expand)

● 当前目录 D:\Workspace\gem 下没有文件,只有 2 个子目录:

  - .obsidian
  - private-doc

  如果想统计所有子目录中的文件总数,可以告诉我。
  ? for shortcuts
相关推荐
带刺的坐椅2 天前
别再把 Coding Agent 当智能补全了:SolonCode 想做的是数字员工
java·solon·codex·claudecode·opencode·soloncode
Better Bench3 天前
WSL2 Ubuntu 中 Claude CLI “command not found” 故障排查与修复
linux·ubuntu·claude·wsl·claudecode
旋生万物3 天前
五条几何公理重构元素周期表:从量子力学到螺旋拓扑的降维(AI 编程时代的微观启示)
重构·ai编程·代码审计·cursor·ai agent·mcp协议·claudecode
您^_^6 天前
使用技巧(十一):Claude Code 最强审问官 —— grill-me 深度指南,装完先别写代码
人工智能·windows·个人开发·claudecode·deepseek v4 pro
Flandern111113 天前
从“能跑”到“可运营”:Agent Harness 工程化建设指南
学习·agent·claudecode·harness
逐梦苍穹16 天前
Claude Code 迁移 Codex 实战复盘:基于 15 天本地日志分析使用量、信任成本与失败地图
prompt·claude·codex·claudecode
梦想的颜色18 天前
【AI 速览】2026 硬核横评:Claude Code vs GPT-5.3 Codex 底层架构 / CLI / 工程能力 / 生产落地全维度对比
claudecode·ai 开发工具·gpt codex·大模型代码能力对比·ai 工具选型指南·ai 编程代理横
带刺的坐椅19 天前
SolonCode v2026.7.13 发布:多工作区协同、推理水平可控、子代理任务分组、工程体验再进化
llm·agent·codex·solon-ai·claudecode·opencode
forestsea25 天前
如何使用 Winget 下载 Claude Code 并实现绿色便携安装
windows·claudecode
yubajin1 个月前
ClaudeCode本地源码编译、调试、自定义接入大模型实操案例
源码分析·claudecode