Windows 上的 Claude Code：开发者设置

Windows 上专业 Claude Code 配置：IT 专业人士的关键技巧

在 Windows 上设置 Claude Code 需要考虑操作系统的特定特性以及与开发工具的集成。本文分享了与 AWS、PowerShell 和 Git Bash 无缝协作的可靠配置方案，避免各种错误。

环境准备

为了让 Claude Code 正常运行，需要正确配置基础组件。首先安装 Git Bash——这是关键组件，因为 Claude Code 安装程序使用它来执行命令：

winget install Git.Git

Git 安装过程中，保留所有默认设置，包括与资源管理器的集成以及添加到 PATH。特别注意 PowerShell：Windows 默认使用基于 .NET Framework 的旧版 5.1。现代项目需要 PowerShell 7+：

winget install Microsoft.PowerShell

安装后，启动 pwsh，而非 powershell.exe。检查版本：

pwsh --version

重要提示：后续所有命令必须在 PowerShell 7+ 中运行。为方便起见，使用 Windows Terminal，它支持同时使用多种 Shell。

安装和认证

关键安装要点：

• 使用官方脚本：

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

• WinGet 备选方案需要手动更新：

winget install Anthropic.ClaudeCode

• 指定版本：

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.105

安装后，验证运行：

claude --version
claude doctor

如果出现 command not found 错误，手动添加路径：

$userPath = [Environment]::GetEnvironmentVariable("PATH", "User")
[Environment]::SetEnvironmentVariable("PATH", 
  "$userPath;$env:USERPROFILE\.local\bin", 
  "User")

认证方式：

• 大多数用户只需运行 claude 即可通过浏览器登录
• API 计费设置密钥：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-...", "User")

Windows 特定配置

修复 PowerShell 问题

默认情况下，Claude Code 使用 Git Bash，这会导致与 PowerShell 语法的冲突。为正常运行，在 %USERPROFILE%\.claude\settings.json 中添加：

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1",
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  },
  "defaultShell": "powershell"
}

这将启用：

• 自动检测 pwsh.exe
• 将交互命令重定向到 PowerShell
• 保留 Git Bash 用于内部操作

处理路径和文件系统

NTFS 与 Linux 文件系统有本质区别：

• 文件名不区分大小写
• 符号链接需要权限
• 行尾处理问题（CRLF 与 LF）

关键设置：

• 始终使用 Windows 路径（反斜杠）
• 脚本添加行尾转换：

(Get-Content script.sh) -replace "`r`n", "`n" | Set-Content -NoNewline script.sh

• 在全局指令 (%USERPROFILE%\.claude\CLAUDE.md) 中指定：

# 文件路径
- 使用 Windows 路径：C:\\Users\\<user>\\projects\\...
- 不要使用 Unix 路径

与云服务的集成

AWS 和 PowerShell

通过 PowerShell 处理 AWS：

• 安装 AWS Tools for PowerShell
• 在 %USERPROFILE%\.aws\credentials 配置配置文件
• 在 CLAUDE.md 中添加：

# 可用工具
- AWS 操作使用 aws-powershell
- 使用 SSM 文档结合 PowerShell

修复 MCP 服务器问题

MCP 使用 Unix 域套接字，Windows 不支持。变通方案：

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:/Projects"]
    }
  }
}

重要提示：

• JSON 路径使用正斜杠
• 服务器代码避免硬编码 Unix 路径
• 临时文件明确指定 Windows 路径

关键要点

• PowerShell 7+ 必备——5.1 版不支持现代场景
• Git Bash 至关重要——即使使用 PowerShell，也需其内部操作
• Windows 风格路径——Claude Code 不识别 Unix 路径或 ~-快捷方式
• MCP 问题——Windows 上需通过 cmd /c 手动设置
• 行尾——脚本需自动 CRLF→LF 转换

俄罗斯开发者的实用建议

从 2026 年起，俄罗斯官方无法访问 Claude Code。推荐方案：

• 通过云提供商的企业账户（AWS Bedrock）
• 带认证的代理服务器
• API 预付费计费
• 本地化路径的替代 MCP 服务器

重要：使用 API 密钥时，确保其有效并绑定活跃账户。通过 claude /status 检查状态。

结语

Windows 上 Claude Code 配置的核心在于三点：正确的 PowerShell 设置、NTFS 适配以及 MCP 服务器修复。对于 AWS 开发者，在配置文件中正确指定路径并处理行尾至关重要。遵循这些步骤，即可达到 Linux 级别的性能。

— Editorial Team