前言最近想试试Claude Code提升开发效率却被各种环境配置教程搞得头大——要么是默认海外环境需要翻墙要么步骤零散看完还是不会配。作为非专业运维的开发者其实我们只想简单上手用工具而不是花半天折腾环境。所以我整理了这篇实操文从Node.js安装到API对接全程保姆级步骤特别是用了国内API中转站解决直连问题省去注册海外账户和翻墙的麻烦。亲测每一步都能跑通希望能帮你快速把Claude Code用起来。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本≥18建议用LTS稳定版先确保环境到位。方法一官网下载安装推荐新手访问Node.js官网下载Windows LTS版本安装包双击安装包按向导默认安装即可一路Next建议勾选Add to PATH方法二包管理器安装适合熟悉命令行用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式输入以下命令检查版本node--version# 应显示v18.x.x或更高npm--version# 通常随Node.js一起安装⚠️ 提示如果命令提示不是内部或外部命令可能是PATH配置问题建议重新安装Node.js并确保勾选Add to PATH。二、安装Claude Code命令行工具环境准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示版本号如0.1.0三、配置API连接核心步骤Claude Code需要API密钥才能调用服务这里用国内API中转站简化配置不用翻墙和海外账户。1. 获取API Key我用的是88api中转站官网https://api.88api.shop有免费额度可试用主要图它国内直连方便且一个Key能管理多个模型Claude、GPT等切换模型只需改配置。推荐大家试试或者大家也可以用自己的。下面以88 API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置方式一配置文件推荐永久生效在用户目录下创建配置文件步骤如下配置文件路径替换你的用户名为实际系统用户名C:\Users\你的用户名\.claude\settings.json配置内容替换你的API密钥为实际复制的Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹内新建settings.json文件粘贴上述配置内容保存文件3. 配置方式二环境变量临时或永久如果不想用配置文件可通过环境变量设置适合临时测试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密钥⚠️ 重要提示配置完成后需重启终端如果在VS Code等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。4. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤同配置文件方式在.claude文件夹内新建config.json并粘贴内容。⚠️ 注意这是VSCode插件专用的config.json与命令行工具的settings.json是两个不同文件不要混淆。四、启动Claude Code开始使用配置完成后在终端输入以下命令启动claude首次启动会进入交互界面可直接输入问题或代码需求。想了解更多命令可运行claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后显示无法连接服务。原因首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json文件内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建文件.claude.json注意在用户根目录不是.claude文件夹内粘贴上述内容保存重启Claude Code调试技巧若仍无法连接检查网络、重启IDE、确认API Key和Base URL配置正确。总结这篇教程从Node.js环境搭建到API配置再到常见问题解决覆盖了Claude Code在Windows上的完整使用流程。核心是通过API中转站解决国内直连问题省去了海外账户和翻墙的麻烦。按步骤操作基本能避开90%的配置坑。如果遇到其他问题欢迎在评论区交流——毕竟工具配置总会有各种小细节一起踩坑一起解决效率更高。希望这篇文章能帮你快速用上Claude Code提升开发效率
国内环境轻松用Claude Code：从安装到API配置完整教程，亲测跑通（小白也能跟做）
发布时间：2026/5/22 22:35:56
前言最近想试试Claude Code提升开发效率却被各种环境配置教程搞得头大——要么是默认海外环境需要翻墙要么步骤零散看完还是不会配。作为非专业运维的开发者其实我们只想简单上手用工具而不是花半天折腾环境。所以我整理了这篇实操文从Node.js安装到API对接全程保姆级步骤特别是用了国内API中转站解决直连问题省去注册海外账户和翻墙的麻烦。亲测每一步都能跑通希望能帮你快速把Claude Code用起来。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本≥18建议用LTS稳定版先确保环境到位。方法一官网下载安装推荐新手访问Node.js官网下载Windows LTS版本安装包双击安装包按向导默认安装即可一路Next建议勾选Add to PATH方法二包管理器安装适合熟悉命令行用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式输入以下命令检查版本node--version# 应显示v18.x.x或更高npm--version# 通常随Node.js一起安装⚠️ 提示如果命令提示不是内部或外部命令可能是PATH配置问题建议重新安装Node.js并确保勾选Add to PATH。二、安装Claude Code命令行工具环境准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示版本号如0.1.0三、配置API连接核心步骤Claude Code需要API密钥才能调用服务这里用国内API中转站简化配置不用翻墙和海外账户。1. 获取API Key我用的是88api中转站官网https://api.88api.shop有免费额度可试用主要图它国内直连方便且一个Key能管理多个模型Claude、GPT等切换模型只需改配置。推荐大家试试或者大家也可以用自己的。下面以88 API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置方式一配置文件推荐永久生效在用户目录下创建配置文件步骤如下配置文件路径替换你的用户名为实际系统用户名C:\Users\你的用户名\.claude\settings.json配置内容替换你的API密钥为实际复制的Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹内新建settings.json文件粘贴上述配置内容保存文件3. 配置方式二环境变量临时或永久如果不想用配置文件可通过环境变量设置适合临时测试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密钥⚠️ 重要提示配置完成后需重启终端如果在VS Code等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。4. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤同配置文件方式在.claude文件夹内新建config.json并粘贴内容。⚠️ 注意这是VSCode插件专用的config.json与命令行工具的settings.json是两个不同文件不要混淆。四、启动Claude Code开始使用配置完成后在终端输入以下命令启动claude首次启动会进入交互界面可直接输入问题或代码需求。想了解更多命令可运行claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后显示无法连接服务。原因首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json文件内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建文件.claude.json注意在用户根目录不是.claude文件夹内粘贴上述内容保存重启Claude Code调试技巧若仍无法连接检查网络、重启IDE、确认API Key和Base URL配置正确。总结这篇教程从Node.js环境搭建到API配置再到常见问题解决覆盖了Claude Code在Windows上的完整使用流程。核心是通过API中转站解决国内直连问题省去了海外账户和翻墙的麻烦。按步骤操作基本能避开90%的配置坑。如果遇到其他问题欢迎在评论区交流——毕竟工具配置总会有各种小细节一起踩坑一起解决效率更高。希望这篇文章能帮你快速用上Claude Code提升开发效率
