首页/资讯中心/详情

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

小白也能照着做！Claude Code Windows完整安装+ api模型配置，少踩环境坑
📅 发布时间：2026/6/26 13:47:15

前言

最近想尝试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。