Windows Claude Code 使用说明

在 Windows 系统上安装官方 Claude Code CLI，并配置为使用积木AI代码助手。

返回 下载脚本 登录后创建 Claude Code Key
开始前先做这一步：先到 Key 管理 创建 Claude Code Key。文档里所有 你的Claude_API_KEY 都必须替换成你自己的真实 Key，否则无法使用。

先选一种方式

如果你是不熟悉命令行的用户，优先用“下载脚本”；如果你更习惯直接在终端执行命令，就用“复制脚本”；只有需要逐步排障时，再看完整说明。
下载脚本 完整说明 
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/claude-install.ps1 | iex"
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_PACKAGE','@anthropic-ai/claude-code','Process'); [Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_DISPLAY_NAME','Claude Code CLI','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/npm-global-install.ps1 | iex"
powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_CLAUDE_KEY','你的Claude_API_KEY','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/claude-deploy.ps1 | iex"

系统要求

系统
Windows 10（版本 1809 / build 17763）及以上
依赖
Git（包含 Git Bash）+ Node.js 18+ + npm
Node.js 安装（如果没有安装）
前往 nodejs.org/zh-cn/download 下载。
Git 安装（必须）
前往 git-scm.com/downloads/win 下载，保持默认一路下一步（不要改路径）。如访问不稳定，可用清华镜像 mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/，选择 Git for Windows 下载。

安装步骤（Windows 终端）

1

环境检查（推荐）

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/claude-install.ps1 | iex"

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行；脚本会检查 Node.js / npm / Git / Git Bash，并提示修复方式；第三步配置会自动写入 Git Bash 路径。若提示缺少依赖，请先按“系统要求”完成安装后再重试。

也可以手动执行：

node -v
npm -v

若提示 “No suitable shell found”，通常是 Git 没装好或 Git Bash 路径没写入。重新执行第三步配置会自动尝试写入；也可以手动加入下面变量后重启终端：

CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
2

卸载已安装的 Claude Code（可选，未安装请跳过）

powershell -NoProfile -ExecutionPolicy Bypass -Command "npm uninstall -g @anthropic-ai/claude-code"
3

安装官方原版包

powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_PACKAGE','@anthropic-ai/claude-code','Process'); [Environment]::SetEnvironmentVariable('JIMUXYZ_NPM_DISPLAY_NAME','Claude Code CLI','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/npm-global-install.ps1 | iex"
4

验证安装

claude -v

若 PowerShell 提示“无法加载 claude.ps1，因为在此系统上禁止运行脚本”，请先执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新打开终端再试。

5

登录后创建并复制 Claude Code Key

登录后到「Key 管理」页面创建一个新的 Claude Code Key，并复制你自己的 你的Claude_API_KEY 对应真实值。

6

一键写入配置（脚本写入配置）

把 Claude Code Key 写进命令（替换 你的Claude_API_KEY 后执行）：

powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_CLAUDE_KEY','你的Claude_API_KEY','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/claude-deploy.ps1 | iex"

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行。设置完成后请完全退出 PowerShell / Windows Terminal / VSCode / JetBrains 等已经打开的终端或编辑器，再重新打开；只新建一个终端窗口有时仍会读到旧环境变量。

如仍连接到官方地址，可删除 C:\Users\你的用户名\.claude.json 后重试。

如遇 400，可新增：setx CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS "1"。

或者

如果你不想用脚本，可手动写入系统环境变量（新终端生效）：

setx ANTHROPIC_BASE_URL "https://code.jimuxyz.com/p"
setx ANTHROPIC_API_KEY "你的Claude_API_KEY"
setx ANTHROPIC_AUTH_TOKEN "你的Claude_API_KEY"
setx ANTHROPIC_MODEL "claude-sonnet-4-6"
setx API_TIMEOUT_MS "3000000"
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

设置完成后请完全退出 PowerShell / Windows Terminal / VSCode / JetBrains 等已经打开的终端或编辑器，再重新打开；只新建一个终端窗口有时仍会读到旧环境变量。

重要：VSCode 必须完全退出后再打开
  • 脚本写入的是 Windows 用户级环境变量，已经打开的 VSCode / Windows Terminal / PowerShell 不会自动刷新。
  • 安装或写入配置后，请关闭所有 VSCode 窗口；必要时在任务管理器确认 Code.exe 已退出，再重新打开 VSCode 并新建终端运行 claude。
  • 如果还看到旧的超时配置、旧模型、Auth token: none 或 401 APIKey校验失败，通常就是旧 VSCode / 旧终端仍在使用旧环境变量。
VSCode 插件仍提示登录怎么办？
  • 先完全退出 VSCode，再重新打开项目和终端。
  • 如果仍弹官方登录，重新执行上面的“一键写入配置”命令；脚本会写入本地 Claude Code 配置，告诉插件使用当前 Key 来源。
  • 进入 Claude Code 后输入 /status，确认模型显示为 claude-sonnet-4-6 或你手动选择的 Claude 模型。
7

启动 Claude Code

设置完成后请先完全退出当前终端、VSCode 或其他编辑器，再重新打开使用。

# 导航到你的项目（可选）
cd your-project

# 启动 Claude Code
claude

# 进入 Claude Code 后可输入 /status 检查当前模型和 API 地址
/status