前言最近想试试Claude Code但网上教程要么太碎要么默认海外环境国内配置总是卡壳其实只要找对方法从安装到跑通并不难。这篇是我亲测可行的完整步骤包括Node.js环境搭建、Claude Code安装以及国内API中转的配置不用翻墙和海外账号帮你少踩坑快速上手。正文1. 安装Node.jsClaude Code需要Node.js环境运行最低要求Node.js 18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成安装方法二包管理器安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装出现版本号即成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4⚠️TIP建议使用PowerShell如遇权限问题可尝试以管理员身份运行。2. 安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装claude--version3. 配置API连接获取API KEY我这次用88api中转官网https://api.88api.shop推荐大家可以试试或者大家可以用自己的。以下是获取步骤注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key方法一配置文件推荐在用户目录创建.claude文件夹和settings.json路径C:\Users\你的用户名\.claude\settings.json内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤进入C:\Users\你的用户名\目录新建.claude文件夹如已存在跳过在文件夹内新建settings.json并粘贴配置内容方法二环境变量PowerShell临时设置当前会话$env:ANTHROPIC_BASE_URLhttps://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}创建步骤进入.claude目录新建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}创建步骤进入用户根目录新建.claude.json并粘贴内容重启Claude Code调试技巧检查网络、重启终端/IDE、确认API配置正确。总结这篇教程覆盖了Claude Code从安装到配置的全流程重点解决了国内环境下的API对接问题以及常见的连接报错。只要跟着步骤走基本能顺利跑通。如果遇到其他问题欢迎在评论区留言交流我会尽量帮忙解答。希望这篇教程能帮你快速上手Claude Code
小白也能上手！Claude Code从安装到API对接完整教程（附避坑指南）
发布时间：2026/6/18 14:32:58
前言最近想试试Claude Code但网上教程要么太碎要么默认海外环境国内配置总是卡壳其实只要找对方法从安装到跑通并不难。这篇是我亲测可行的完整步骤包括Node.js环境搭建、Claude Code安装以及国内API中转的配置不用翻墙和海外账号帮你少踩坑快速上手。正文1. 安装Node.jsClaude Code需要Node.js环境运行最低要求Node.js 18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成安装方法二包管理器安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装出现版本号即成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4⚠️TIP建议使用PowerShell如遇权限问题可尝试以管理员身份运行。2. 安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装claude--version3. 配置API连接获取API KEY我这次用88api中转官网https://api.88api.shop推荐大家可以试试或者大家可以用自己的。以下是获取步骤注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key方法一配置文件推荐在用户目录创建.claude文件夹和settings.json路径C:\Users\你的用户名\.claude\settings.json内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤进入C:\Users\你的用户名\目录新建.claude文件夹如已存在跳过在文件夹内新建settings.json并粘贴配置内容方法二环境变量PowerShell临时设置当前会话$env:ANTHROPIC_BASE_URLhttps://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}创建步骤进入.claude目录新建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}创建步骤进入用户根目录新建.claude.json并粘贴内容重启Claude Code调试技巧检查网络、重启终端/IDE、确认API配置正确。总结这篇教程覆盖了Claude Code从安装到配置的全流程重点解决了国内环境下的API对接问题以及常见的连接报错。只要跟着步骤走基本能顺利跑通。如果遇到其他问题欢迎在评论区留言交流我会尽量帮忙解答。希望这篇教程能帮你快速上手Claude Code
