Claude Code 一键配置安装教程

0. 前置：先安装 Node.js

一键配置脚本会自动安装 Claude Code，但前提仍然是你的电脑已经装好 Node.js 和 npm。

先装 Node.js（建议 22+）：

• macOS：Nodejs macOS
• Linux：Nodejs Linux
• Windows：Nodejs Windows

验证安装：分别执行下面两个命令

node -v

npm -v

如果看到版本号，说明 Node.js 安装成功了。

1. 运行一键配置命令

第一步：打开终端

• macOS：打开 Terminal
• Linux：打开你常用的终端
• Windows：请使用 Git Bash、MSYS2 或 WSL 终端运行下面命令，不要直接在 cmd 里执行

第二步：执行一键配置命令

curl -sSL https://sh.ci-yuan-ai.com/claudecode.sh | bash

脚本启动后会显示菜单，你可以按提示选择：

• 1 只安装 Claude Code
• 2 只配置 API Key 和线路
• 3 一键全部安装（推荐）

如果你是第一次安装，直接选 3 即可。

2. 这个脚本会做什么

2.1 安装 Claude Code

脚本会先检查你的电脑里有没有 npm。

如果没有 npm，脚本会提示你先安装 Node.js。

如果已经有 npm，脚本会继续安装 Claude Code：

• macOS / Linux：优先调用 Claude 官方安装器
• 如果官方安装失败：自动回退到 npm install -g @anthropic-ai/claude-code
• 如果默认源网络不通：再尝试国内 npm 镜像
• Windows（Git Bash / MSYS2）：直接走 npm 安装，失败时自动切镜像

如果你之前已经装过 Claude Code，脚本会先检测版本，并询问你是否重新安装。

2.2 配置 API Key 和线路

脚本会引导你完成下面几件事：

• 选择 API 线路
• 输入你的闪电 API Key
• 自动验证这个 Key 是否能正常获取模型列表
• 把配置写入 Shell 环境变量
• 跳过 Claude Code 首次 onboarding

你可以选择两条线路：

• https://api.ci-yuan-ai.com：国内直连，适合中国大陆用户
• https://cdn.ci-yuan-ai.com：海外 CDN，适合海外网络环境

脚本保存的是这两个环境变量：

• ANTHROPIC_API_KEY
• ANTHROPIC_BASE_URL

同时还会自动更新 ~/.claude.json，把 hasCompletedOnboarding 设为 true。

2.3 写入到哪里

脚本会自动识别你正在使用的 Shell，并把环境变量写入对应配置文件。

常见情况如下：

• macOS：通常写入 ~/.zshrc
• Linux：通常写入 ~/.bashrc 或 ~/.zshrc
• Windows Git Bash：通常写入 ~/.bashrc

如果机器上已经存在多个 Shell 配置文件，脚本也会一并写入，避免你换终端后配置失效。

3. 使用前你还需要准备什么

在运行一键配置前，请先准备好下面两样：

• 一个可用的闪电 API Key
• 你已经在 ai.ci-yuan-ai.com 后台创建好对应的令牌分组

脚本本身也会提示你：如果没有先创建令牌分组，可能拿不到模型列表。

4. 安装完成后怎么用

脚本执行完成后，建议你关闭当前终端，再重新打开一个新的终端窗口。

然后先验证：

claude --version

claude doctor

如果都正常，再进入你的项目目录启动 Claude Code：

cd /path/to/your/project
claude

把 /path/to/your/project 替换成你的实际项目路径。

常见问题

1. 一键脚本提示未找到 npm

原因：你的机器还没有安装 Node.js，或者终端还没加载到 npm。

解决方法：

1. 先按你的系统安装 Node.js
2. 重新打开一个新的终端窗口
3. 先执行 node -v 和 npm -v
4. 确认正常后，再重新运行一键脚本

2. Windows 为什么不能直接用 PowerShell 跑这条命令？

这条命令本质上是把远程 bash 脚本交给本地 bash 执行，所以 Windows 需要有 Bash 环境。

推荐三种方式：

• 使用 Git Bash
• 使用 WSL
• 使用 MSYS2

如果你只想在 PowerShell 里手动配置，可以改看 Claude Code Windows。

3. 脚本执行完后，claude 还是找不到

原因：新的 PATH 或环境变量还没有在当前终端里生效。

解决方法：

1. 先关闭当前终端
2. 再打开一个新的终端窗口
3. 重新执行 claude --version

如果还是不行，再重新运行一次脚本，选择 1 或 3。

4. API Key 验证失败，还能继续保存吗？

可以。脚本在验证失败时会再次询问你是否仍然保存配置。

但更推荐先检查：

1. API Key 是否复制完整
2. 令牌分组是否已经创建
3. 你选择的线路是否适合当前网络环境