Claude Code 原生支持 Windows：一篇详尽的安装与配置指南

Claude Code 作为一款由 Anthropic 公司推出的命令行 AI 编程辅助工具，可以直接在终端环境中与项目代码进行交互，帮助开发者完成代码生成、逻辑解释和错误排查等任务。在 1.0.51 版本更新后，Claude Code 终于为 Windows 平台带来了原生支持，这意味着 Windows 用户不再需要通过 WSL (Windows Subsystem for Linux) 进行繁琐的配置，从而避免了潜在的性能开销和文件系统兼容性问题。

环境要求

在安装前，请确保系统满足以下条件：

• 操作系统
  • Windows: Windows 10 或更高版本
  • macOS: macOS 10.15 或更高版本
  • Linux: Ubuntu 20.04+ / Debian 10+ 或兼容发行版
• 通用工具
  • Node.js: 18+ 版本 (下载地址)
  • Git: 2.23+ 版本 (下载地址)

安装与配置

不同平台的安装方式略有差异，以下为具体步骤。

Mac 与 Linux

在 macOS 或 Linux 系统上，打开终端并执行以下全局安装命令：

npm install -g @anthropic-ai/claude-code

安装完成后，需要配置环境变量以授权。编辑用户目录下的 .zshrc (Zsh) 或 .bashrc (Bash) 配置文件，添加以下内容：

export ANTHROPIC_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

提示: 在 macOS 上，你可以使用快捷键 Command+Shift+. 来显示隐藏文件，然后使用文本编辑器打开 .zshrc 文件。

添加配置后，执行 source ~/.zshrc 命令使改动立即生效。

Windows 原生配置

Windows 平台的原生支持依赖 Git for Windows 提供的 Unix 命令行工具集。

1. 安装 Git for Windows
   请前往 gitforwindows.org 下载并安装最新版本。安装程序会自动配置好 grep、curl、ssh 等必要的命令。
2. 设置执行策略
   以管理员模式打开 PowerShell，运行以下命令以允许 npm 执行安装脚本：

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

3. 全局安装 Claude Code
   在 PowerShell 中执行以下命令进行安装：

   npm install -g @anthropic-ai/claude-code@latest
   

   如果在安装过程中遇到脚本执行相关的错误，可以尝试使用 --ignore-scripts 参数来解决：

   npm install -g @anthropic-ai/claude-code --ignore-scripts
   

4. 配置环境变量
   打开 PowerShell 并执行以下命令来设置环境变量，请将 sk-... 替换为你的 API 密钥。

   [System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-...", "User")
   [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.anthropic.com", "User")
   

   配置完成后，需要重启 PowerShell 终端使环境变量生效。

首次启动与使用

完成安装和配置后，即可开始使用。

1. 启动工具
   在终端中，进入你的项目文件夹，然后执行 claude 命令。

   cd ~/Desktop/my-project
   claude
   

2. 验证配置
   你可以随时运行 claude doctor 命令来检查 Claude Code 的配置是否正确，它会列出当前检测到的 API 密钥和 Base URL。
3. 账户授权
   首次启动时，如果未使用自定义 API 密钥，工具可能会在浏览器中打开一个授权页面，需要你登录 Claude 官网进行确认。

   当工具检测到你已配置自定义 API 密钥时，会提示是否使用该密钥，选择 “Yes” 即可。

   如果你正在使用第三方代理服务并希望跳过官方的登录验证流程，可以在用户主目录下的 .claude.json 文件中添加以下内容：

   {
   "hasCompletedOnboarding": true
   }