写在前面很多人第一次接触 Claude Code卡住的不是“不会用”而是“根本装不上”。问题通常都出在几个老地方Node.js 版本没选对、npm 全局目录和缓存目录没配好、环境变量没改干净、国内网络拉包慢最后命令明明敲了终端却还是一堆报错。所以这篇文章不聊虚的就按一条最实用的主线来先把 Node.js 装好再把 npm 和环境变量整理顺再安装 Claude Code最后确认命令能不能正常跑起来。如果你正准备在 Windows 机器上把这套环境落地照着往下走就行。先搞清楚Claude Code 到底是什么Claude Code 是 Anthropic 做的命令行 AI 编程工具。它不是普通的聊天窗口而是能直接在本地开发环境里工作的 Agent能理解你的代码库结构能执行命令能读写项目文件能辅助你管理 Git 仓库能接入 MCP 等外部能力还能把一些原本很碎、很重的开发工作自动化说白了它更像一个待在终端里的 AI 编程搭子。你给它目标它不只是回答问题还会尽量把事情往前推进。从官方订阅方式看Claude Code 目前主要有几种用法Claude Pro$17/月按年订阅或$20/月按月Claude Max 5x$100/人/月Claude Max 20x$200/人/月API 模式按 Anthropic 官方 API 计费不过说实话官方订阅对国内用户不太友好——需要海外信用卡网络环境也得折腾。如果嫌麻烦想找个更省事的渠道可以看看 Code80真实订阅帐号转 API换个 endpoint 就能直接用体验跟官方一样。详情可以到官网了解code.ai80.vip安装思路先说清楚这篇教程走 npm 方案这篇教程我会分成两种安装方式来看方式一npm 安装方式二官网下载脚本安装这篇文章我主讲npm 方案。原因也很简单对大多数 Windows 用户来说先把 Node.js 和 npm 环境整理好后面不管你装 Claude Code 还是别的前端/Node 工具都会顺很多。第一步安装 Node.js我建议先装 Node.js并优先用 nvm 管理版本。如果你平时就会切换 Node 版本这个做法确实挺合理但如果你现在的目标只是先把 Claude Code 跑起来直接安装一个稳定的 LTS 版本也完全可以。 推荐参考教程 https://blog.csdn.net/sjp991012/article/details/134426007下载安装包Node.js 官网https://nodejs.org/;我这里给出的选择步骤是这样的基本可以直接照着来选择版本v22.14.0 (LTS)原则上优先选最新的 LTS也就是长期支持版本。下载安装包时选择prebuilt预制版。操作系统选择Windows。架构类型选择x64。点击Windows 安装程序.msi开始下载。下载完成后文件名类似node-v24.11.1-x64.msi。安装程序接下来就是标准的 Windows 安装流程。双击安装包node-v22.14.0-x64.msi开始安装。直接点击Next进入协议确认窗口。修改安装路径后点击Next。继续点击Next。这个页面里各选项的意思我也列得很清楚Node.js runtimeNode.js 运行环境npm package managernpm 包管理器Online documentation shortcuts在线文档快捷方式Add to PATH把 Node.js 加到环境变量里不用额外勾选内容继续点击Next会进入Tools for Native Modules窗口。点击Install开始正式安装。等待安装完成。安装结束。最后做一次验证。按WIN R输入CMD回车在命令行里执行能看到 Node.js 版本号就说明安装成功了。第二步配置 npm 路径和环境变量这一步很关键。很多人装完 Node.js 就急着执行安装命令结果后面不是全局包路径乱掉就是缓存目录不好管要么就是 PATH 配得不干净命令行为莫名其妙地出问题。这一步我会拆成两块npm 的 prefix 和 cache 配置系统环境变量配置2.1 配置 npm 的 prefix 和 cache我建议在 Node.js 安装目录下单独准备两个文件夹一个放全局依赖一个放缓存。这个思路很好后面你要排查问题、清缓存、看全局包位置都会方便不少。先在安装目录里新建两个文件夹。假设你的 Node.js 安装路径是那么需要再建node_global放全局依赖node_cache放全局缓存然后以管理员身份打开命令行窗口。在终端里执行下面几条命令把 npm 的全局目录和缓存目录改过去powershellnpmconfigsetprefixD:\Tools\nodejs\node_globalnpmconfigsetcacheD:\Tools\nodejs\node_cachenpmconfig get prefixnpmconfig get cache这几条命令分别做了什么第 1 条把 npm 的全局安装目录设为node_global第 2 条把 npm 的缓存目录设为node_cache第 3、4 条检查刚才的配置是不是已经生效2.2 配置系统环境变量这里要强调的是需要分别处理用户变量和系统变量。如果你之前没单独整理过 npm 路径这一步一定别省。打开环境变量设置先进入设置系统系统信息高级系统设置然后点高级 → 环境变量。修改用户变量里的 npm 路径在“用户变量”的Path里你通常会看到默认 npm 路径类似textC:\Users\你的用户名\AppData\Roaming\npm我建议把它改成你刚才创建的node_global路径也就是textD:\Tools\nodejs\node_global改完后点“确定”保存。修改系统变量接着看系统变量。这里要做两件事新增变量NODE_PATH变量值设为 Node.js 安装路径在系统变量Path里再增加一条text%NODE_PATH%\node_modules也就是说最终系统变量部分至少会涉及NODE_PATH D:\Tools\nodejsPath %NODE_PATH%\node_modules确认之后环境变量这部分就算完成了。2.3 装个包验证一下全局环境这里我用express做测试这个思路很实用因为它能帮你确认npm 全局安装是不是正常目录是不是确实装到了node_global权限和路径配置有没有问题以管理员身份打开 CMD然后执行bashnpminstallexpress-g这里顺手再解释一下-g-g等同于--global带-g是全局安装不带-g则默认装到当前目录这里还特别提醒一点使用-g之后Node.js 会自动在node_global目录下创建node_modules子目录所以最终包会出现在text【Node.js安装路径】\node_global\node_modules安装完成后你应该能在这个路径里看到新增的express目录。2.4 配置淘宝镜像 / npm 镜像源如果你在国内环境里拉包经常慢、偶尔还会失败那把 registry 切到镜像源会省心很多。我这里给出的命令是powershellnpmconfigsetregistry https://registry.npmmirror.comnpmconfig get registry第一条是设置镜像源第二条是确认当前 registry 是否已经切换成功。第三步安装 Claude Code到这里Node.js、npm 路径、环境变量、镜像源都处理得差不多了才轮到真正安装 Claude Code。安装前先确认版本要求这里先提醒一句确保已经安装 Node.js并且版本至少是 18.0 或更高。如果你前面装的是 LTS 版本一般不会有问题。保险一点的话可以先执行确认一下版本号。用 npm 安装 Claude Code这里展示的是通过 npm 执行安装命令并结合镜像源完成安装。文中给出的命令是bashnpminstall-ghttps://gaccode.com/claudecode/install--registryhttps://registry.npmmirror.com对应的代码块写法是powershell# 安装Claude codenpminstall-ghttps://gaccode.com/claudecode安装完成后查看版本安装结束后可以直接执行如果终端能正确返回版本信息就说明 Claude Code 已经进入可用状态了。第四步把 Claude Code 真正跑起来前面把环境装好只能算完成了一半。想让 Claude Code 在国内环境里真正开始干活还得把CLI 工具、API 配置和首次启动流程这三步走通。走到这里你才算是从“装上了”进入“能用了”。1. 先安装 CLI 工具如果你准备通过 Code80 平台来使用 Claude Code第一步先把官方 CLI 装上bashnpminstall-ganthropic-ai/claude-code这一步做完之后终端里才会有后面真正要用到的claude命令。2. 配置~/.claude/settings.json接下来要做的是把 API 信息配进 Claude Code 的配置文件。直接编辑~/.claude/settings.json写成下面这样json{env:{ANTHROPIC_AUTH_TOKEN:your-api-key,ANTHROPIC_BASE_URL:https://code.ai80.vip}}这里有两个关键参数ANTHROPIC_AUTH_TOKEN替换成你在 Code80 平台获取到的 API KeyANTHROPIC_BASE_URL设置为https://code.ai80.vip这一步的意义其实很明确Claude Code 默认要知道“拿什么令牌访问”和“请求发到哪里去”。这两个值配对了后面启动时才不会卡在连接和鉴权这一步。3. 进入项目目录并启动 Claude Code配置完成后进入你的项目目录然后直接执行bashcdyour-project claude如果前面的安装和配置都没问题这时候 Claude Code 就会真正启动起来。也建议你尽量在具体项目目录里执行而不是随便停在某个空目录里就开跑。这样它一上来就能感知当前代码库和上下文用起来会顺很多。第一次启动会经历什么第一次启动时通常会依次经历这样一个初始化流程选择主题确认安全须知配置终端信任当前工作目录开始编程你可以把这一步理解成首次引导。只要顺着走完后面再进入项目继续用整个体验就会自然很多。说到底这一节补的就是最容易被忽略的最后一公里安装成功不代表立刻可用真正要跑起来关键是把 CLI、API 和项目目录启动这三步打通。一口气回顾整个安装流程如果你想快速复盘整个过程可以概括成下面这条线安装 Node.js优先选稳定的 LTS 版本。验证node -v确认 Node 已经装好。在 Node.js 安装目录下创建node_global和node_cache。用npm config set prefix和npm config set cache把全局目录、缓存目录改过去。检查用户变量和系统变量重点处理Path和NODE_PATH。通过npm install express -g验证全局安装路径是否正常。把 npm registry 切到https://registry.npmmirror.com。执行 Claude Code 安装命令。用claude --version检查最终结果。这套流程看着步骤不少但真按顺序来其实比“哪一步报错就搜哪一步”高效得多。Claude Code 真正适合谁如果你只是偶尔问问代码问题那网页聊天窗口可能就够了。但如果你平时就在本地开发、需要频繁改项目、跑命令、读文件、查 Git 状态那 Claude Code 的体验会明显更顺。它比较适合下面这几类人要经常在本地项目里做修改的开发者需要在命令行里处理任务的后端、前端、全栈工程师想把“查问题 → 改代码 → 执行命令 → 验证结果”串成一条工作流的人想接 MCP、做更自动化开发流程的团队说白了Claude Code 的价值不只是“回答问题”而是让 AI 真正在你的开发环境里干活。常见问题Q1为什么文章里要花这么多篇幅讲 Node.js而不是直接安装 Claude CodeA因为 Claude Code 的 npm 安装依赖 Node.js 环境。如果 Node 版本不对、全局目录没配好、环境变量混乱后面的安装和运行都容易出问题。先把基础环境整理顺成功率会高很多。Q2Node.js 一定要装最新版本吗A不用死磕最新但建议优先选LTS长期支持版本。我给出的思路也是这个稳定、兼容性更好、踩坑更少。Q3为什么还要单独设置 npm 的 prefix 和 cacheA主要是为了让全局依赖和缓存目录更清晰、更可控。默认路径有时候分散在用户目录下不利于排查问题统一到你指定的目录后管理会方便很多。Q4环境变量最容易改错的是哪一块A通常是两处一处是用户变量里的Path没替换成新的全局 npm 路径另一处是系统变量里没有补上NODE_PATH或%NODE_PATH%\node_modules。这两个地方漏一个后面都有可能出问题。Q5为什么还专门演示安装expressA这是一个很直接的验证动作。只要npm install express -g能正常完成并且你在目标目录里看到了express就基本说明 npm 的全局安装链路是通的。Q6国内用户如果想更方便地用上 Claude Code有没有省事一点的办法A如果你不想折腾海外支付、网络环境这些问题国内用户可以通过 Code80 更方便地使用。
Claude国内使用、Claude Code与API教程
发布时间:2026/6/7 1:17:46
写在前面很多人第一次接触 Claude Code卡住的不是“不会用”而是“根本装不上”。问题通常都出在几个老地方Node.js 版本没选对、npm 全局目录和缓存目录没配好、环境变量没改干净、国内网络拉包慢最后命令明明敲了终端却还是一堆报错。所以这篇文章不聊虚的就按一条最实用的主线来先把 Node.js 装好再把 npm 和环境变量整理顺再安装 Claude Code最后确认命令能不能正常跑起来。如果你正准备在 Windows 机器上把这套环境落地照着往下走就行。先搞清楚Claude Code 到底是什么Claude Code 是 Anthropic 做的命令行 AI 编程工具。它不是普通的聊天窗口而是能直接在本地开发环境里工作的 Agent能理解你的代码库结构能执行命令能读写项目文件能辅助你管理 Git 仓库能接入 MCP 等外部能力还能把一些原本很碎、很重的开发工作自动化说白了它更像一个待在终端里的 AI 编程搭子。你给它目标它不只是回答问题还会尽量把事情往前推进。从官方订阅方式看Claude Code 目前主要有几种用法Claude Pro$17/月按年订阅或$20/月按月Claude Max 5x$100/人/月Claude Max 20x$200/人/月API 模式按 Anthropic 官方 API 计费不过说实话官方订阅对国内用户不太友好——需要海外信用卡网络环境也得折腾。如果嫌麻烦想找个更省事的渠道可以看看 Code80真实订阅帐号转 API换个 endpoint 就能直接用体验跟官方一样。详情可以到官网了解code.ai80.vip安装思路先说清楚这篇教程走 npm 方案这篇教程我会分成两种安装方式来看方式一npm 安装方式二官网下载脚本安装这篇文章我主讲npm 方案。原因也很简单对大多数 Windows 用户来说先把 Node.js 和 npm 环境整理好后面不管你装 Claude Code 还是别的前端/Node 工具都会顺很多。第一步安装 Node.js我建议先装 Node.js并优先用 nvm 管理版本。如果你平时就会切换 Node 版本这个做法确实挺合理但如果你现在的目标只是先把 Claude Code 跑起来直接安装一个稳定的 LTS 版本也完全可以。 推荐参考教程 https://blog.csdn.net/sjp991012/article/details/134426007下载安装包Node.js 官网https://nodejs.org/;我这里给出的选择步骤是这样的基本可以直接照着来选择版本v22.14.0 (LTS)原则上优先选最新的 LTS也就是长期支持版本。下载安装包时选择prebuilt预制版。操作系统选择Windows。架构类型选择x64。点击Windows 安装程序.msi开始下载。下载完成后文件名类似node-v24.11.1-x64.msi。安装程序接下来就是标准的 Windows 安装流程。双击安装包node-v22.14.0-x64.msi开始安装。直接点击Next进入协议确认窗口。修改安装路径后点击Next。继续点击Next。这个页面里各选项的意思我也列得很清楚Node.js runtimeNode.js 运行环境npm package managernpm 包管理器Online documentation shortcuts在线文档快捷方式Add to PATH把 Node.js 加到环境变量里不用额外勾选内容继续点击Next会进入Tools for Native Modules窗口。点击Install开始正式安装。等待安装完成。安装结束。最后做一次验证。按WIN R输入CMD回车在命令行里执行能看到 Node.js 版本号就说明安装成功了。第二步配置 npm 路径和环境变量这一步很关键。很多人装完 Node.js 就急着执行安装命令结果后面不是全局包路径乱掉就是缓存目录不好管要么就是 PATH 配得不干净命令行为莫名其妙地出问题。这一步我会拆成两块npm 的 prefix 和 cache 配置系统环境变量配置2.1 配置 npm 的 prefix 和 cache我建议在 Node.js 安装目录下单独准备两个文件夹一个放全局依赖一个放缓存。这个思路很好后面你要排查问题、清缓存、看全局包位置都会方便不少。先在安装目录里新建两个文件夹。假设你的 Node.js 安装路径是那么需要再建node_global放全局依赖node_cache放全局缓存然后以管理员身份打开命令行窗口。在终端里执行下面几条命令把 npm 的全局目录和缓存目录改过去powershellnpmconfigsetprefixD:\Tools\nodejs\node_globalnpmconfigsetcacheD:\Tools\nodejs\node_cachenpmconfig get prefixnpmconfig get cache这几条命令分别做了什么第 1 条把 npm 的全局安装目录设为node_global第 2 条把 npm 的缓存目录设为node_cache第 3、4 条检查刚才的配置是不是已经生效2.2 配置系统环境变量这里要强调的是需要分别处理用户变量和系统变量。如果你之前没单独整理过 npm 路径这一步一定别省。打开环境变量设置先进入设置系统系统信息高级系统设置然后点高级 → 环境变量。修改用户变量里的 npm 路径在“用户变量”的Path里你通常会看到默认 npm 路径类似textC:\Users\你的用户名\AppData\Roaming\npm我建议把它改成你刚才创建的node_global路径也就是textD:\Tools\nodejs\node_global改完后点“确定”保存。修改系统变量接着看系统变量。这里要做两件事新增变量NODE_PATH变量值设为 Node.js 安装路径在系统变量Path里再增加一条text%NODE_PATH%\node_modules也就是说最终系统变量部分至少会涉及NODE_PATH D:\Tools\nodejsPath %NODE_PATH%\node_modules确认之后环境变量这部分就算完成了。2.3 装个包验证一下全局环境这里我用express做测试这个思路很实用因为它能帮你确认npm 全局安装是不是正常目录是不是确实装到了node_global权限和路径配置有没有问题以管理员身份打开 CMD然后执行bashnpminstallexpress-g这里顺手再解释一下-g-g等同于--global带-g是全局安装不带-g则默认装到当前目录这里还特别提醒一点使用-g之后Node.js 会自动在node_global目录下创建node_modules子目录所以最终包会出现在text【Node.js安装路径】\node_global\node_modules安装完成后你应该能在这个路径里看到新增的express目录。2.4 配置淘宝镜像 / npm 镜像源如果你在国内环境里拉包经常慢、偶尔还会失败那把 registry 切到镜像源会省心很多。我这里给出的命令是powershellnpmconfigsetregistry https://registry.npmmirror.comnpmconfig get registry第一条是设置镜像源第二条是确认当前 registry 是否已经切换成功。第三步安装 Claude Code到这里Node.js、npm 路径、环境变量、镜像源都处理得差不多了才轮到真正安装 Claude Code。安装前先确认版本要求这里先提醒一句确保已经安装 Node.js并且版本至少是 18.0 或更高。如果你前面装的是 LTS 版本一般不会有问题。保险一点的话可以先执行确认一下版本号。用 npm 安装 Claude Code这里展示的是通过 npm 执行安装命令并结合镜像源完成安装。文中给出的命令是bashnpminstall-ghttps://gaccode.com/claudecode/install--registryhttps://registry.npmmirror.com对应的代码块写法是powershell# 安装Claude codenpminstall-ghttps://gaccode.com/claudecode安装完成后查看版本安装结束后可以直接执行如果终端能正确返回版本信息就说明 Claude Code 已经进入可用状态了。第四步把 Claude Code 真正跑起来前面把环境装好只能算完成了一半。想让 Claude Code 在国内环境里真正开始干活还得把CLI 工具、API 配置和首次启动流程这三步走通。走到这里你才算是从“装上了”进入“能用了”。1. 先安装 CLI 工具如果你准备通过 Code80 平台来使用 Claude Code第一步先把官方 CLI 装上bashnpminstall-ganthropic-ai/claude-code这一步做完之后终端里才会有后面真正要用到的claude命令。2. 配置~/.claude/settings.json接下来要做的是把 API 信息配进 Claude Code 的配置文件。直接编辑~/.claude/settings.json写成下面这样json{env:{ANTHROPIC_AUTH_TOKEN:your-api-key,ANTHROPIC_BASE_URL:https://code.ai80.vip}}这里有两个关键参数ANTHROPIC_AUTH_TOKEN替换成你在 Code80 平台获取到的 API KeyANTHROPIC_BASE_URL设置为https://code.ai80.vip这一步的意义其实很明确Claude Code 默认要知道“拿什么令牌访问”和“请求发到哪里去”。这两个值配对了后面启动时才不会卡在连接和鉴权这一步。3. 进入项目目录并启动 Claude Code配置完成后进入你的项目目录然后直接执行bashcdyour-project claude如果前面的安装和配置都没问题这时候 Claude Code 就会真正启动起来。也建议你尽量在具体项目目录里执行而不是随便停在某个空目录里就开跑。这样它一上来就能感知当前代码库和上下文用起来会顺很多。第一次启动会经历什么第一次启动时通常会依次经历这样一个初始化流程选择主题确认安全须知配置终端信任当前工作目录开始编程你可以把这一步理解成首次引导。只要顺着走完后面再进入项目继续用整个体验就会自然很多。说到底这一节补的就是最容易被忽略的最后一公里安装成功不代表立刻可用真正要跑起来关键是把 CLI、API 和项目目录启动这三步打通。一口气回顾整个安装流程如果你想快速复盘整个过程可以概括成下面这条线安装 Node.js优先选稳定的 LTS 版本。验证node -v确认 Node 已经装好。在 Node.js 安装目录下创建node_global和node_cache。用npm config set prefix和npm config set cache把全局目录、缓存目录改过去。检查用户变量和系统变量重点处理Path和NODE_PATH。通过npm install express -g验证全局安装路径是否正常。把 npm registry 切到https://registry.npmmirror.com。执行 Claude Code 安装命令。用claude --version检查最终结果。这套流程看着步骤不少但真按顺序来其实比“哪一步报错就搜哪一步”高效得多。Claude Code 真正适合谁如果你只是偶尔问问代码问题那网页聊天窗口可能就够了。但如果你平时就在本地开发、需要频繁改项目、跑命令、读文件、查 Git 状态那 Claude Code 的体验会明显更顺。它比较适合下面这几类人要经常在本地项目里做修改的开发者需要在命令行里处理任务的后端、前端、全栈工程师想把“查问题 → 改代码 → 执行命令 → 验证结果”串成一条工作流的人想接 MCP、做更自动化开发流程的团队说白了Claude Code 的价值不只是“回答问题”而是让 AI 真正在你的开发环境里干活。常见问题Q1为什么文章里要花这么多篇幅讲 Node.js而不是直接安装 Claude CodeA因为 Claude Code 的 npm 安装依赖 Node.js 环境。如果 Node 版本不对、全局目录没配好、环境变量混乱后面的安装和运行都容易出问题。先把基础环境整理顺成功率会高很多。Q2Node.js 一定要装最新版本吗A不用死磕最新但建议优先选LTS长期支持版本。我给出的思路也是这个稳定、兼容性更好、踩坑更少。Q3为什么还要单独设置 npm 的 prefix 和 cacheA主要是为了让全局依赖和缓存目录更清晰、更可控。默认路径有时候分散在用户目录下不利于排查问题统一到你指定的目录后管理会方便很多。Q4环境变量最容易改错的是哪一块A通常是两处一处是用户变量里的Path没替换成新的全局 npm 路径另一处是系统变量里没有补上NODE_PATH或%NODE_PATH%\node_modules。这两个地方漏一个后面都有可能出问题。Q5为什么还专门演示安装expressA这是一个很直接的验证动作。只要npm install express -g能正常完成并且你在目标目录里看到了express就基本说明 npm 的全局安装链路是通的。Q6国内用户如果想更方便地用上 Claude Code有没有省事一点的办法A如果你不想折腾海外支付、网络环境这些问题国内用户可以通过 Code80 更方便地使用。