前言我整理了一份从 Node.js 安装到 API 对接的完整步骤用 88api 中转实现国内直连不用翻墙和海外账户亲测跑通。如果你也是小白怕麻烦跟着这篇一步步来应该能少走不少弯路。正文一、安装 Node.jsClaude Code 需要 Node.js 环境支持最低要求 Node.js ≥18建议安装 LTS 版本。方法一官网下载推荐访问 Node.js 官网 下载 LTS 版本安装包双击安装包按向导提示完成安装一路默认下一步即可方法二包管理器安装如果习惯用包管理器可以通过以下命令安装# Chocolatey 用户chocoinstallnodejs# Scoop 用户scoopinstallnodejs验证安装安装完成后打开终端输入以下命令检查版本node--version# 输出 Node.js 版本如 v20.10.0npm--version# 输出 npm 版本如 10.2.3⚠️提示建议使用 PowerShell 终端若遇权限问题可尝试以管理员身份运行终端。二、安装 Claude Code通过 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证版本claude--version# 输出类似 0.1.0 的版本号三、配置 API 连接前提获取 API Key调用 Claude 模型需要 API 密钥我这次用的是 88api 中转服务官网https://api.88api.shop它支持国内直连不需要翻墙和海外账户一个 Key 还能管理多个模型省了不少环境配置的麻烦大家可以试试。大家用自己的也可以。我这里以我使用的88api为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐通过配置文件永久保存 API 信息步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为复制的 API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 固定中转地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude若已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置内容替换「你的API密钥」为实际 Key保存文件方法二环境变量若不想用配置文件可通过环境变量临时或永久配置PowerShell 临时设置当前会话生效$env:ANTHROPIC_BASE_URL https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN 你的API密钥# 替换为实际 KeyPowerShell 永久设置用户级重启终端生效[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# 应输出 https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN# 应输出你的 API Key⚠️注意配置完成后需重启终端若在 VS Code/Cursor 等 IDE 的集成终端使用需彻底重启 IDE仅重启终端可能不生效。VSCode 插件配置可选如果使用 VSCode 的 Claude 插件需额外创建插件专用配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录若.claude文件夹不存在先按方法一创建新建config.json文件粘贴上述内容并保存四、开始使用配置完成后在终端输入以下命令启动 Claude Codeclaude若需查看支持的命令可运行claude--help五、常见问题排查问题Unable to connect to Anthropic services无法连接服务症状启动 Claude Code 后提示无法连接到 Anthropic 服务。解决方案这通常是首次启动引导未完成导致需在用户根目录创建.claude.json文件跳过引导配置文件路径C:\Users\你的用户名\.claude.json # 注意是用户根目录不是 .claude 文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建.claude.json文件粘贴上述内容并保存重启 Claude Code调试技巧若仍无法连接可检查网络连接是否正常API Key 是否配置正确参考「配置 API 连接」章节重启终端或 IDE 后重试总结到这里Claude Code 的安装和 API 配置就完成了。核心是通过中转服务解决国内直连问题再按步骤配置好环境变量或配置文件。如果遇到连接问题记得检查.claude.json文件和 API Key 是否正确。整个流程不算复杂跟着步骤走基本能一次成功。有任何问题欢迎在评论区交流一起少踩坑
国内直连不折腾！Claude Code 从安装到 API 配置完整教程（小白也能照着做）
前言我整理了一份从 Node.js 安装到 API 对接的完整步骤用 88api 中转实现国内直连不用翻墙和海外账户亲测跑通。如果你也是小白怕麻烦跟着这篇一步步来应该能少走不少弯路。正文一、安装 Node.jsClaude Code 需要 Node.js 环境支持最低要求 Node.js ≥18建议安装 LTS 版本。方法一官网下载推荐访问 Node.js 官网 下载 LTS 版本安装包双击安装包按向导提示完成安装一路默认下一步即可方法二包管理器安装如果习惯用包管理器可以通过以下命令安装# Chocolatey 用户chocoinstallnodejs# Scoop 用户scoopinstallnodejs验证安装安装完成后打开终端输入以下命令检查版本node--version# 输出 Node.js 版本如 v20.10.0npm--version# 输出 npm 版本如 10.2.3⚠️提示建议使用 PowerShell 终端若遇权限问题可尝试以管理员身份运行终端。二、安装 Claude Code通过 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证版本claude--version# 输出类似 0.1.0 的版本号三、配置 API 连接前提获取 API Key调用 Claude 模型需要 API 密钥我这次用的是 88api 中转服务官网https://api.88api.shop它支持国内直连不需要翻墙和海外账户一个 Key 还能管理多个模型省了不少环境配置的麻烦大家可以试试。大家用自己的也可以。我这里以我使用的88api为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐通过配置文件永久保存 API 信息步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为复制的 API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 固定中转地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude若已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置内容替换「你的API密钥」为实际 Key保存文件方法二环境变量若不想用配置文件可通过环境变量临时或永久配置PowerShell 临时设置当前会话生效$env:ANTHROPIC_BASE_URL https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN 你的API密钥# 替换为实际 KeyPowerShell 永久设置用户级重启终端生效[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# 应输出 https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN# 应输出你的 API Key⚠️注意配置完成后需重启终端若在 VS Code/Cursor 等 IDE 的集成终端使用需彻底重启 IDE仅重启终端可能不生效。VSCode 插件配置可选如果使用 VSCode 的 Claude 插件需额外创建插件专用配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录若.claude文件夹不存在先按方法一创建新建config.json文件粘贴上述内容并保存四、开始使用配置完成后在终端输入以下命令启动 Claude Codeclaude若需查看支持的命令可运行claude--help五、常见问题排查问题Unable to connect to Anthropic services无法连接服务症状启动 Claude Code 后提示无法连接到 Anthropic 服务。解决方案这通常是首次启动引导未完成导致需在用户根目录创建.claude.json文件跳过引导配置文件路径C:\Users\你的用户名\.claude.json # 注意是用户根目录不是 .claude 文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建.claude.json文件粘贴上述内容并保存重启 Claude Code调试技巧若仍无法连接可检查网络连接是否正常API Key 是否配置正确参考「配置 API 连接」章节重启终端或 IDE 后重试总结到这里Claude Code 的安装和 API 配置就完成了。核心是通过中转服务解决国内直连问题再按步骤配置好环境变量或配置文件。如果遇到连接问题记得检查.claude.json文件和 API Key 是否正确。整个流程不算复杂跟着步骤走基本能一次成功。有任何问题欢迎在评论区交流一起少踩坑
