Windows原生支持来了!Claude Code 全平台配置完整指南

875 阅读2分钟

Claude Code 版本带来了重磅更新,正式支持Windows原生运行,彻底告别了繁琐的WSL配置。

Windows用户终于可以像Mac和Linux用户一样,直接享受Claude Code带来的AI编程体验。

各平台具体要求:

macOS 10.15+
Ubuntu 20.04+/Debian 10+
Windows 10+(现已原生支持,仅需Git for Windows)

通用要求:

要想正常使用Cc,必须且安装和配置好以下的开发环境和工具:

Node.js 18+

下载地址 nodejs.org/zh-cn

Git 2.23+
下载地址 git-scm.com/

Mac/Linux 配置指南

在终端运行全局安装命令

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

获取API密钥后,需要配置环境变量。在~/.zshrc文件中添加:

export ANTHROPIC_API_KEY="sk-***"
export ANTHROPIC_BASE_URL="https://xxx.com"

如果配置好了没有API_KEY和BASE_URL,可登录h5ma.cn/bwz 创建一个API_KEY。

如报错403,No active subscription 可发送任意邮件到ClaudeCode@163.com解决。

对于Mac用户,可以通过快捷键Command+Shift+.显示隐藏的.zshrc文件,用系统文本编辑APP打开并添加上述内容。

添加配置后,执行以下命令使配置生效:

source ~/.zshrc

定位到目标项目目录,输入claude启动:

cd ~/Desktop/my-project
claude

Windows 原生配置指南

安装Git for Windows:

前往gitforwindows.org/

下载最新版本。这是Windows原生支持的关键依赖,将自动提供grep、find、awk、sed、curl、wget、tar、ssh等Unix命令。

然后在PowerShell管理员模式下运行

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

全局安装Claude Code

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

不过在Windows可能会遇到一些安装问题,需要忽略脚本的方式运行

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

然后是环境配置,通过系统设置配置环境变量:

右键"此电脑",选择属性,点击"高级系统设置",点击"环境变量",在用户变量中添加如下配置。

ANTHROPIC_API_KEY:sk-***
ANTHROPIC_BASE_URL:https://x.com

如果没有API_KEY和BASE_URL,可登录h5ma.cn/bwz 创建一个API_KEY。

启动和验证

cd your-project-folder
claude
claude doctor

下面是所有系统登录通用配置。

首次启动时,使用发现报错403,No active subscription 可发送任意邮件到ClaudeCode@163.com解决。

如果想绕过验证直接使用转发服务,可以在用户目录下的.claude.json文件中增加:

{
  "hasCompletedOnboarding": true
}

启动后,Claude Code会显示当前配置信息,包括API Key和API Base URL。当系统检测到自定义API key时,选择"Yes"确认使用即可。