Claude Code Windows 详细安装与配置

接入端点：https://xh.v1api.cc
适用：Windows 10 / 11，PowerShell 或 CMD

一、安装 Node.js

Claude Code CLI 依赖 Node.js（建议 LTS，v18+）。

方式 A：官网安装包
访问 https://nodejs.org/ ，下载 LTS 版本，一路下一步。

方式 B：winget（推荐）

winget install OpenJS.NodeJS.LTS

安装后重新打开一个终端窗口，验证：

node --version
npm --version

两条命令都能输出版本号即代表 OK。

二、安装 Claude Code CLI

在 PowerShell 或 CMD 中执行：

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

如果报权限错误，用「管理员身份」打开 PowerShell 再执行一次。

验证：

claude --version

三、写入配置文件

1. 配置文件路径

%USERPROFILE%\.claude\settings.json

实际通常是：C:\Users\你的用户名\.claude\settings.json

2. 创建目录（如果不存在）

mkdir $env:USERPROFILE\.claude

3. 用记事本/VSCode 创建并写入

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你自己的Key",
    "ANTHROPIC_BASE_URL": "https://xh.v1api.cc"
  }
}

⚠️ 必须是合法 JSON：键和字符串都是双引号、最后一项不要带逗号。

4. PowerShell 一行写入（懒人版）

@'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_BASE_URL": "https://xh.v1api.cc"
  }
}
'@ | Out-File -Encoding utf8 "$env:USERPROFILE\.claude\settings.json"

四、启动并验证

cd D:\你的项目目录
claude

首次进入会有引导，按提示完成即可。

五、临时切换模型

启动时指定：

claude --model claude-sonnet-4-5

或会话内：

/model claude-sonnet-4-5

具体可用模型清单参考 07-模型选择与切换.md。

六、Windows 常见坑

1. 提示 `claude` 不是内部或外部命令

关闭终端重开一次（环境变量没刷新）

检查 npm 全局路径：npm config get prefix，把该路径加进系统 PATH

重新执行 npm i -g @anthropic-ai/claude-code

2. PowerShell 提示「无法加载脚本，因为在此系统上禁止运行脚本」

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 中文乱码

把终端切成 UTF-8：

chcp 65001

4. 公司电脑装不上 / npm 卡住

检查是否有公司代理 / 自签证书

临时切官方源：npm config set registry https://registry.npmjs.org/

七、卸载

npm uninstall -g @anthropic-ai/claude-code
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"

未命名文档

Claude Code Windows 详细安装与配置#

一、安装 Node.js#

二、安装 Claude Code CLI#

三、写入配置文件#

1. 配置文件路径#

2. 创建目录（如果不存在）#

3. 用记事本/VSCode 创建并写入#

4. PowerShell 一行写入（懒人版）#

四、启动并验证#

五、临时切换模型#

六、Windows 常见坑#

1. 提示 claude 不是内部或外部命令#

2. PowerShell 提示「无法加载脚本，因为在此系统上禁止运行脚本」#

3. 中文乱码#

4. 公司电脑装不上 / npm 卡住#

七、卸载#