接入

Windows 安装和配置 Claude Code

Windows 上有两种用法：直接在 PowerShell 里运行，或者装进 WSL 当 Linux 用。这一页按原生 Windows 讲安装、配置和常见问题，WSL 见最后一节。

安装

推荐：原生安装

打开 PowerShell（不需要管理员），运行：

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

装好后关掉这个窗口，新开一个 PowerShell，运行 claude --version，能打印版本号就说明装好了。安装程序会把 claude 所在的目录加进用户的 PATH，只有新开的终端才读得到。

或者：npm 安装

已经装了 Node.js 22 或更高版本的，也可以：

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

下载慢时可以先切到国内 npm 镜像。两种方式装一种就够了，都装会让 claude 指向哪一个变得不确定。

Git for Windows（可选）

Git for Windows 在原生 Windows 上是可选的。不装时，Claude Code 用 PowerShell 执行命令；装了之后改用 Git Bash，Bash 工具和 Monitor 工具也只有装了 Git Bash 才能用（见官方安装说明）。平时就用 Git 的，建议装上。

装了 Git 但 Claude Code 找不到 Git Bash 时，在 settings.json 的 env 里用 CLAUDE_CODE_GIT_BASH_PATH 指向 bash.exe，例如 "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"（JSON 里的反斜杠要写两个）。

配置

方式一：写入配置文件（推荐）

在资源管理器地址栏输入 %USERPROFILE%\.claude 打开目录（没有就新建 .claude 文件夹），用记事本或 VS Code 新建或编辑 settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

保存时编码选 UTF-8。已有内容时只合并 env 这一段，注意逗号和引号要成对。这个文件 PowerShell、Git Bash 和 VS Code 插件都会读，改一次处处生效。

方式二：环境变量

只想在当前窗口试一下：

$env:ANTHROPIC_BASE_URL = "https://corecode.live"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude

想永久生效，用 setx 写入用户环境变量，然后重开终端（setx 不影响已经打开的窗口）：

setx ANTHROPIC_BASE_URL https://corecode.live
setx ANTHROPIC_AUTH_TOKEN sk-你的密钥

不要同时设置 ANTHROPIC_API_KEY，否则会报 Auth conflict，见报错排查。

检查是否生效

claude -p "回复 ok"

返回 ok 即接通。在 Claude Code 里输入 /status，能看到 Base URL 是 https://corecode.live。

常见问题

现象	怎么办
`claude` 不是内部或外部命令，或 `The term 'claude' is not recognized`	新开一个终端再试。还不行，检查用户 `PATH` 里有没有 Claude Code 的安装目录；用 npm 装的，检查 `npm config get prefix` 显示的目录在不在 `PATH` 里。
因为在此系统上禁止运行脚本（`running scripts is disabled on this system`）	npm 安装生成的 `claude.ps1` 被 PowerShell 的执行策略拦住了。运行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 后重开终端，或者改用原生安装。
首次启动报 `Unable to connect to Anthropic services`	在 `%USERPROFILE%\.claude.json` 最外层加上 `"hasCompletedOnboarding": true`，见报错排查。
改了配置还在走官方，或提示 `/login`	确认 `settings.json` 在 `%USERPROFILE%\.claude\` 下、文件名没有被记事本加上 `.txt`，然后重开终端。
中文乱码	用 Windows Terminal 运行 Claude Code；配置文件保存为 UTF-8。

VS Code 和 JetBrains

VS Code 的 Claude Code 插件和命令行共用 %USERPROFILE%\.claude\settings.json。按方式一写好后，完全退出 VS Code 再打开即可。插件里登录过 claude.ai 账号的，先退出登录。JetBrains 插件在 IDE 的终端里运行命令行版，配置方法相同。

用 WSL

已经在用 WSL 开发的，可以把 Claude Code 装在 WSL 里，按 Linux 的方式安装和配置：

curl -fsSL https://claude.ai/install.sh | bash

配置写在 WSL 里的 ~/.claude/settings.json，和 Windows 那边的 %USERPROFILE%\.claude 是两份，互不影响。项目放在 WSL 的文件系统里（如 ~/project），比放在 /mnt/c 下快得多。

更多配置项和常用命令见 Claude Code 接入。