Windows 安装与使用

给 Windows 用户的一条完整主线：装依赖、配 API Key、安装 Claude Code、第一次启动。

先选对系统页

如果你不是 Windows 用户，直接改看：

这一页只做一件事：让你在 Windows 上把 Claude Code 跑通

你只要按顺序完成下面 4 步就够了：

装好 Node.js、npm 和 Git
准备可用的 API Key
安装 Claude Code
完成第一次启动和对话

第 1 步：装好 Node.js、npm 和 Git

Claude Code 在 Windows 上最基础的依赖只有 3 个：Node.js、npm 和 Git。

下面这些命令用什么终端运行？

对大多数 Windows 新手，最简单的是直接打开 Windows Terminal。

如果你电脑里没有它，用 PowerShell 或 CMD 命令提示符 也可以。

1. 安装 Node.js 和 npm

先去 Node.js 官网下载 Windows 安装包。

对大多数人，记住这 3 点就够了：

优先选 LTS 版本
安装 Node.js 时，npm 会一起装好
安装过程大多数选项保持默认即可

安装完成后，打开终端运行：

node -v
npm -v

如果都能返回版本号，说明 Node.js 和 npm 已经装好。

2. 安装 Git

再去 Git for Windows 官网下载并安装 Git。

安装完成后，运行：

git --version

如果能返回版本号，就说明 Git 已经可用。

3. 先确认 3 条命令都通

继续往下前，先确认下面 3 条都成立：

node -v 能返回版本号
npm -v 能返回版本号
git --version 能返回版本号

这里有命令跑不通，就先不要继续

先把依赖装完整，再继续后面的安装和配置。

第 2 步：准备可用的 API Key

1. 登录 `api.dingjiai.com`

如果你还没有账号，就先注册；如果已经有账号，直接登录。

2. 先完成充值

Claude Code 后面调用模型时，需要消耗额度。

所以登录后，先按页面提示完成充值。

3. 创建新的 API Key

充值完成后，在后台创建一个新的 API Key。

后面配置 Claude Code 时会直接用到它。

4. 把 API Key 保存好

先把这串 Key 保存到一个你自己能稳定找到的位置。

同时注意：

不要把 API Key 发给别人
不要把 API Key 提交到代码仓库

把 API Key 当成密码来保管

谁拿到这串 Key，谁就可能用掉你的额度。

第 3 步：安装 Claude Code

1. 打开 Windows Terminal、PowerShell 或 CMD

如果你不知道选哪个，就优先用 Windows Terminal。

2. 运行安装命令

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

这条命令的目标只有一个：把 Claude Code 装成你电脑里的全局命令。

3. 立刻检查版本号

安装结束后，马上运行：

claude --version

如果能正常返回版本号，就说明 Claude Code 已经安装成功。

装完马上验证，不要靠感觉判断

对新手来说，最稳的做法不是“看起来好像装上了”，而是直接用 claude --version 验证。

第 4 步：把 API Key 配进 Windows 终端

第一次先用临时方式验证最稳

先把 Claude Code 跑通，再决定要不要写成长期配置。

当前终端临时生效

如果你用的是 PowerShell，可以先运行：

$env:ANTHROPIC_API_KEY="你的 API Key"

如果你的接入方式还要求 Base URL，再补一条：

$env:ANTHROPIC_BASE_URL="你的 Base URL"

想长期生效，再写到用户环境变量

如果你确认上面的临时方式能跑通，再执行：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的 API Key", "User")

如果你还需要 Base URL，再补一条：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "你的 Base URL", "User")

写入后，关掉所有终端窗口，再重新打开一次。

第 5 步：进入项目并启动 Claude Code

1. 先进入你要处理的项目目录

例如：

cd D:/my-project

如果路径里有空格，写成：

cd "D:/my project"

先站对目录，再启动 Claude Code。

2. 启动 Claude Code

在项目目录里运行：

claude

如果前面的安装和配置都没问题，这里会进入 Claude Code 的交互界面。

3. 第一次先给一个简单任务

第一次不要一上来就做大改动，先试这种轻量问题：

解释这个项目的目录结构
这个项目的入口文件在哪里
先帮我看看这个项目主要是做什么的

只要它能正常读项目、正常回应，这条主线就已经跑通了。

Windows 下最常见的 3 个问题

1. `claude --version` 找不到命令

先检查：

node -v
npm -v

如果这两条都正常，再重新运行一次：

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

2. 明明装完了，命令还是不生效

有时只是当前终端还没刷新到新的全局命令路径。

最简单的处理方式就是：

关掉当前终端
重新打开 Windows Terminal / PowerShell / CMD
再次运行 claude --version

3. 启动时报认证或连接错误

优先检查这 3 件事：

ANTHROPIC_API_KEY 有没有写对
如果你的路线需要 ANTHROPIC_BASE_URL，有没有一起配好
你是不是在设置变量后又开了一个没继承配置的新终端

做到什么状态算完成

满足下面这几条，就说明 Windows 这条路线已经跑通了

你已经装好 Node.js、npm 和 Git
你已经准备好可用的 API Key
你已经成功运行过 npm install -g @anthropic-ai/claude-code
claude --version 能正常返回版本号
你已经在项目目录里成功启动过 claude

跑通后，下一步继续看更多。

On this page