从零开始，TP手把手带你在国内环境下安装并使用 Claude Code —— 包括 Git、Node.js、镜像加速、cc-switch 模型切换，以及 VS Code 集成。
安装过程中如果遇到报错就把报错信息喂给AI！
Windows 10 64位 或更高版本；macOS 12+；或主流 Linux 发行版。内存建议 8GB 以上。
如果你的道德感特别强的话，那么就需要花点钱哦！你需要一个 Anthropic 账号（用于获取 API Key），或者使用 第三方中转 API（cc-switch 章节会详细说明）。
按照本教程顺序操作：Git → Node.js → Claude Code → cc-switch → VS Code 集成。
访问 Git 官网或国内镜像下载安装包：
# 官方地址（需代理） https://git-scm.com/download/win # 国内镜像（推荐） https://registry.npmmirror.com/binary.html?path=git-for-windows/
Git-2.x.x-64-bit.exe。双击安装包，一路 Next 即可。有几个选项需要注意：
打开 命令提示符 或 PowerShell，输入：
git --version
看到类似 git version 2.x.x.windows.x 即表示安装成功。
git config --global user.name "你的名字" git config --global user.email "你的邮箱@example.com"
访问官网或国内镜像：
# 官方（需代理） https://nodejs.org/ # 国内镜像（推荐） https://registry.npmmirror.com/binary.html?path=node/
选择 LTS 版本的 Windows Installer (.msi)，下载后双击安装，全程默认即可。
node --version # 应显示 v18.x.x 或更高 npm --version # 应显示 9.x.x 或更高
从 GitHub 下载 nvm-setup.exe：
https://github.com/coreybutler/nvm-windows/releases
安装完成后，重新打开终端。
nvm install 20 # 安装 Node 20 LTS nvm use 20 # 切换到 Node 20 node --version # 验证
这一步非常重要，可以大幅提升后续安装速度：
# 设置淘宝 npm 镜像 npm config set registry https://registry.npmmirror.com # 验证是否生效 npm config get registry
https://registry.npmmirror.com，后续所有 npm 安装都会走国内镜像。确保已完成上一步的 npm 镜像配置，然后执行：
npm install -g @anthropic-ai/claude-code
claude --version
看到版本号即安装成功。
在任意项目目录下运行：
claude
首次运行会提示你选择登录方式：
如果你有 Anthropic API Key，也可以直接设置环境变量：
# 临时设置（当前会话有效） $env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxx" # 永久设置（推荐，重启后仍有效） [System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxx", "User")
npm install -g cc-switch
cc-switch --version cc-switch --help
# 设置自定义 API 端点（替换为你的中转地址） cc-switch set --base-url "https://你的中转域名/v1" --api-key "你的API Key" # 指定模型 cc-switch set --model "claude-sonnet-4-5"
cc-switch sonnet # 速度快、性价比高 cc-switch opus # 最强，适合复杂任务 cc-switch haiku # 最快最便宜 cc-switch status # 查看当前配置
# 1. 配置中转 API cc-switch set --base-url "https://api.example.com/v1" --api-key "sk-xxxxxxxx" # 2. 选择模型 cc-switch sonnet # 3. 进入项目，启动 Claude Code cd /path/to/your/project claude
从官网或国内镜像下载：
# 官方 https://code.visualstudio.com/ # 国内镜像（将域名替换） https://vscode.cdn.azure.cn/stable/...
az764295.vo.msecnd.net 替换为 vscode.cdn.azure.cn 即可提速。在 VS Code 扩展市场搜索 Claude Code，安装 Anthropic 官方发布的扩展。
或者在终端执行：
code --install-extension anthropic.claude-code
用 Ctrl + ` 打开终端，然后直接运行 claude：
# 在当前项目目录启动 claude # 直接提问（非交互模式） claude "解释一下这个项目的结构" # 让 Claude 处理特定文件 claude "帮我重构 src/utils.js"
# 交互式对话模式 claude # 查看帮助 claude --help # 指定工作目录 claude --cwd /path/to/project # 打印模式（不进入交互） claude -p "帮我写一个 README" # 继续上次对话 claude --continue
在 settings.json 中添加以下配置，提升使用体验：
{
// 终端字体推荐等宽字体
"terminal.integrated.fontFamily": "JetBrains Mono, Consolas, monospace",
"terminal.integrated.fontSize": 14,
// 终端滚动缓冲区加大
"terminal.integrated.scrollback": 5000,
// 自动保存（配合 Claude Code 修改文件）
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 1000
}
Windows 用户以管理员身份运行 PowerShell 或命令提示符后重试。
确认 npm 镜像已切换到淘宝源：
npm config get registry # 应显示 https://registry.npmmirror.com
npm 全局包路径未加入 PATH。执行以下命令查看全局路径，然后手动添加到系统环境变量：
npm config get prefix # 将输出路径下的 \bin 添加到系统 PATH
检查以下几点：
/）cc-switch status 确认当前配置npm update -g @anthropic-ai/claude-code
如果 Claude Code 修改文件后出现换行符混乱，在项目根目录创建 .gitattributes：
* text=auto eol=lf
现在你可以在任意项目目录运行 claude 开始使用了。
有问题欢迎在留言板留言。