claude code安装教程及问题(windows平台)

2 阅读1分钟

PS:以下powerShell窗口都需要管理员权限。

一. 安装claude code

  1. 使用powerShell命令(这里需要用VPN,不然会导致下载失败,并且需要提前安装好git-bash并配置环境变量):
irm https://claude.ai/install.ps1 | iex

2. powerShell窗口中输入

claude --version

查看是否出现claude版本信息,如果出现则说明安装成功

二. 注册中转站账号

  1. 这里我使用老张AI注册一个中转站账号,然后创建一个api key并复制出来

image.png

  1. 记录中转站地址是:api.laozhang.ai 不需要加后缀/v1因为Claude自己会添加

三. 创建配置文件

# powerShell窗口中创建配置目录(如果不存在)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 创建配置文件
@'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.laozhang.ai"
  }
}
'@ | Out-File -FilePath "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8

注意:因为老张AI是国内中转站,所以不需要添加代理配置,如果是国外中转站且使用vpn访问的话需在配置文件中添加代理设置,下面的端口号7890不是固定的,以具体使用的VPN使用的端口号为准:

 "HTTP_PROXY": "http://127.0.0.1:7890",
 "HTTPS_PROXY": "http://127.0.0.1:7890"

四. 验证claude是否完成启动配置

  1. powerShell窗口中初次输入claude时会进入启动配置,此时根据需要自行选择,选择后之后进入以下页面则说明配置完成:

image.png

五. 部分问题整理

  1. 如果出现

Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

则说明可能是claude环境变量配置文件没配置好,查看claude code的setting.json配置文件看是否配置错误。

六. 卸载claude code

# 删除可执行文件
Remove-Item -Force "$env:USERPROFILE.local\bin\claude.exe"

# 删除配置和数据(可选)
Remove-Item -Recurse -Force "$env:USERPROFILE.claude"

# 从 PATH 中移除安装目录(可选)
# 通过 系统属性 → 环境变量 → 用户变量 Path → 删除 %USERPROFILE%.local\bin