Windows安装Claude Code详细教程(含apikey配置)

Claude Code

通过配置文件的方式在电脑上安装和配置 Claude Code CLI (命令行工具)

如果遇到问题,可以将本页全部内容和问题截图,复制给 豆包 或者 deepseek 等AI,按照他的提示执行对应命令即可

如果 AI 也无法解决,可以联系我们的工程师,为您提供技术上的支持与帮助

Windows

1. 安装 Node.js / Git

前往 Node.js 官网 下载并安装 LTS 版本。(如果已经安装可以跳过)

验证安装:

bash 复制代码
#打开cmd/powershell
node --version

如果出现下面的提示就说明 node 已经安装成功了

需要注意的是,Nodejs 的版本必须为 18+

如果低于这个版本,可以问一下 AI 如何升级 Nodejs 版本,让 AI 先给您命令收集系统信息,之后它就会提供最快最准确的指导

前往 Git 官网,下载安装包,然后一路 yes 就行,都是英文的,不用管

2. 安装 Claude Code CLI

打开 PowerShell(建议以管理员身份运行)并执行:

bash 复制代码
#通过国内镜像源安装 claude code复制
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com/

如果遇到在此系统上禁止运行脚本,需要用管理员权限运行powershell,然后执行 Set-ExecutionPolicy Unrestricted 命令

3. 创建配置文件

3.1获取apikey

打开链接,注册账号,随后点击创建秘钥

https://aicodewith.com/zh/login?tab=register&invitation=VG3L9PGU

打开 PowerShell(建议以管理员身份运行)并执行(替换自己的APIKEY后直接执行):

bash 复制代码
# 目标目录:C:\Users\<you>\.claude
$dir = Join-Path $env:USERPROFILE ".claude"
$settingsFile = Join-Path $dir "settings.json"
$claudeJsonFile = Join-Path $env:USERPROFILE ".claude.json"

# 创建目录(存在不报错)
New-Item -ItemType Directory -Path $dir -Force | Out-Null

# 1. 写入 settings.json(API 配置)
$settingsJson = @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "在这里替换成你的_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.com"
  }
}
'@
[System.IO.File]::WriteAllText($settingsFile, $settingsJson, (New-Object System.Text.UTF8Encoding($false)))

# 2. 写入 .claude.json(跳过登录)- 注意这个文件在用户根目录
$claudeJson = @'
{
  "hasCompletedOnboarding": true
}
'@
[System.IO.File]::WriteAllText($claudeJsonFile, $claudeJson, (New-Object System.Text.UTF8Encoding($false)))

Write-Host "配置完成!"
Write-Host "  - settings.json: $settingsFile"
Write-Host "  - .claude.json: $claudeJsonFile"

4. 验证安装

重新打开 PowerShell 或者 IDE,运行:

bash 复制代码
claude

如果遇到下面的提示,选择第一个 yes ,然后按回车即可

这是在提示你授权 Claude Code 访问并执行当前文件夹里的代码,用于读取、修改和运行项目文件

接下来在对话框里面可以输入:您好!如果正常回复,并且后台有正确的调用记录,则说明配置成功

常见问题

1. 无法连接到 Anthropic 服务

错误截图

解决办法

在 ~/.claude.json 文件中,添加一行:"hasCompletedOnboarding": true,

需要注意这行末尾有逗号,添加在 JSON 中间就好,如下图

2. 无效的 API 密钥 · 请运行 /login

错误截图

解决办法

这个问题是因为环境变量没有设置好,可以参考前面的教程,重新设置下环境变量

主要是这两个

ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN

3. 401 {"error":"Invalid API key"}

错误截图

解决办法

这个问题是因为 key 设置错了,可以去网站重新生成一个 key ,然后参考前面的教程,重新设置下环境变量 ANTHROPIC_AUTH_TOKEN 这个环境变量

相关推荐
寅时码7 小时前
React 之死·终章:一个 useRef,把闭包陷阱、依赖数组、漫天 rerender 全送走
前端·react.js·ai编程
腻害兔9 小时前
【若依项目-产品经理视角】RuoYi-Vue-Pro 源码拆解:字典、短信、邮件、通知——后台系统的“基础设施四件套“!
java·前端·vue.js·产品经理·ai编程
CCPC不拿奖不改名10 小时前
大模型推理架构与开源生态知识整理
数据库·windows·python·架构·langchain·开源·github
老谷子.AI原始技术10 小时前
《Claude Code工程化实践》加课4-Claude Code 的底层内功:Prompt Engineering
prompt·claude code
腻害兔10 小时前
【若依项目-产品经理视角】RuoYi-Vue-Pro 源码拆解:支付模块 yudao-module-pay,一个让产品经理都看懂的支付中台设计
java·前端·vue.js·产品经理·ai编程
kyriewen11 小时前
我扒了最近的前端面经——2026年面试不背八股文了,考这5样
前端·面试·ai编程
王维同学12 小时前
[自学][Windows C++]RunOnceEx 注册表分组键的安全遍历
c++·windows·安全·开源
奋飛13 小时前
AI应用工程:Agent 是如何工作的?——从一次模型调用到可运行的执行循环
ai编程
钱六两13 小时前
#3、SpringAI 接入deepSeek大模型(喂饭版)
java·spring boot·ai编程
码哥字节15 小时前
Claude Code 新手必问的 10 个问题,一次答清楚
claude code