「国内直连」Claude Code安装与API配置保姆级教程：从Node.js到调用，小白少踩坑（亲测跑通）

前言国内用户最头疼的就是海外账号和网络问题其实找对中转接口就能省不少事。这篇文章把从Node.js安装到Claude Code启动的全流程整理清楚用88api做接口中转国内直连不用翻墙尽量让每个步骤都能照着做少走弯路。正文一、准备工作安装Node.jsClaude Code需要Node.js环境支持最低要求Node.js ≥18建议用LTS版本更稳定。方法一官网下载安装访问Node.js官网下载LTS版本的安装包双击后按向导提示完成安装即可。方法二Homebrew安装推荐如果你的macOS已经安装了Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后打开终端输入以下命令能显示版本号说明安装成功node--version# 查看Node.js版本npm--version# 查看npm版本二、安装Claude CodeNode.js环境准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后输入以下命令检查版本claude--version如果能显示版本信息说明Claude Code安装成功。三、配置API连接核心步骤要让Claude Code正常工作需要配置API密钥和接口地址。这里用88api作为中转接口国内直连不用注册海外账号有免费额度可试用推荐大家试试。或者大家有自己的也可以。下面以88api为例1. 获取API Key注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置API推荐用配置文件通过配置文件统一管理API信息步骤如下配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚才复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 固定接口地址}}创建步骤打开终端依次执行以下命令# 创建.claude目录如果已存在会自动跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。3. 备选方案环境变量配置如果不想用配置文件也可以通过环境变量设置临时或永久临时设置仅当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际Key永久设置所有终端生效将以下内容写入你的shell配置文件如~/.zshrc或~/.bashrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际Key保存后执行source ~/.zshrc或对应配置文件使其生效。⚠️ 注意配置完成后需要重启终端如果在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。4. VSCode插件配置可选如果使用VSCode的Claude插件还需要额外创建插件专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 确保.claude目录已存在如果前面创建过可跳过mkdir-p~/.claude# 编辑配置文件nano~/.claude/config.json粘贴上述内容并保存CtrlO保存CtrlX退出。⚠️ 注意这是VSCode插件的专用配置文件config.json与Claude Code命令行工具的配置文件settings.json是两个不同文件不要混淆。四、启动Claude Code配置完成后在终端输入以下命令启动claude如果需要查看命令说明可执行claude--help五、常见问题排查问题1启动后提示「Unable to connect to Anthropic services」症状启动Claude Code后显示无法连接服务。解决方案这通常是首次启动引导未完成导致的需要创建.claude.json文件跳过引导配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法在终端执行cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json确认内容正确后重启Claude Code即可。 调试小技巧如果配置后仍无法连接可检查网络、重启终端/IDE或重新核对API Key是否正确配置参考「三、配置API连接」步骤。总结整个流程其实不复杂核心就是Node.js环境、Claude Code安装、API配置这三步。国内用户用88api中转能省掉海外账号和翻墙的麻烦配置文件方式比环境变量更方便管理。如果启动时遇到连接问题记得检查.claude.json文件是否创建。按步骤走下来基本能顺利跑通。如果还有其他问题欢迎在评论区交流~