小白也能上手!Claude Code从安装到API对接完整教程(附避坑指南)
2026/6/18 14:32:56 网站建设 项目流程

前言

最近想试试Claude Code,但网上教程要么太碎,要么默认海外环境,国内配置总是卡壳?其实只要找对方法,从安装到跑通并不难。这篇是我亲测可行的完整步骤,包括Node.js环境搭建、Claude Code安装,以及国内API中转的配置(不用翻墙和海外账号),帮你少踩坑,快速上手。

正文

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),推荐大家可以试试,或者大家可以用自己的。以下是获取步骤:

  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:此文件为VSCode插件专用,与命令行配置文件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配置正确。

总结

这篇教程覆盖了Claude Code从安装到配置的全流程,重点解决了国内环境下的API对接问题,以及常见的连接报错。只要跟着步骤走,基本能顺利跑通。如果遇到其他问题,欢迎在评论区留言交流,我会尽量帮忙解答。希望这篇教程能帮你快速上手Claude Code!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询