前言作为用Linux/WSL2开发的人我最近刚把Claude Code跑通发现国内环境下其实有更简单的方案。这篇文章就把从Node.js安装到API对接的完整流程整理出来每一步都附实际命令和配置尽量让你不用到处查资料跟着做就能用起来。正文一、准备工作安装Node.jsClaude Code要求Node.js版本至少18建议LTS版先确保环境满足这个条件。方法一官网下载访问Node.js官网下载Linux二进制包或用nvm安装适合需要多版本管理的场景。方法二包管理器安装Ubuntu/Debian如果用的是Ubuntu或Debian系统直接用apt安装更方便sudoaptupdatesudoaptinstall-ynodejsnpm验证安装安装完成后检查版本是否达标node--version# 输出应≥v18.0.0npm--version# 通常会随nodejs一起安装二、安装Claude CodeNode.js准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后检查是否成功claude--version# 输出版本号即表示安装成功三、配置API连接核心步骤Claude Code需要API密钥才能使用这里分享我最近用的88api中转站官网https://api.88api.shop主要是为了省去翻墙和海外账户注册的麻烦国内直连而且一个Key能管理多个主流模型比如GPT、Gemini等切换模型只需改一行配置比较方便。推荐大家可以试试或者大家也可以用自己的。1. 获取API Key以88api为例1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置方式推荐配置文件方法一通过配置文件设置持久生效推荐在用户目录下创建.claude文件夹和settings.json配置文件配置文件路径~/.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退出编辑器。方法二通过环境变量设置临时或永久如果不想用配置文件也可以直接设置环境变量临时设置仅当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际Key永久设置所有终端生效将以下内容写入~/.bashrc或~/.zshrc根据你用的shell选择exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际Key保存后执行source ~/.bashrc或对应的配置文件使生效。⚠️注意替换你的API密钥为实际生成的Key配置后需重启终端若用VS Code/Cursor等IDE的集成终端需彻底重启IDE才能生效。3. VSCode插件配置可选如果用VSCode的Claude插件还需额外创建config.json配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 确保.claude目录存在mkdir-p~/.claude# 编辑配置文件nano~/.claude/config.json粘贴内容后保存退出即可。⚠️注意这是VSCode插件专用的config.json与命令行工具的settings.json是两个不同文件不要混淆。四、开始使用Claude Code配置完成后在终端输入claude即可启动Claude Code。如需查看命令说明执行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即可。调试小技巧如果仍无法连接可按以下步骤排查检查网络是否正常可pinghttps://api.88api.shop测试连通性重启终端或IDE确保配置生效核对API Key是否正确重点检查是否有空格或字符缺失总结到这里Linux/WSL2环境下的Claude Code安装和API配置就完成了。核心步骤就是装Node.js→装Claude Code→配API密钥国内可用中转站→启动使用遇到连接问题记得检查引导文件和配置是否生效。整个流程不算复杂按步骤来基本能一次跑通。如果还有其他问题欢迎在评论区交流咱们一起少踩坑