前言最近整理了这篇实操文从Node.js安装到Claude Code部署再到API中转配置一步步带大家在Windows环境下跑通。我这里用了88api作为接口中转主要图个国内直连不用翻墙还能统一管理多模型省点环境配置的功夫。正文一、安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议用LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装一路默认下一步即可建议勾选Add to PATH方法二包管理器安装如果习惯用包管理器可以通过以下命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装安装完成后打开PowerShell建议管理员模式输入以下命令检查版本node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本⚠️ 提示如果遇到权限报错尝试以管理员身份运行PowerShell若提示命令不存在检查Node.js是否已添加到系统PATH。二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证claude--version# 输出类似1.0.0的版本号说明安装成功三、配置API连接前提获取API Key使用Claude Code需要API密钥我这里用88api(官网https://api.88api.shop)作为接口中转大家可以用自己熟悉的平台。注册后进入控制台按以下步骤获取Key获取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// API中转地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置并保存方法二环境变量如果不想用配置文件可通过环境变量临时或永久配置PowerShell临时设置当前会话有效$env:ANTHROPIC_BASE_URLhttps://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# 应输出设置的URL$env:ANTHROPIC_AUTH_TOKEN# 应输出设置的Key⚠️ 注意配置完成后需重启终端如果在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入.claude文件夹之前创建的新建config.json文件粘贴上述内容保存四、开始使用配置完成后在PowerShell中输入以下命令启动Claude Codeclaude首次启动会进入交互界面可输入claude --help查看支持的命令如代码解释、生成、优化等。五、常见问题排查问题Unable to connect to Anthropic services无法连接服务症状启动后提示无法连接到Anthropic服务。解决方案这通常是首次启动引导未完成导致需创建.claude.json跳过引导配置文件路径C:\Users\你的用户名\.claude.json # 注意是用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入用户根目录C:\Users\你的用户名\新建.claude.json文件粘贴上述内容保存重启Claude Code调试技巧检查网络连接是否正常确认API Key和Base URL配置正确重启终端或IDE后重试总结国内环境用Claude Code其实不难核心就是Node.js环境API中转配置。本文从安装到调用把关键步骤和避坑点都列出来了跟着做基本能一次跑通。如果遇到连接问题优先检查配置文件路径和API Key是否正确大部分报错都是这两个地方没弄对。如果大家有其他好用的API中转方案或者遇到新的问题欢迎在评论区交流~
