Claude Code 国内安装指南

本指南专为国内用户设计，提供完整的 Claude Code 安装方案，解决网络访问限制问题。

本指南特点

  • ✅ 使用国内镜像源，安装速度快
  • ✅ 提供一键自动化安装脚本
  • ✅ 详细的手动安装步骤作为备选
  • ✅ 包含完整的环境配置说明

方式一：全自动安装（推荐）

Windows 用户

前置条件

必须先安装以下软件才能继续：

  • Node.js（建议 v20+）
  • Git

Windows 10 用户需要手动安装 Node.js，安装完成后再执行下方脚本。

1

以管理员身份打开终端

在开始菜单上右键，选择"终端管理员"（Windows 10 用户选择"PowerShell 管理员"）

2

执行自动安装脚本

powershell
irm https://www.meiyet.com/scripts/install.ps1 | iex

脚本会自动：

  • 检测并安装 Node.js（如需要）
  • 配置 npm 国内镜像源
  • 安装 Claude Code
  • 配置必要的环境变量
3

配置环境变量

按照脚本提示手动配置以下环境变量：

bash
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_BASE_URL="https://api.meiyet.com"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
export CLAUDE_CONFIG_DIR="自定义配置目录"
export API_TIMEOUT_MS=3000000

配置方法：

  1. 右键"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"系统环境变量"中点击"新建"，逐一添加上述变量

推荐工具

建议安装 CC-Switch 来管理不同的配置和令牌。下载 CC-Switch

macOS & Linux 用户

1

安装 Xcode 命令行工具（macOS）

打开终端，输入：

bash
xcode-select --install

在弹出的对话框中继续安装，大约需要 10 分钟。

2

执行自动安装脚本

bash
curl -fsSL https://www.meiyet.com/scripts/install.sh | bash

按提示要求输入 API Token 即可。

3

使配置生效

如果发现未生效，在终端中执行：

bash
source ~/.zshrc

小提示

重复调用脚本可以切换模型供应商与重新输入令牌。

方式二：手动安装

如果自动安装遇到问题，可以按照以下详细步骤手动完成安装。

第一步：安装前置软件

下载并安装以下软件（双击 .exe/.msi 文件，一路点击"Next"）：

验证安装

按 Win + R，输入 cmd，在命令提示符中输入：

bash
node -v
npm -v

看到版本号说明安装成功。

第二步：配置 npm 镜像

在命令提示符中执行：

bash
npm config set registry https://registry.npmmirror.com

第三步：安装 Claude Code

bash
npm install -g @anthropic-ai/claude-code

第四步：配置环境变量

  1. 右键"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"按钮
  4. 在"系统环境变量"区域点击"新建"，添加以下变量：
text
ANTHROPIC_BASE_URL = https://api.meiyet.com
ANTHROPIC_AUTH_TOKEN = 你的API密钥
ANTHROPIC_MODEL = claude-sonnet-4-6

重要

配置环境变量后，必须关闭并重新打开终端才能生效！

快速开始

安装完成后，你可以：

1. 进入你的项目目录

bash
cd Desktop/my-project
claude

2. 试试这些指令

  • "这个项目是做什么的？帮我理一下逻辑。"
  • "帮我写一个简单的登录页面，背景要淡蓝色的。"
  • "运行报错了，报错信息是 xxx，帮我修一下。"

3. 必记的快捷命令

命令说明
/compact压缩对话上下文（聊太久会变笨时使用）
/model切换模型（如 /model claude-opus-4-6）
/exit退出 Claude Code
claude --continue恢复之前的对话
claude --resume恢复中断的状态
claude --dangerously-skip-permissions跳过权限确认（慎用）

常用终端命令速查

命令说明
ls查看当前目录内容
cd 文件夹名进入某个文件夹
cd ..返回上一层
mkdir 文件夹名新建文件夹
pwd显示当前所在位置

配合 VS Code 使用

最佳实践：

  1. 用 VS Code 打开你的项目文件夹
  2. 在 VS Code 底部打开"终端"（Ctrl/Cmd + `）
  3. 在终端中运行 claude

这样你就能一边看着 Claude 在左边写代码，一边在右边和它聊天！

下载 VS Code

macOS 版本 | Windows 版本

模型选择指南

模型 ID智力等级速度适合场景建议
claude-opus-4-6⭐⭐⭐⭐⭐较慢顶级逻辑推理、高难 Bug 攻坚最聪明但最贵，杀鸡别用牛刀
claude-sonnet-4-6⭐⭐⭐⭐极快写代码首选、日常全能任务目前最推荐，写代码比 Opus 爽
claude-haiku-4-5-20251001⭐⭐⭐最快简单任务、快速响应速度快，成本低

切换模型：在对话中输入 /model 模型ID

常见问题

网络连接失败怎么办？

确保 ANTHROPIC_BASE_URL 配置正确，并且你的网络可以访问该地址。

npm install 速度很慢？

检查 npm 镜像源是否配置正确：

bash
npm config get registry
# 应该输出: https://registry.npmmirror.com

环境变量配置后不生效？

  • Windows：必须关闭并重新打开终端
  • macOS/Linux：执行 source ~/.zshrc 或重启终端

提示权限错误？

  • Windows：以管理员身份运行终端
  • macOS/Linux：命令前加 sudo

安全提醒

重要

  • 在重要项目上使用前，务必先备份或使用 Git 提交
  • Claude Code 具有文件删除和命令执行权限
  • 执行复杂命令时，注意查看它想做什么
  • 不要闭着眼一直点 "y" 授权

下一步

安装完成后，推荐阅读：

安装完成！

恭喜你完成了 Claude Code 的安装！现在你可以开始享受 AI 辅助编程的便利了。