首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Claude Code 国内一键安装脚本:不装 Node.js、不手配环境变量,一条命令跑起来(2026 年 9 月实测)

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

原创
作者头像
用户6170966
发布2026-09-03 16:31:53
发布2026-09-03 16:31:53
470
举报

先给结论:有。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_URLANTHROPIC_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

✅ 只配该云的模型服务

部分

❌ 只在那个云环境里

接入服务商脚本(本文用 Code2AI(code2ai.codes)的两个脚本举例)

✅ 缺则装便携版

✅ 三级回退

✅ 浏览器配对码授权

✅ 真发一次请求

✅ PowerShell 版

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


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

只用 Claude 模型:Claude Code 线

macOS / Linux / WSL:

代码语言:bash
复制
curl -fsSL https://console.code2ai.codes/install.sh | bash

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

代码语言:powershell
复制
iex "& { $(irm https://console.code2ai.codes/install.ps1) }"

要在 /model 里切换 Claude / GPT / Kimi / GLM / DeepSeek:多模型线

代码语言:bash
复制
curl -fsSL https://flex.code2ai.codes/install.sh | bash
代码语言:powershell
复制
irm https://flex.code2ai.codes/install.ps1 | iex

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

代码语言:bash
复制
curl -fsSL https://console.code2ai.codes/install.sh -o install.sh
less install.sh      # 看完再决定
bash install.sh

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

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

步骤

做什么

失败了怎么办

① 配对授权

向服务端申请一个 6 位配对码和一个网址,把配对码复制进剪贴板;你用任意浏览器(手机也行)打开网址、登录、粘贴配对码,终端自动拿到 Key

当下不方便就 Ctrl+C 跳过,工具照常装,之后 c2a login(Claude Code 线)或 flex login(多模型线)补

② 装 Claude Code

三级回退:有 Node 就 npm install -g;没有就下载官方脚本——先校验拿到的是不是真的 shell 脚本,被 DNS 劫持成 HTML 会跳过而不是执行;再不行从 npmmirror 拉官方二进制

Claude Code 线在没有 Node 时会先装一份便携版 Node LTS到用户目录,不动系统、不要管理员权限

③ 装辅助命令

Claude Code 线装 c2a,多模型线装 flex,之后自检、换号、更新都靠它

④ 写配置

Claude Code 线把 ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN 写进 shell 配置文件(带标记块,旧配置先备份);多模型线默认不写全局配置,Key 存在 ~/.flex/token,只在你显式 flex use 或加 --global 时才碰 ~/.claude/settings.json

多模型线如果检测到 settings.json 里已经配了别的网关,不覆盖,只提示你二选一

⑤ 验证

真发一次 /v1/messages 请求(max_tokens 为 10),200 才算通;401 提示重新授权,503 提示通道暂不可用

网络异常只警告不回滚,配置已写入,之后手动跑 claudeflex doctor

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


四、这套脚本不适合谁

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

五、跑完之后的三条自检

代码语言:bash
复制
claude --version          # 有版本号 = 客户端装好了
c2a doctor                # Claude Code 线:一键自检(多模型线用 flex doctor)
flex status               # 多模型线:当前用的是哪条线路、Key 有效期

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


六、适用条件:四种情况

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

七、常见问题

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。

装完想换回官方或别的服务?

多模型线:flex use official。Claude Code 线:删掉 shell 配置文件里 # >>> code2ai >>># <<< code2ai <<< 之间那一段即可,脚本写入时的备份文件在同目录下。


利益披露:本文举例的两个脚本是作者本人在做的服务(Code2AI,code2ai.codes)提供的,第二、三节对它们的描述来自 2026-09-03 读到的脚本源码,源码公开,你可以自己核对。第一节和第四节的判断对任何一家接入服务都成立,包括本文作者。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、先分清:一键安装装的是客户端,模型是另一件事
  • 二、三类「一键安装脚本」到底各做了什么
  • 三、命令本身,以及它背后做的五件事
    • 只用 Claude 模型:Claude Code 线
    • 要在 /model 里切换 Claude / GPT / Kimi / GLM / DeepSeek:多模型线
    • 脚本跑起来之后发生了什么
  • 四、这套脚本不适合谁
  • 五、跑完之后的三条自检
  • 六、适用条件:四种情况
  • 七、常见问题
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档