Claude Code Windows 使用教程
注意事项
- 用中转的话，国内用户不要翻🪜
- ! 使用前请使用
/model命令切换haiku 或者 sonnet模型，省钱且效果很好
Windows使用教程
环境准备
安装 Node
访问 Node官网 https://nodejs.org/en/download ，需要注意，选择正确的芯片结构，不对的话就选另一个，请确保 Node.js 版本为 18.0以上或更高版本的：
下载后点击安装，等待安装成功即可。
安装 Git
访问 https://git-scm.com/install/windows，选择系统合适的版本进行下载。
下载成功后，运行 .exe 文件，按默认选项安装即可
安装 CC
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
必配参数
在开始使用前，我们做好准备工作，第一次进来没有 .claude.json文件，先在不翻墙的情况下运行claude，启动会报错如下：有报错才对哈
此时就会生成 .claude.json文件，有了这个配置文件就好干活了，为了更方便使用 Claude Code，我们一定要加上以下配置，🪜绕过 Claude Code 认证，跳过国家地区检查（运行提示：Unable to connect to Anthropic services），
请按照以下步骤进行操作：
按下键盘上的 Win+R键，会弹出一个小窗口，在这个小窗口里输入 %USERPROFILE%，按下回车键。此时你会看到一些目录文件，用记事本打开 .claude.json，在第一行编辑增加：
# 在 json 文件顶层配置
"hasCompletedOnboarding":true,
注意这里有逗号，放在大括号后第一行即可，接下来就说说怎么启动 claude。
推荐👉命令行执行
按下键盘组合键 Win + R，弹出运行命令窗口，在运行窗口中输入 cmd，然后执行下面的命令，记得将命令里你的密钥更换下：
set ANTHROPIC_API_KEY=你的密钥 && set ANTHROPIC_BASE_URL=https://xxx && claude
这里执行没问题之后，后面都不用操作了，我们也最推荐这种形式启动。如果执行成功，下面的就不用跟着做了。
修改全局变量
按 Win + R，输入 sysdm.cpl
点击高级->环境变量：
点击新建（加系统的环境变量），然后创建两个环境变量：
- ANTHROPIC_API_KEY
- ANTHROPIC_BASE_URL
这两个变量的值我们客服都会发送给你。
修改配置文件
-
打开运行窗口
- 按下键盘组合键
Win + R - 弹出运行命令窗口
- 按下键盘组合键
-
访问用户目录
-
在运行窗口中输入
%USERPROFILE% -
按回车键打开当前用户目录
-
编辑配置文件
-
找到
.claude/settings.json文件（若不存在请先运行Claude程序生成或者手动创建） -
用记事本打开该文件
-
修改API配置（保留引号和逗号）
-
"ANTHROPIC_API_KEY": "替换为你的key",
-
"ANTHROPIC_BASE_URL": "替换为你的url"
{
"env": {
"ANTHROPIC_API_KEY": "我们的 Key",
"ANTHROPIC_BASE_URL": "https://xxxx"
}
}
配置好密钥之后就可以启动 Claude了，在 Windows系统中启动 Claude命令行工具，首先按下 Win+R组合键打开运行窗口，输入 cmd并回车进入命令提示符界面。
在终端中输入 claude命令后回车执行，等待5-10秒初始化，当出现">"提示符即表示启动成功。
常见问题
提示InvalidAPIKey
一般是因为密钥复制粘贴出现了差错，怎么排查？
按下键盘上的 Win+键，会弹出一个小窗口，在这个小窗口里输入 %USERPROFILE%，按下回车键。此时你会看到一些目录文件。
查看这两个文件：
%USERPROFILE%\.claude\settings.json%USERPROFILE%\.claude.json
然后找到环境变量设置密钥即可：
- "ANTHROPIC_API_KEY": "替换为你的key",
- "ANTHROPIC_BASE_URL": "替换为你的url"
参考配置密钥部分教程。
启动报错：claude:commandnotfound
建议重新安装：
npm install -g @anthropic-ai/claude-code --ignore-scripts
如何重装 Claude Code
# 卸载
npm uninstall -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
可自行评估是否需要清楚缓存数据，打开 powershell：
if (Test-Path "$HOME\.claude.json") { Remove-Item "$HOME\.claude.json" -Force }
if (Test-Path "$HOME\.claude") { Remove-Item "$HOME\.claude" -Recurse -Force }
# 清除环境变量
$vars = @(
"ANTHROPIC_API_KEY","ANTHROPIC_AUTH_TOKEN","ANTHROPIC_MODEL",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC","DISABLE_AUTOUPDATER",
"DISABLE_TELEMETRY","DISABLE_ERROR_REPORTING","HTTP_PROXY","HTTPS_PROXY",
"SHELL","NPM_CONFIG_IGNORE_SCRIPTS","CLAUDE_CODE_GIT_BASH_PATH"
)
foreach ($v in $vars) { [Environment]::SetEnvironmentVariable($v, $null, "User") }
重装：
# 重装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
如需🪜绕过 Claude Code 认证，跳过国家地区检查，请看第一个常见问题。
