Claude Code 的下载和配置流程主要涉及几种安装方式，尤其是在国内环境下，为了提高成功率，官方会推荐一些替代方案。

 

🔧 环境准备

 

安装 Claude Code 前，请先配置好基础环境，这是安装成败的关键。

 

· Node.js：这是安装Claude Code的核心依赖，必须确保版本在 18.0 或以上。在终端执行 node -v 命令可查看版本。若版本过低，推荐使用 nvm (Node Version Manager) 进行版本管理。

· Git：虽然不是强制要求，但强烈建议安装，以便Claude Code能更好地利用版本管理功能，例如进行代码提交。

· 终端：确保你能熟练使用系统的终端。Windows用户强烈推荐使用 PowerShell 或 WSL（Windows Subsystem for Linux）环境。

 

📥 安装方式

 

你可以根据自己的系统和偏好选择以下任一方式进行安装。

 

· 原生脚本（官方推荐）：全平台通用，管理简单，能自动处理好环境变量。

  · macOS/Linux/WSL：curl -fsSL https://claude.ai/install.sh | bash

  · Windows (PowerShell)：irm https://claude.ai/install.ps1 | iex

  · Windows (CMD)：curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd

· Homebrew (macOS)：macOS用户若习惯用Homebrew管理软件，这种方式非常便捷。

  · brew install --cask claude-code

· npm/yarn/pnpm (全平台)：Node.js开发者可选用此方式。

  · npm：npm install -g @anthropic-ai/claude-code

 

🇨🇳 国内加速

 

在国内环境下，为避免网络问题导致安装失败，强烈建议在安装npm包时配置国内镜像源。

 

```bash

# 使用淘宝 npm 镜像源安装

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

```

 

如果需要对npm的全局配置进行永久修改，也可以用 npm config set registry 命令。

 

✅ 验证安装

 

安装完成后，在终端执行以下命令，若正确输出版本号，则说明安装成功：

 

```bash

claude --version

```

 

🔑 认证与模型配置

 

安装成功后，Claude Code需要配置认证信息才能开始使用。你可以根据自己的情况，选择以下三种方案之一进行配置。

 

· 方案一（推荐）：配置文件 (settings.json) 这种方式全局生效，且便于管理。

  1. 在用户目录下创建配置文件夹和文件：~/.claude/settings.json。

  2. 用文本编辑器打开 settings.json，根据需求填入内容。

· 方案二：环境变量 适合临时切换或自动化脚本，但每次切换终端或重启后可能需要重新设置。

· 方案三：一键配置脚本 部分云服务商（如SiliconFlow）提供了一键脚本，自动完成环境变量设置和模型选择，是最省心的方案。

 

具体的配置内容如下：

 

· 官方用户：需要添加API Key和修改API地址，模型名通常可省略。ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 二选一，不要同时设置。

· 第三方代理：推荐使用 SiliconFlow或七牛云的代理服务。需要添加对应的API地址和Key，并明确指定可用的模型名。

· 国产模型：国内可直接调用的模型（如DeepSeek、智谱GLM、阿里百炼等），可参考阿里云百炼平台。同样需要添加API地址、Key和对应的模型名。

 

🚀 初始设置与登录

 

启动 Claude Code 时，如果 settings.json 中没有提前配置好认证信息，它会引导你进行登录。

 

1. 启动：在你的项目目录下，打开终端并输入命令 claude。

2. 首次设置：如果是通过 claude 命令第一次启动，系统会依次提示你选择主题、确认安全须知等，一路按回车选择默认即可。

3. 触发登录：如果启动时没有自动弹出登录提示，你可以在Claude Code的交互界面中输入命令 /login 来手动触发。

4. 选择账户：系统会提示你选择连接方式：

   · Continue with Google / Microsoft：关联你的Claude订阅账户（如Claude Pro或Max会员）。

   · Use API Key：使用你之前获取的API Key。选择此项后，粘贴你的API Key即可。

5. 授权：选择后，浏览器会打开一个新页面，请求你授予Claude Code访问你账户的权限。点击“同意”或“Authorize”即可。

6. 完成：授权成功后，关闭浏览器页面回到终端，Claude Code即可开始使用。

 

🇨🇳 可选：中文增强

 

如果你希望Claude Code的界面和交互完全是中文的，可以使用第三方工具 claudezh。安装后，在Claude Code中输入 /zh 命令即可切换到简体中文模式。

 

```bash

npm install -g claudezh

```

 

你可以根据自己的开发环境，选择最适合的安装方式。如果在配置中遇到问题，随时可以告诉我你的操作系统和报错信息，我可以为你提供具体的排查建议。