FastAIToken｜一个 API，接入每个 AI 模型

Claude Code Windows 安装配置完整指南

更新于 2026-10-27 · fastaitoken.cyou

简答：在 Windows 上安装 Claude Code，优先使用官方原生安装方式：PowerShell 执行 <code>irm https://claude.ai/install.ps1 | iex</code>，CMD 执行官方 CMD 安装命令；安装后重新打开终端，用 <code>claude --version</code> 和 <code>claude doctor</code> 验证。需要 Linux 工具链或沙盒能力时，再选择 WSL 2。

定义：Claude Code 是运行在终端中的编码代理，能够读取项目、编辑文件并执行命令；Windows 用户可以选择原生 Windows、Git Bash 或 WSL 2 环境运行。

先试这一步：按你的项目环境选择安装方式

如果你只是想在 Windows 项目目录中开始使用，建议先选原生 Windows，不必为了安装 Claude Code 额外配置 WSL。若项目依赖 Linux 工具链，或你希望在 WSL 发行版中管理依赖，则在 WSL 2 内单独安装并运行 Claude Code。官方文档将原生 Windows、WSL 2 和 WSL 1 分开说明，三者不要混用同一套安装命令。

方案适合谁是否需要 Git for Windows注意事项
原生 WindowsWindows 原生项目、PowerShell 或 CMD 用户不是必须；安装后可提供 Git Bash没有 Git for Windows 时，Shell 工具使用 PowerShell
Git Bash希望在原生 Windows 中使用 Bash 工具的用户需要安装 Git for Windows找不到 Bash 时，需要在设置中指定 bash.exe 路径
WSL 2Linux 工具链、Linux 项目目录或沙盒需求不需要必须在 WSL 终端内安装和启动，不要从 PowerShell 重复调用 WSL 内的安装结果
WSL 1无法使用 WSL 2 的旧环境不需要官方标注不支持沙盒能力

官方当前列出的系统要求包括 Windows 10 1809 或更高版本、Windows Server 2019 或更高版本、至少 4 GB 内存、x64 或 ARM64 处理器，并要求联网。具体可查看 Claude Code 官方安装文档。

Windows 原生安装：PowerShell 与 CMD 命令不要混用

先打开一个普通用户终端，不需要以管理员身份运行。判断当前终端的方法是：提示符显示 PS C:\Users\你的用户名>，通常是 PowerShell；如果显示 C:\Users\你的用户名> 且没有 PS，通常是 CMD。

  1. PowerShell 安装：在 PowerShell 中执行 irm https://claude.ai/install.ps1 | iex。
  2. CMD 安装：在 CMD 中执行 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。
  3. 安装完成后：关闭当前窗口，重新打开一个终端，再运行 claude --version。
  4. 开始使用：进入你的项目目录后运行 claude。

官方文档明确区分了两类命令：在 PowerShell 中使用 irm，在 CMD 中使用带 && 的 CMD 命令。如果在 PowerShell 中执行 CMD 命令，可能出现 The token '&&' is not a valid statement separator；如果在 CMD 中执行 PowerShell 命令，则可能出现 irm is not recognized。命令和终端必须匹配，参见 官方安装与验证说明。

安装后验证：版本号、诊断和首次启动

安装程序结束后没有明显进度条并不一定代表失败。先重新打开终端，再按以下顺序检查：

  1. 运行 claude --version，正常时应输出 Claude Code 的版本号。
  2. 运行 claude doctor，检查安装状态、设置文件校验和可能的警告。
  3. 进入一个测试项目目录，运行 claude。
  4. 首次启动时按照浏览器提示登录；登录完成后，回到终端确认出现登录成功提示。

claude doctor主要用于只读诊断，不会直接开始一个交互会话。如果版本命令失败，优先检查 PATH，而不是重复执行安装命令。官方对验证命令和诊断输出的说明见 Claude Code Advanced setup。

首次运行前，建议先复制一个不含生产密钥、SSH 私钥、云凭据和敏感配置的测试项目。Claude Code 可能读取项目文件并执行命令，先用低风险目录验证权限和工作流更稳妥。

登录方式怎么选：订阅账户、Console API Key 与网关凭据

Claude Code 的登录方式取决于你的账户和部署方式。个人或团队用户通常在运行 claude 后通过浏览器登录；Console 用户可以使用 Console 账户登录，也可以使用 API Key；企业环境还可能使用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 等云平台凭据。不要把不同方式的环境变量混在一起。

场景常见做法核验重点
Claude 订阅账户运行 claude，按浏览器提示登录确认登录的是有权限的账户
Claude Console API使用 Console 登录，或配置 ANTHROPIC_API_KEY确认组织权限、Key 状态和账户归属
Bearer Token 网关根据网关要求使用 ANTHROPIC_AUTH_TOKEN确认网关是否要求 Bearer 认证
云平台按对应平台文档配置凭据和环境变量不要同时保留会抢优先级的旧 API Key

认证头部不要混淆：官方文档说明，ANTHROPIC_AUTH_TOKEN 会作为 Authorization: Bearer 使用；ANTHROPIC_API_KEY 会作为 X-Api-Key 使用。若同时设置多个凭据，Claude Code 会按认证优先级选择其中一种，排查时可在 Claude Code 中查看 /status，确认当前使用的登录方式。具体规则见 官方 Authentication 文档。

如果浏览器没有自动打开，可以在登录提示处按 c 复制登录地址，再用浏览器访问；这对 WSL、SSH 或容器环境尤其有用。

Git Bash 配置：什么时候需要 CLAUDE_CODE_GIT_BASH_PATH

Git for Windows 不是原生 Windows 安装的硬性前置条件。没有 Git for Windows 时，Claude Code 可以使用 PowerShell 执行 Shell 命令；安装 Git for Windows 后，Claude Code 可以使用 Git Bash 提供 Bash 工具。

如果已经安装 Git for Windows，但 Claude Code 找不到 Bash，可在用户级设置文件中加入：

{ "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe" } }

Windows 用户级设置目录中的 ~/.claude 对应 %USERPROFILE%\.claude，不是 %APPDATA%\Claude。用户级设置文件通常是 %USERPROFILE%\.claude\settings.json。如果文件不存在，可以手动创建目录和文件。设置后重新打开终端，再运行 claude doctor 或启动新会话验证。官方的 Windows Git Bash 配置示例和设置文件路径见 安装文档与设置文件说明。

PATH 未生效：按“检查什么—看到什么—下一步”处理

现象先检查什么下一步
claude is not recognized 或找不到命令是否重新打开了终端关闭所有旧终端窗口，重新打开 PowerShell 或 CMD，再运行 claude --version
安装似乎完成，但版本命令仍失败用户 PATH 是否包含官方安装目录检查用户环境变量中的 %USERPROFILE%\.local\bin，修改后重新打开终端
PowerShell 报 irm 不存在当前是否实际处于 CMD改用 PowerShell，或在 CMD 中使用官方 CMD 安装命令
PowerShell 报 && 语法错误当前是否实际处于 PowerShell改用 CMD，或执行 PowerShell 专用安装命令
登录后仍然 403当前账户、组织权限和环境变量运行 /status，检查是否误用了失效或无权限的 API Key

官方 FAQ 说明，原生安装程序通常将 Claude 放在 Windows 用户目录下的 %USERPROFILE%\.local\bin；如果命令找不到，应将该目录加入 PATH 并重启终端。不要直接把路径写成其他账户的用户名，也不要只在当前窗口临时修改后就认为永久配置已经完成。可对照 Anthropic 帮助中心的 Claude Code FAQ。

WSL 2 与原生 Windows 的配置边界

选择 WSL 2 后，应打开具体的 WSL 发行版终端，在 Linux 环境内执行官方 Linux 安装命令：curl -fsSL https://claude.ai/install.sh | bash，随后在同一个 WSL 终端内运行 claude --version 和 claude。不要在 PowerShell 中执行 Linux 安装命令，也不要把 Windows 原生安装目录当成 WSL 内的安装目录。

如果项目本身使用 Linux 依赖，建议让代码、包管理器和 Claude Code 都处于 WSL 环境中；如果项目使用 Windows 工具链，则优先使用原生 Windows。两套环境都安装时，要分别验证版本、登录状态和项目路径，避免把一个环境的 PATH、凭据或依赖问题误判为另一个环境的故障。

官方文档说明，WSL 2 支持沙盒能力，原生 Windows 和 WSL 1 不支持；同时，WSL 设置不需要 Git for Windows。详细环境差异可查看 官方 Windows 设置章节。

安装、登录和安全自查清单

本文是基于公开官方资料整理的安装排错指南，不是 Claude Code 官方页面；版本、账户权限和可用登录方式以后续官方文档及当前账户页面为准。官方桌面应用下载入口与 Claude Code 终端入口可在Claude 下载页核对。

常见问题

Claude Code 在 Windows 上必须安装 Git for Windows 吗？

不是必须。原生 Windows 安装可以使用 PowerShell；安装 Git for Windows 后，Claude Code 才能使用 Git Bash 相关 Bash 工具。若不安装 Git for Windows，Shell 命令会使用 PowerShell 工具。

PowerShell 和 CMD 应该使用哪条安装命令？

PowerShell 使用 <code>irm https://claude.ai/install.ps1 | iex</code>；CMD 使用官方 CMD 安装命令。不要把 <code>irm</code> 命令放进 CMD，也不要把带 <code>&&</code> 的 CMD 命令直接放进 PowerShell。

Windows 下 settings.json 放在哪里？

用户级设置通常位于 <code>%USERPROFILE%\.claude\settings.json</code>，因为 Windows 下官方文档将 <code>~/.claude</code> 映射为 <code>%USERPROFILE%\.claude</code>。项目共享设置则位于项目目录的 <code>.claude/settings.json</code>。

Claude Code 安装后提示 claude 不是命令怎么办？

先关闭并重新打开终端，再运行 <code>claude --version</code>。如果仍失败，检查用户 PATH 是否包含 <code>%USERPROFILE%\.local\bin</code>，然后运行 <code>claude doctor</code>。

ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 有什么区别？

<code>ANTHROPIC_API_KEY</code>按 <code>X-Api-Key</code>方式使用，通常对应 Anthropic API Key；<code>ANTHROPIC_AUTH_TOKEN</code>按 <code>Authorization: Bearer</code>方式使用，通常用于要求 Bearer Token 的网关或代理。两者不要根据旧教程互换。

桌面版 Claude 和终端 Claude Code 是同一个安装吗？

不是完全相同的使用入口。官方桌面应用可以提供图形界面和内置的 Code 使用环境；终端中的 <code>claude</code>仍需按 Claude Code 的终端安装流程配置。需要命令行、项目目录和 Shell 工具时，应验证终端版是否单独可用。

相关阅读

参考资料

  1. Claude Code 官方文档：Advanced setup（code.claude.com）
  2. Anthropic 帮助中心：Claude Code 用户常见问题解答（support.claude.com）
  3. Claude 官方下载页（claude.com）