93
这个楼主还没有留下简介。
回复讨论
2
当前站点已关闭游客查看评论,登录后可查看评论并参与回复讨论。
适用平台:Windows 10/11
难度: ☆☆☆ (但跟着做一定能成功)
预计时间:1小时(不包括踩坑)
准备工作
· 一台Windows 电脑(华为、联想等均可)
●稳定的网络
·5元人民币(用于充值中转服务,非必须但推荐)
●耐心和截图工具(遇到问题及时截图)
第一步:安装Node.js ( 运行环境)
1.访问 Node.js 官网:https:// nodejs.org/
2.点击左侧绿色按钮"Latest LTS"下载LTS版本(例如 v24.14.0)。
3.运行下载的 .msi 安装包,一路点击"Next", 保持默认选项。
4. 安装完成后,重启电脑 (重要)。
5.打开PowerShell ( 按 Win+R, 输入 powershell 回车)。
6.验证安装:
powershe ll
node -v
npm -V
截图位置①:显示版本号,如 v24.14.0 和 1 0 .x.x。
第二步:安装Git(Claude Code 依赖)
1.访问Git 官网:https://git- scm.com/download/win
2.点击"Click here to download"或选择“Git for Windows/x64 Setup"下载。
3.运行安装包,一路默认,直到安装完成。
4.重启电脑。
5.在 PowerShell 中验证:
powershe ll 复制
git --version
截图位置② : 显 示 git version 2.x.x。
第三步:安装Claude Code
在PowerShell 中执行:
powershell 出下载
npm install -g @anthropic-ai/claude-code
等待安装完成(约1-2分钟)。验证:
powershell
claude --version
截图位置③:显示1.63 ( Claude Code) 或类似版本。
第四步:注册中转服务(302. Al)
由于国内无法直接连接Anthropic 官方API, 需要使用中转服务。推荐302. AI (稳定、有 免费额度)。
1.访问https://302.ai 注册账号。
3.在左侧菜单点击"API"→“Keys” 。 4.点击“添加API KEY”,名称随意(如 claude Code),过期时间选“永不过期”。
5.生成后,复制完整的API Key (以 sk- 开头的一长串)。
截图位置④: 后台API Keys 列表,显示新创建的Key。
6.建议充值5元(点击右上角“充值”,最低5元),新用户有免费额度但可能不够,充值更 安心。
第五步:创建配置文件(最关键一步)
Windows版Claude Code只认配置文件,不认环境变量! 必须按照以下步骤创建 settings.json。
1.在 PowerShell 中执行以下命令 (直接复制粘贴):
powershe ll 出下载
Remove Item -Recurse -Force “$env:USERPROFILE.claude”- ErrorAction SilentlyContinue
#新建配置文件夹
New-Item- ItemType Directory -Force -Path "$env:USERPROFILE.claude "|Out-Null
#写入正确配置(请将“你的真实 API Key” 替换为你在302.AI 复制的 Key)
"env ":{
“ANTHROPIC_BASE_URL”:" https://api.302.ai",
“ANTHROPIC_AUTH_TOKEN”:" 你的真实API Key",
“ANTHROPIC_MODEL”:“kimi-k2-0711-preview”
"@| Set-Content -Path “$env:USERPROFILE.claude\settings.json”- Encoding utf8
2.验证配置文件内容:
powershe ll
Get-Conten t “$env:USERPROFILE.claude\settings. json”
截图位置⑤: 显示正确的JSON 内容(注意变量名是 ANTHROPIC_AUTH_TOKEN, 不 是 ANTHROPIC_API_KEY)。
3.重启电脑 (必须!让配置生效)。
第六步:启动Claude Code
1.创建一个工作目录(例如 D:\my_ai_projects):
powershe ll 复制 出 下载
mkdir D:\my_ai_projects
cd D:\my_ai_projects
2.启动Claude Code:
powershe ll 口复制
claude
3.首次启动会询问:
o 选择主题:输入1(深色)或你喜欢的数字,回车。
○信任当前目录:输入1或 y, 回车。
○可能还会问是否允许使用shell, 输入 y。
截图位置⑥: 主题选择界面。
截图位置⑦:信任目录提示。
截图位置⑧:成功进入对话界面,显示>提示符。
4.测试对话:在>后输入中文:
text
你好,请介绍一下你自己
Claude会用中文回复。
截图位置⑨:对话成功截图。
常见错误及解决方法
× 错误1: claude 命令找不到
● 原因:Node.js 未正确安装或PATH未设置。
●解决:重启电脑,重新安装Node.js ( 确保勾选“添加到PATH”)。
错误2: Invalid API Key
● 截图特征: 启动后报错 Invali d API Key。
· 可能原因:
o API Key 复制不全(有空格或漏字符)
oAPI Key 在302.AI后台已失效(需要重新生成)
○配置文件中的变量名错误(应为 ANTHROPIC_AUTH_TOKEN)
·解决:登录302.AI后台,删除旧Key, 重新生成一个,并完整复制替换到配置文件 中。
× 错 误 3 : 403 Parameter error
· 截 图 特 征 : 启 动 后 报 Parameter error。
● 原因:模型名称不正确,或Base URL 格式错误。
● 解决:
o 检查 ANTHROPIC_MODEL 是否为 kimi- k2-0711-preview( 302.AI 推 荐 ) 。 o 检 查 ANTHROPIC_BASE_URL 是否为 https:// api.3 02.ai, 不要加 / v1。
× 错误4:连接官方地址 api. anthropic.com
·截图特征:报错 Failed to connect to api.anthropic.com。
●原因:Claude Code没有读取到配置文件,或Base URL设置错误。
● 解决:
o 确认配置文件路径为 c:\Users\ 你的用户名.claude\settings.json。
o 确认文件内容 JSON 格式正确。
○ 重启电脑后重试。
错误5:充值后余额仍为0
●可能原因:充值延迟或未到账。
● 解决:联系302.AI客服(页面底部有联系方式),提供充值记录。
使用技巧
●对话语言:可以全程使用中文,Claude会自动用中文回复。
●查看费用:在对话中输入/cost 查看当前会话消耗的token。
● 压缩上下文:如果对话变慢或上下文太长,输入/compact 压缩记忆,节省 token。
● 退出:输入/exit 或按两次 Ctrl+C。
● 常用命令:/ help 查看所有命令。
结语
按照本教程,你应该能成功在Windows 上运行Claude Code。整个过程虽曲折,但一旦 成功,你将获得一个强大的AI 编程助手。如果你遇到本教程未覆盖的问题,欢迎在评论区 留言,我会尽力帮助。
最后,记得保存好你的API Key,不要泄露给他人。祝使用愉快!