Claude Code 国内安装使用关键步骤总结（可直接按此操作）

本教程适配国内网络环境，全程无需魔法，核心分为前置准备、安装 Claude Code、配置模型、启动使用、问题排查5 大步骤，附关键指令和注意事项，可直接落地操作。

一、前置准备（必装，缺一不可）

1. 安装 Git

Windows：官网下载Windows/X64 Setup版本安装；Mac 系统自带，无需下载。

验证：命令行输入git --version，输出版本号即成功。

2. 安装 Node.js 和 npm

官网下载适配自己系统的安装包，正常安装即可（建议 Node.js 18 + 版本）。

验证：命令行分别输入node -v和npm -v，均显示版本号即成功。

3. 命令行工具

Mac：启动台打开终端；Windows：开始菜单打开Git Bash，后续统一称「命令行」。

二、安装 Claude Code（国内镜像源，避坑核心）

核心用国内镜像源替代 npm 官方源（国外访问慢），步骤带实际可执行命令，直接复制即可：

打开命令行，配置国内镜像源：npm config set registry https://registry.npmmirror.com

验证镜像源：npm config list，显示上述镜像地址即配置成功。

全局安装 Claude Code：npm install -g @anthropic-ai/claude-code

权限不足解决：加管理员权限重新执行，Mac/Linux 加sudo，Windows 以管理员身份打开命令行，强制安装最新版。

安装验证：claude --version，输出版本号即安装成功。

三、配置模型（关键步骤，需 CC Switch 工具）

1. 前期准备

去模型供应商平台开账户，获取 API key（模型访问凭证），并保证平台有可用 Token 额度（需充值 / 购套餐）。

模型选择：国内选智谱 GLM5、Minimax M2.5；国外选 Claude Opus4.6、Gemini3.1Pro（需合规中转站订阅）。

2. 安装 CC Switch（模型配置工具）

下载地址：GitHub Releases，Mac/Windows 选对应版本。

Mac 首次运行：按住 control 键点击 APP→选择「打开」，或在系统设置 - 安全性与隐私中确认打开。

3. 配置 CC Switch

打开 CC Switch，选「Claude」标签，点击右上角「+」。

选择模型供应商，无对应供应商则选「自定义配置」。

填写必填信息：API key（供应商获取）、请求地址（平台 API 文档可查，CC Switch 会预填部分）。

填写选填建议项：指定模型名称（必须是供应商支持的，否则无法识别），其他配置默认。

启用配置：选择配置好的供应商点击启用，后续可切换，每次切换后需在 Claude Code 中重新选模型才生效。

四、启动并使用 Claude Code

打开命令行，输入核心启动指令：claude，回车执行。

模型选择：在 Claude Code 中输入指令调出模型列表，用键盘上下箭头选择CC Switch 中启用的供应商模型。

完成后即可正常使用，支持编程、写作、数据分析、办公等场景。

五、常见问题排查（模型找不到专属解决方案）

若切换 / 选择模型后提示「找不到模型」，按以下步骤排查：

先退出 Claude Code，重新启动后重试。

核查 CC Switch：API key、请求地址、模型名称是否填写错误（字母 / 符号大小写、空格都要核对）。

核查模型供应商平台：是否有充足的余额 / 可用套餐，无额度会无法调用。

六、三类常用指令（直接调用）

1. 启动类（终端执行）

启动：claude

继续上次对话：claude -c

恢复指定会话：claude -r "会话名"

查看版本 / 验证安装：claude --version

更新到最新版：claude update

2. 对话类（Claude Code 内输入）

输入斜杠 /，直接调出所有会话指令（如 /clear 清除历史、/exit 退出、/copy 复制回复等）。

3. 安装卸载类（终端执行）

安装：npm install -g @anthropic-ai/claude-code

如需卸载：npm uninstall -g @anthropic-ai/claude-code

七、额外实用技巧

安装 / 使用中遇到无法解决的问题：可将问题描述 + 截图发给 AI，或用豆包共享屏幕，可现场指导解决大部分问题。