在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
相关推荐
forestsea4 天前
如何使用 Winget 下载 Claude Code 并实现绿色便携安装
windows·claudecode
yubajin6 天前
ClaudeCode本地源码编译、调试、自定义接入大模型实操案例
源码分析·claudecode
yubajin6 天前
Claude Code 本地源码解读——claw-code
源码分析·claudecode
不爱记笔记8 天前
ClaudeCode接入DeepSeek教程!防封号!
人工智能·ai·deepseek·claudecode
程序员徐公10 天前
Claude Code 是怎么悄悄认出中国用户的
claudecode
小七-七牛开发者11 天前
Coding Agent 规则管理:CLAUDE.md、Skills、Hooks、Subagents 到底怎么选?
ai·大模型·agent·claude·token·loop·mcp·claudecode·ai coding
带刺的坐椅12 天前
从 Claude Code 隐私争议,看 SolonCode 的设计选择
ai·llm·agent·claudecode·soloncode·codingplan
带刺的坐椅17 天前
SolonCode v2026.6.24 发布:安全访问、Mermaid 渲染、Goal 重构——智能体自治能力再进化
ai编程·codex·claudecode·soloncode
小七-七牛开发者19 天前
周一上线 | SpaceX 收购 Cursor、支付宝进入 AI 时代、DeepSeek 完成 500 亿元融资
ai·agent·token·glm·智谱·claudecode·ai coding·周一上线
shchojj1 个月前
What is Claude?
code·claudecode