Claude Code 安装与配置完全指南（Windows 篇）

Anthropic 推出的 Claude Code 是一款强大的 AI 编程助手，直接在终端里与你的代码库交互。本文记录在 Windows 11（64位）上的完整安装与配置流程，包含国内加速方案和常用插件推荐。

一、前置准备

1.1 安装 Git

Claude Code 依赖 Git，如果你的 Windows 还没装，去官网下载安装包：

下载地址：https://git-scm.com/download/win

安装时全部默认，一路 Next 即可。

1.2 配置 Git Bash 路径（关键）

安装完 Git 后，需要告诉 Claude Code 去哪里找 Git Bash。打开 PowerShell 执行（按你的实际安装路径调整）：

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")

执行完 关闭当前终端，重新打开一个新的 才能生效。

二、安装 Node.js 22 LTS

Claude Code 运行在 Node.js 之上，推荐使用最新的 22.x LTS 版本。

2.1 下载

直接下载官方 MSI 安装包：

https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi

2.2 安装步骤（全程默认，不要改）

1. 双击打开 .msi 文件
2. 点 Next
3. 同意协议 → Next
4. 安装路径默认（C:\Program Files\nodejs\）→ Next
5. 关键一步！不要取消任何选项！ 以下三项全部保留：
   • Node.js runtime（主程序）
   • npm package manager（包管理器）
   • Add to PATH（自动配置环境变量）
6. 全部保留 → Next
7. 直接点 Install
8. 安装完成 → Finish

2.3 验证安装

关闭所有已打开的终端（CMD/PowerShell），重新打开一个新的！

node -v
npm -v

正常输出：

v22.14.0
10.8.1+

出现版本号即表示安装成功。

2.4 配置国内镜像（解决下载慢 / 失败）

这一步强烈推荐，否则后续全局工具安装可能超时。新终端里直接执行：

npm config set registry https://registry.npmmirror.com

查看是否生效：

npm config get registry

显示 https://registry.npmmirror.com 就对了。

2.5 如果你之前装过其他版本的 Node.js（必看）

先卸载旧版：打开 Windows 设置 → 应用 → 找到 Node.js → 卸载。

再清理残留文件夹（手动删掉）：

C:\Users\Administrator\AppData\Roaming\npm
C:\Users\Administrator\AppData\Roaming\npm-cache

然后按上面的教程安装 Node.js 22，重开终端。

2.6 简单测试

npm install -g yarn
yarn -v

下载会非常快（淘宝镜像）。能正常输出 yarn 版本号，说明 Node.js 环境全部就绪。

三、安装 Claude Code

官方已经废弃了 npm install -g @anthropic-ai/claude-code 这种安装方式，请用下面的官方脚本安装。

3.1 执行安装脚本

用 PowerShell（不需要管理员权限）执行：

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

如果国内下载慢 / 超时：多试几次，或者切到手机热点。

如果提示执行策略限制，先执行一次：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认，再运行上面的安装脚本。

3.2 验证安装

claude --version
claude doctor

输出版本号 + claude doctor 全绿即表示安装成功。

四、配置 API 提供商

Claude Code 默认需要 Anthropic 官方 API Key。在国内使用，可以切换到第三方兼容 API。以下是两个已验证的方案。

方案 A：MiniMax（便宜，适合日常）

在 %USERPROFILE%\.claude\claude_config.json 中配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-cp-你的key",
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
    "API_TIMEOUT_MS": "300000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

MiniMax 价格便宜，但代码能力一般，适合写简单脚本和测试。

方案 B：DeepSeek（推荐，2026年5月有活动）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "600000"
  }
}

DeepSeek 的代码能力明显强于 MiniMax，配合 CLAUDE_CODE_EFFORT_LEVEL = "max" 效果更好。目前有优惠活动，性价比很高。

五、首次登录与使用

配置好 API 后，终端直接输入：

claude

首次启动会引导你登录 Anthropic 账号。登录成功后，你就可以在项目目录中使用 Claude Code 了。常见操作：

六、RTK 集成（Token 节省利器）

RTK (Rust Token Killer) 是一个高性能 CLI 代理，它会自动拦截并压缩命令行输出，让 Claude Code 少读大量无关文本，平均节省 60-90% 的 Token 开销。

6.1 安装

从 GitHub Releases 下载 Windows 可执行文件，放到任意路径（本机示例：C:\Users\Administrator\rtk.exe）：

# 下载最新版
curl -LO https://github.com/reachforthejacked/rtk/releases/latest/download/rtk-x86_64-pc-windows-msvc.exe

# 重命名
mv rtk-x86_64-pc-windows-msvc.exe rtk.exe

# 放到 PATH 里（比如 C:\Users\你的用户名\）
# 或在 PATH 里加一个目录放它

验证安装：

rtk --version
# 输出: rtk 0.34.3

6.2 配置 Claude Code Hook

RTK 的核心机制是PreToolUse Hook——每次 Claude Code 要执行 Bash 命令时，先经过 RTK 做输出压缩。配置方式：

打开 Claude Code 配置文件 %USERPROFILE%\.claude\settings.json，在 hooks.PreToolUse 中添加一个 Bash matcher hook：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "C:\\Users\\Administrator\\rtk.exe hook claude",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

配置好后，Claude Code 每次执行 git status、ls、cat 等命令时，RTK 会自动接管，返回高度压缩后的输出。整个过程零感知，你看不到任何变化，只是 Token 消耗明显下降。

6.3 查看节省效果

# 查看 Token 节省统计
rtk gain

# 查看历史使用记录与节省明细
rtk gain --history

# 分析历史会话中错过的节省机会
rtk discover

# 查看各会话的 RTK 采用率
rtk session

6.4 工作原理

RTK 对不同类型的命令使用不同的压缩策略：

建议配合 everything-claude-code 插件使用（下文会装），这样读文件和写文件操作也能被 RTK 间接优化。

七、插件安装

Claude Code 支持插件市场，可以扩展功能。以下是一些经过验证的可用插件。

6.1 添加插件市场源

# 社区通用插件集
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# 全功能增强插件
/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

# 如果从 Gitee 拉（国内加速）
/plugin marketplace add https://gitee.com/yzsmzc/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

# 安装后关闭门卫（否则可能频繁弹提示）
echo 'export ECC_GATEGUARD=off' >> ~/.bashrc
source ~/.bashrc

6.2 官方技能市场

/plugin marketplace add anthropics/skills

# 安装官方项目规划技能集
/plugin install planning-with-files@anthropic-agent-skills

6.3 其他实用插件

# Karpathy 风格的编程技能
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills
# 或指定子集
/plugin install andrej-karpathy-skills@karpathy

# 记忆插件（跨会话记忆上下文）
/plugin marketplace add thedotmack/claude-mem --global
/plugin install claude-mem

# Axme Code 扩展
/plugin marketplace add AxmeAI/axme-code
/plugin install axme-code

# Claude HUD（屏幕内显示操作状态）
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

6.4 自动批准模式（需要先装 everything-claude-code）

claude --permission-mode auto

这样每次写文件、读文件不会再弹确认，适合快速迭代。有风险，建议在自己信任的项目中使用。

八、总结

1. 先装 Git，配置 CLAUDE_CODE_GIT_BASH_PATH 环境变量
2. 再装 Node.js 22 LTS，全程默认，配好淘宝镜像
3. 官方脚本安装 Claude Code，不要用 npm 全局安装
4. API 提供商推荐 DeepSeek，代码能力强且目前有活动
5. 装 RTK 并配置 Hook，自动节省 60-90% Token
6. 按需装插件，everything-claude-code 和 claude-mem 推荐优先安装

这套配置下来，你就能在 Windows 上流畅使用 Claude Code 了。

原文发表于 cn-res.vip