告别翻墙和海外账号！Claude Code在Linux/WSL2上的完整部署与调用教程

前言最近AI工具更新太快很多教程没跟上节奏尤其是Claude Code这类工具国内用户常常卡在安装配置环节——不是需要海外账号就是网络连接失败。作为踩过不少坑的开发者我整理了这篇在Linux/WSL2环境下的实操指南从Node.js安装到API对接全程保姆级说明用中转接口省去翻墙和账号麻烦亲测能跑通希望能帮你少走弯路。正文一、准备工作安装Node.jsClaude Code要求Node.js版本≥18建议LTS版以下是两种安装方法方法一官网下载访问Node.js官网下载Linux LTS版本的二进制包或通过nvmNode版本管理器安装适合需要多版本管理的场景。方法二包管理器安装Ubuntu/Debian直接通过系统包管理器安装简单快捷sudoaptupdatesudoaptinstall-ynodejsnpm验证安装安装完成后检查版本是否达标node--version# 需显示v18.x或更高npm--version# 通常随Node.js一同安装二、安装Claude Code使用npm全局安装Claude Code命令行工具npminstall-ganthropic-ai/claude-code验证安装安装完成后检查工具版本claude--version# 显示版本号即安装成功三、配置API连接核心步骤1. 获取API Key调用Claude需要API密钥我这次使用的是88api官网https://api.88api.shop作为中转接口主要是为了避免海外账号注册和网络配置的麻烦国内可直连配置起来更方便。推荐大家可以试试或者大家也可以用自己的。下面以88 API 为例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密钥永久设置所有终端生效将以下内容写入~/.bashrc或~/.zshrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source ~/.bashrc使配置生效。⚠️注意替换你的API密钥为实际获取的Key配置后需重启终端若在VS Code等IDE中使用需彻底重启IDE才能生效。3. VSCode插件配置可选若使用VSCode的Claude插件需额外创建config.json配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤mkdir-p~/.claude# 若已创建可跳过nano~/.claude/config.json粘贴内容后保存退出。注意这是插件专用配置与命令行工具的settings.json是两个文件。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude如需查看命令说明可运行claude--help五、常见问题排查问题1启动后提示“Unable to connect to Anthropic services”症状首次启动时因未完成引导流程导致连接失败。解决方案创建.claude.json文件跳过引导配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json# 显示上述内容即成功重启Claude Code即可。调试技巧若仍无法连接检查网络、重启终端/IDE或确认API Key和Base URL配置是否正确。总结至此你已在Linux/WSL2环境下完成Claude Code的安装与API配置。核心要点确保Node.js版本≥18API配置文件路径和内容正确遇到连接问题通过.claude.json跳过引导。整个过程无需海外账号和翻墙中转接口让国内使用更顺畅。如果操作中遇到其他问题欢迎在评论区交流我会尽量回复。