Claude Code 安装教程(Windows)
0. 前置:安装 Node.js
先装 Node.js(建议 22+):Nodejs Windows
验证:
powershell
node -vpowershell
npm -v1. 安装 Claude Code
打开 PowerShell,执行:
powershell
npm install -g @anthropic-ai/claude-code验证安装:
powershell
claude --version2. 接入词元AI(配置环境变量)
2.1 什么是环境变量?
环境变量就是告诉 Claude Code 去哪里调用 AI 服务,以及用什么密钥。
你需要设置两个环境变量:
ANTHROPIC_BASE_URL- 词元AI的服务地址ANTHROPIC_AUTH_TOKEN- 你的词元AI Key(密钥)
2.2 设置环境变量(永久生效)
重要提示:下面的命令会把配置永久保存到你的用户环境变量里,重启电脑也不会丢失。
第一步:设置 API 服务地址
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.ci-yuan-ai.com","User")第二步:设置你的 API Key(注意替换)
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的词元AI Key","User")必须替换:把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key
第三步:关闭 PowerShell,重新打开一个新的 PowerShell 窗口
为什么要重开? 因为环境变量只有在新打开的窗口里才会生效。
2.3 验证环境变量是否设置成功
在新打开的 PowerShell 里,分别执行下面两个命令:
powershell
echo $env:ANTHROPIC_BASE_URL应该显示:https://api.ci-yuan-ai.com
powershell
echo $env:ANTHROPIC_AUTH_TOKEN应该显示你设置的 API Key(如果显示出来了,说明设置成功)
3. 启动并验证
进入你的项目目录:
powershell
cd C:\path\to\your\project把 C:\path\to\your\project 替换成你的项目路径
powershell
claude如果你只想快速验证连通性,也可以先在空目录里运行 claude doctor:
powershell
claude doctor常见问题
1) npm install -g 报权限错误
优先用下面两种方式之一解决:
- 用管理员 PowerShell 再试一次(最省事)
- 用 nvm-windows 管理 Node(更干净,但要多一步安装)
2) 环境变量设置后不生效
Windows 的 SetEnvironmentVariable(...,"User") 需要重开终端才会加载。若仍不生效,注销或重启。