在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 天前
Agent 小知识|Agent 环境工程:部分可观测性、状态转移与执行隔离
ai·大模型·agent·claude·token·工作流·skill·claudecode·ai coding
格数致用4 天前
银河麒麟 V10 SP1 桌面操作系统 + VSCode + Claude Code 接入 DeepSeek-V4 全流程教程(2026年最新)
vscode·claudecode·银河麒麟 v10
仙逆GPT7 天前
ChatGPT、Codex实战:从Claude Code / Cursor迁移到Codex怎么做?/import最容易漏掉哪些配置?
cursor·codex·chatgptplus·claudecode·codex教程
神奇霸王龙9 天前
DeepSeek 接 Anthropic:迁移屠夫
ai·ai作画·agent·ai编程·claude·claudecode
小七-七牛开发者10 天前
Codex 实践系列 Vol.04:用 Goal 和 Plan 管住一个长任务
ai·大模型·agent·claude·token·工作流·claudecode·ai coding
lincats13 天前
智能体工程 vs 软件工程:计算机系那套课程,还能适应 AI 时代吗?
人工智能·软件工程·原型模式·vibecoding·claudecode·grillme
梦想的颜色14 天前
UniApp 请求层终极封装:统一拦截、错误处理、多端兼容,结合 Claude Code 高效落地
服务器·uniapp·uni.request·codex·claudecode·ai 辅助开发·uniapp 请求封装
梦想的颜色15 天前
UniApp 小程序生命周期硬核全解析:页面销毁、页面栈泄漏 + Claude Code AI 托管优化实战
内存泄漏·前端性能优化·vibecoding·claudecode·uni‑app·小程序生命周期·onunload
组合缺一16 天前
SolonCode v2026.8.4 发布:界面字体可调、22 种语言、记忆搜索增强
llm·agent·ai编程·solon·claudecode·opencode
小七-七牛开发者16 天前
Agent 小知识|长任务不重来:Agent 状态保存的工程设计
ai·大模型·agent·claude·token·工作流·skill·claudecode·ai coding