当前位置: 首页 > news >正文

小白也能照着做!Claude Code Windows完整安装+ api模型配置,少踩环境坑

前言

最近想尝试Claude Code的朋友不少,但很多人卡在环境配置上——要么Node.js版本不对,要么海外服务连接不上,或者教程碎片化看了半天还是不会。

这篇文章把 Claude Code 从安装到配置的完整步骤整理出来,小白跟着步骤走就能跑通。

正文

1. 安装Node.js

Claude Code需要Node.js环境运行,最低要求Node.js >=18(建议LTS版本)。

方法一:官网下载(推荐)
  1. 访问Node.js官网下载LTS版本
  2. 双击安装包,按向导完成安装
方法二:包管理器安装
# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs
验证安装

出现版本号即成功:

node--version# 输出示例:v20.11.0npm--version# 输出示例:10.2.4

⚠️TIP:建议使用PowerShell;如遇权限问题可尝试以管理员身份运行。

2. 安装Claude Code

npminstall-g@anthropic-ai/claude-code

验证安装:

claude--version

3. 配置API连接

获取API KEY

我最近用的是88api中转服务(https://api.88api.shop),以下是获取key的步骤:

  1. 注册登录以后,点击侧边栏的 “API 令牌”

  1. 点击"添加令牌"

  1. 创建令牌,名称随意,直接提交

  1. 获取 API Key,注意妥善保管,不要公开或分享

  1. 点击"知道了",在令牌列表中可以点击"复制"按钮获取 API Key

方法一:配置文件(推荐)

在用户目录下创建.claude文件夹和settings.json
路径C:\Users\<你的用户名>\.claude\settings.json
内容

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}

步骤

  1. 进入C:\Users\<你的用户名>\目录
  2. 新建.claude文件夹(如已存在跳过)
  3. 在文件夹内新建settings.json,粘贴配置内容并保存
方法二:环境变量
PowerShell临时设置(当前会话)
$env:ANTHROPIC_BASE_URL="https://api.88api.shop"$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"
PowerShell永久设置(用户级)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.88api.shop",[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","你的API密钥",[System.EnvironmentVariableTarget]::User)
验证环境变量
$env:ANTHROPIC_BASE_URL$env:ANTHROPIC_AUTH_TOKEN

⚠️ WARNING:请替换"你的API密钥"为实际密钥;配置后需重启终端或IDE生效(彻底重启IDE而非仅终端)。

VSCode插件配置(可选)

若使用VSCode的Claude插件,需额外配置config.json
路径C:\Users\<你的用户名>\.claude\config.json
内容

{"primaryApiKey":"any"}

步骤

  1. 进入.claude目录
  2. 新建config.json,粘贴内容保存

⚠️ WARNING:此文件与Claude Code的settings.json是不同文件。

4. 开始使用

claude

运行claude --help查看支持命令。

5. 常见问题排查

问题:Unable to connect to Anthropic services

症状:启动后提示无法连接服务。
解决方案:创建.claude.json跳过引导:
路径C:\Users\<你的用户名>\.claude.json
内容

{"hasCompletedOnboarding":true}

步骤

  1. 进入用户根目录
  2. 新建.claude.json,粘贴内容保存
  3. 重启Claude Code

调试技巧:检查网络、重启终端/IDE、确认API配置正确。

总结

这篇教程从Node.js安装到Claude Code配置,再到API连接和常见问题解决,覆盖了完整的上手流程。通过88api中转服务,解决了国内访问的痛点,让你不用海外账号也能顺利使用。如果在操作中遇到问题,欢迎在评论区交流,希望能帮你少踩坑,快速用上Claude Code。

http://www.jsqmd.com/news/1081699/

相关文章:

  • 电容触摸评估板选型与实战:从原理到飞思卡尔TWRPI模块开发指南
  • 开源Web版CSV时间序列标注工具开发实践
  • 嵌入式GUI显示驱动配置:从硬件接口到emWin GUI_PORT_API实战
  • 嵌入式Wi-Fi硬件设计:从TWR-WIFI-G1011MI评估板看低功耗模块集成与调试
  • 魔兽争霸III优化终极指南:如何解锁高帧率与实现完美宽屏适配
  • emWin仿真环境集成与硬件按键模拟API实战指南
  • 设计到动画的无缝转换:AEUX插件完整指南
  • 收藏!小白程序员必看:AI大模型时代红利,抓住高薪就业新机遇!
  • 终极窗口管理神器:Window Resizer完全指南,轻松突破应用程序尺寸限制
  • 嵌入式GUI开发实战:emWin浮点数显示与2D绘图API详解
  • 3个真实场景告诉你:为什么思源宋体CN是中文设计的救星
  • 瑞萨IPS2550中断与监控寄存器深度解析:从原理到高可靠系统设计
  • TWR-RF-SNAP无线Mesh网络开发:从硬件解析到SNAP协议实战
  • 文献阅读-3
  • 3分钟掌握Keyviz:免费开源键盘鼠标可视化终极指南
  • 瑞萨CCE4511评估板原理图深度解析与硬件设计实战指南
  • 大模型应用开发必看:5个技巧轻松控制Token消耗,小白也能学会并收藏!
  • C#:bool?
  • Android安全测试实战:从环境搭建到漏洞挖掘的完整指南
  • 嵌入式GUI开发:emWin 2D绘图与BMP显示API实战解析
  • ThinkPad终极散热解决方案:TPFanCtrl2让你的笔记本重获新生![特殊字符]
  • 从实验室到数据中心:Workstation Pro与Player Pro在CI/CD、渗透测试、多网卡桥接中的3大实战分水岭
  • 2026年红帽RHCA架构师认证
  • TWR-KE18F开发板实战指南:从ARM Cortex-M4入门到工业级应用
  • 文件上传漏洞实战:从绕过技巧到WebShell获取的完整攻防解析
  • 掌握WinUI 3与C++/WinRT:构建现代化硬盘监测工具DiskInfo的实战指南
  • iOS 26.5越狱终极指南:完整解锁苹果设备定制化解决方案
  • 050、模块与包组织结构:单文件到大型项目的目录演进与 main
  • 热门AI论文工具势力榜(2026 真实数据)
  • SSD时钟源选型与宽温振荡器工程实践