前言这篇文章整理了我自己实操的完整流程从 Node.js 安装到 API 配置再到常见问题排查每个步骤都尽量写清楚希望能帮你少走弯路快速把 Claude Code 跑起来。正文一、安装 Node.jsClaude Code 运行依赖 Node.js 环境官方要求最低版本为 18建议安装 LTS 版本稳定性更好。方法一官网下载推荐访问 Node.js 官网 下载 LTS 版本双击安装包按向导完成安装建议勾选“Add to PATH”方便后续命令行调用方法二包管理器安装如果习惯用包管理器可以通过以下命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装安装完成后打开 PowerShell建议管理员模式避免权限问题输入以下命令检查版本node--version# 输出 v18.x.x 或更高版本npm--version# 输出对应 npm 版本⚠️提示如果提示“node 不是内部或外部命令”检查是否勾选了“Add to PATH”或手动将 Node.js 安装路径默认C:\Program Files\nodejs添加到系统环境变量。二、安装 Claude CodeNode.js 环境准备好后通过 npm 全局安装 Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 输出类似 0.1.x 的版本号三、配置 API 连接前提获取 API Key使用 Claude Code 需要 API 密钥我这里选择 88api 作为中转接口官网https://api.88api.shop主要是为了省去海外账号注册和网络配置的麻烦国内可直连且支持多模型统一管理。获取步骤如下1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交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密钥”为实际密钥保存文件方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量设置。PowerShell 临时设置当前会话生效$env:ANTHROPIC_BASE_URLhttps://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN你的API密钥# 替换为实际密钥PowerShell 永久设置用户级重启后生效[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⚠️注意配置完成后需重启终端或整个 IDE如 VS Code才能生效。VSCode 插件配置可选如果使用 VSCode 的 Claude 插件需额外创建config.json文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.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 和ANTHROPIC_BASE_URL配置正确重启终端或 IDE 后重试总结到这里Claude Code 的安装和 API 配置就完成了。核心步骤是准备 Node.js 环境 → 安装 Claude Code → 通过配置文件或环境变量设置 API 信息 → 启动验证。遇到连接问题时记得检查.claude.json文件和配置项是否正确。如果过程中还有其他报错或疑问欢迎在评论区留言一起交流解决~