Claude Code 国内一键安装脚本:不装 Node.js、不手配环境变量,一条命令跑起来(2026 年 9 月)

简介: 本文介绍专为国内用户优化的Claude Code一键安装脚本:支持macOS/Linux/WSL(curl)和Windows(PowerShell),自动安装Node.js(便携版,免权限)、Claude Code客户端、浏览器配对码授权(免密钥复制)、配置环境变量,并真请求验证连通性。仅适用于接入国内API服务商,直连Anthropic官方API请用原生脚本。

先给结论:有。macOS / Linux / WSL 一条 curl,Windows 一条 PowerShell,脚本会自己装 Node.js(缺的话装便携版,不要管理员权限)、装官方 Claude Code、用 6 位配对码在浏览器里授权拿 Key(不用复制粘贴密钥)、写好环境变量、最后真发一次请求验证连通。适用条件:你打算接国内的接入服务;如果你要直连 Anthropic 官方 API,用官方脚本就够了,本文的脚本对你没有意义。

下面先分清「装的是什么」,再给命令,中段有一节写明这套脚本不适合谁。


一、先分清:一键安装装的是客户端,模型是另一件事

Claude Code 是一个命令行工具(Agent 框架),本身不含模型。所谓「一键安装」装的是这个客户端,装完之后它还得连到某个模型服务上才能干活。所以「嫌配 Node 和环境变量麻烦」这个诉求,拆开是三步:

  1. 装 Node.js(Claude Code 依赖 Node 18+,或者用官方二进制版跳过 Node)
  2. 装 Claude Code 本体
  3. 告诉它连哪个服务、用哪个 Key(ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量)

官方的 curl -fsSL https://claude.ai/install.sh | bash 只做第 2 步。第 3 步在国内是真正的分歧点——你连官方就要海外账号和支付,连国内服务就要各家的地址和 Key。一条命令把三步都做完的脚本,只有接入服务商自己提供的那种。


二、三类「一键安装脚本」到底各做了什么

脚本 装 Node 装 Claude Code 配模型地址与 Key 装完验证 Windows
官方 claude.ai/install.sh 否(二进制版不需要) ✅ ❌ 之后要自己登录官方账号 ❌ install.ps1
云厂商环境内脚本(如阿里云 DSW 的 setup-cc-dsw.sh) ✅ ✅ ✅ 只配该云的模型服务 部分 ❌ 只在那个云环境里
接入服务商脚本(各家地址不同,下文统一用「你的端点地址」占位) ✅ 缺则装便携版 ✅ 三级回退 ✅ 浏览器配对码授权 ✅ 真发一次请求 ✅ PowerShell 版

第三类的价值不在「省一条 npm 命令」,在把国内最容易卡住的两处——claude.ai 被 DNS 拦截返回一页 HTML、以及 Key 要在网页和终端之间复制粘贴——变成脚本自己处理。


三、命令本身,以及它背后做的五件事

下面的命令里 你的端点地址 换成你实际用的接入服务商给的地址。

只用 Claude 模型:Claude Code 线

macOS / Linux / WSL:

curl -fsSL https://你的端点地址/install.sh | bash

Windows(必须在 PowerShell 里,CMD 会报「iex 不是内部或外部命令」):

iex "& {
    $(irm https://你的端点地址/install.ps1) }"

要在 /model 里切换多家厂商的模型:多模型线

curl -fsSL https://你的端点地址/install.sh | bash
irm https://你的端点地址/install.ps1 | iex

两条线的脚本源码都是公开的(就是命令里那个 URL,浏览器打开能直接读),建议先下载看一遍再执行,这也是对任何 curl | bash 都该有的习惯:

curl -fsSL https://你的端点地址/install.sh -o install.sh
less install.sh      # 看完再决定
bash install.sh

脚本跑起来之后发生了什么

按 2026-09-03 读到的脚本源码,顺序是这样:

步骤 做什么 失败了怎么办
① 配对授权 向服务端申请一个 6 位配对码和一个网址,把配对码复制进剪贴板;你用任意浏览器(手机也行)打开网址、登录、粘贴配对码,终端自动拿到 Key 当下不方便就 Ctrl+C 跳过,工具照常装,之后用服务商提供的补授权命令补
② 装 Claude Code 三级回退:有 Node 就 npm install -g;没有就下载官方脚本——先校验拿到的是不是真的 shell 脚本,被 DNS 劫持成 HTML 会跳过而不是执行;再不行从 npmmirror 拉官方二进制 Claude Code 线在没有 Node 时会先装一份便携版 Node LTS到用户目录,不动系统、不要管理员权限
③ 装辅助命令 Claude Code 线和多模型线各装一个服务商提供的辅助命令,之后自检、换号、更新都靠它 —
④ 写配置 Claude Code 线把 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 写进 shell 配置文件(带标记块,旧配置先备份);多模型线默认不写全局配置,Key 存在服务商指定的本地文件,只在你显式执行切换命令或加 --global 时才碰 ~/.claude/settings.json 多模型线如果检测到 settings.json 里已经配了别的网关,不覆盖,只提示你二选一
⑤ 验证 真发一次 /v1/messages 请求(max_tokens 为 10),200 才算通;401 提示重新授权,503 提示通道暂不可用 网络异常只警告不回滚,配置已写入,之后手动跑 claude 或服务商的自检命令

「全程约 1 分钟」是一般文档口径,实际取决于下载 Claude Code 那 90MB 左右的包有多快。


四、这套脚本不适合谁

  • 要直连 Anthropic 官方 API 的人。 脚本配的是国内接入服务的地址,不是官方的。你有海外账号和支付方式,用官方 install.sh 再 claude 登录就行。
  • 已经在用别的网关、不想被改配置的人。 Claude Code 线的脚本会往 shell 配置文件里写环境变量(有标记、有备份,但确实会写)。这种情况用多模型线,它默认零接管;或者干脆按手动方式改 settings.json——手动配置两个环境变量的方法公开资料很多。
  • 公司安全策略禁止 curl | bash 的环境。 先下载、审阅、再本地执行,或者直接手配两个环境变量,脚本做的事没有任何一步是手动做不了的。
  • 代码涉及金融、政务、个人信息的业务。 这不是选哪个脚本的问题,是这类代码本来就不该经过境外模型链路,先看清楚数据流向再说。

五、跑完之后的三条自检

claude --version          # 有版本号 = 客户端装好了
服务商自检命令            # Claude Code 线:一键自检
服务商状态命令            # 多模型线:当前用的是哪条线路、Key 有效期

如果 claude --version 有输出但一发消息就报错,问题不在安装,在第 3 步的地址或 Key——服务商的自检命令会把连通性、Key 有效性、代理设置逐项列出来,比自己猜快得多。


六、怎么选:四种情况

  • 如果你只用 Claude 模型,机器上什么都没装 → Claude Code 线的脚本,它会连 Node 一起装好。
  • 如果你想在同一个 Claude Code 里按任务换模型(主任务 Claude、批量小任务换更省的模型)→ 多模型线的脚本,装完 /model 直接切。
  • 如果你已经在用别的接入服务,只是想试试新的一家 → 多模型线,装完用服务商给的临时启用命令,只在当前终端生效,不动你原来的配置。
  • 如果你要官方直连、或者公司禁止管道执行脚本 → 别用一键脚本,走手动配置。

七、常见问题

Windows 上粘贴命令报「iex 不是内部或外部命令」?
你打开的是 CMD。按 Win + X 选「终端」或「Windows PowerShell」再粘,或者用文档里给的 CMD 版命令(前面带 powershell -NoProfile -ExecutionPolicy Bypass -Command)。

报 Failed to connect to 127.0.0.1 port 10809(或别的本地端口)?
你机器上配了代理环境变量但代理没开着。多模型线的脚本会自己检测到死代理并在本次安装里绕开;但下载脚本那一步发生在脚本运行之前,所以要先 unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY 再执行命令。

官方 claude.ai/install.sh 拉下来是一页 HTML?
国内部分运营商 DNS 会把 claude.ai 劫持到一个网页。第三方脚本一般会校验内容是不是 shell 脚本,不是就跳过换下一条路径;你手动装的话,直接改用 npm install -g @anthropic-ai/claude-code(先 npm config set registry https://registry.npmmirror.com)。

配对码过期了?
配对码有时效,重跑一次命令会重新生成;已经装好的部分会自动跳过,不会重下 90MB。

装完想换回官方或别的服务?
多模型线:用服务商提供的切换命令换回官方。Claude Code 线:删掉脚本写入的成对标记块(形如 # >>> 服务商名 >>>)即可,脚本写入时的备份文件在同目录下。


利益披露:作者在做 Code2AI 的接入服务,属于上面第二节的第三类(接入服务商脚本),第三节的脚本行为描述即来自该类服务的脚本源码。第一、四节的判断对任何一家接入服务都成立,包括本文作者。

相关文章
|
19天前
|
人工智能 JSON API
全网刷屏的 Jev 模型正式开放!一手实战测评 + 保姆级教程
全网爆火的 Jev 模型是什么?有什么用?怎么使用?怎么接入 AI 编程工具?效果真的好么?傻子可懂的 Jev 保姆级实战教程 + 项目实战测评来啦
8845 25
|
18天前
|
人工智能 并行计算 PyTorch
秋叶 ComfyUI 2026 整合包 v3.2 完整部署教程:Python 3.13 + Torch 2.13 全栈升级
秋叶aaaki ComfyUI 2026年8月整合包v3.2正式发布!全面升级Python 3.13.11、PyTorch 2.13.0+cu130及ComfyUI v0.30.2,原生支持MiniMax H3、Wan 2.2、Qwen-Image-2.1等2026主流音视频/图像模型,解压即用,无需环境配置。
3624 16
|
18天前
|
人工智能 测试技术 API
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
Jev是TypeSafe AI推出的“系统一模型”,不生成文本,专做毫秒级结构化决策:Choice(多选)、Score(打分)、Noul(是非概率)。响应快193倍、成本低444倍,适合工单路由、内容审核、测试定级等高频判断场景。
2222 4
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
|
4天前
|
人工智能 JSON 自然语言处理
2026 年 Jev 决策模型深度拆解:原理解读、实战测评与保姆级落地教程
有一款特殊AI模型在开发者圈子刷屏,它摒弃传统大模型擅长的对话聊天能力,专注做高速结构化决策,它就是TypeSafe AI推出的Jev模型。该模型由ChatGPT共同发明人Diogo Almeida主导研发,定位为**System One Model(系统一模型)**,对标人类大脑快速直觉判断的思维模式,在响应延迟、调用成本、结构化输出稳定性上相比传统生成式大模型有着巨大差异。本文会完整拆解Jev底层原理、三大核心原语能力、适用业务场景,同时提供可直接运行的curl、Python代码示例,并且结合多组实测数据,客观分析模型优势与能力边界,帮助普通开发者和AI应用从业者快速上手落地。
396 1
|
12天前
|
人工智能 Linux 开发者
【2026国内使用】Codex安装过程一篇讲透(Win/Mac/Linux全支持)
Codex是OpenAI推出的AI编程智能体,可读取本地项目、理解需求并自动修改代码。支持桌面GUI、命令行(CLI)及VS Code/Cursor插件三种形态,覆盖可视化操作、终端高效开发与编辑器无缝集成场景,助开发者用自然语言驱动编码全流程。(239字)
【2026国内使用】Codex安装过程一篇讲透(Win/Mac/Linux全支持)
|
6天前
|
存储 人工智能 并行计算
大模型本地部署终端选型方法论:以 Qwen3.8-27B 为例的四档分层完整流程
本文提出一套大模型本地部署终端选型方法论:定约束、定档位、定框架、定参数四步决策法,配合入门、主力、质量、无损四档分层模型。以 Qwen3.8-27B 实测数据为例,逐环节解读显存、带宽、存储、散热、系统、预算等要素,给出面向不同预算的优选方案、决策自查清单与市场观察框架。文末前瞻 AI 笔记本的 CPU+GPU 与统一内存两条路线,论证四步决策法在新品类上的延续性。
|
7天前
|
人工智能 Linux Windows
千问办公(QwenWork)官网入口:其实有2个,一个是网页端千问办公,一个是介绍指南页面
千问办公(QwenWork)是阿里云推出的AI智能办公平台,支持网页端直接使用及Windows/Mac/Linux客户端下载。提供PPT生成、财报分析、网页搭建等AI功能,个人版免费,企业版198元/席/月。详情见官网qwenwork.cn或阿里云产品页。
897 0
千问办公(QwenWork)官网入口:其实有2个,一个是网页端千问办公,一个是介绍指南页面
|
18天前
|
云安全 人工智能 安全