这份指南专为国内用户设计，解决了安装 Claude Code 时常见的网络和配置难题。通过清晰的前置准备、镜像源切换和模型配置步骤，帮助用户避开繁琐的报错，顺利在国内网络环境下使用这款强大的AI编程工具，显著提升开发效率。
智能速览
安装前需准备Git和Node.js环境。
使用国内镜像源是安装成功的关键。
通过CC Switch工具可便捷配置不同模型API。
常见的权限问题需用管理员指令解决。
遇到问题可借助其他AI工具进行排查。
精华内容
在国内安装Claude Code确实会遇到不少阻碍，但只要掌握了正确的方法，整个过程可以变得十分顺畅。下面将拆解关键步骤，助你避开所有坑。
环境准备
安装Claude Code前，必须先准备好基础环境。Windows用户需自行下载安装Git，而Mac系统则自带。安装后，在PowerShell、CMD或Git Bash中输入`git --version`，若能显示版本号即代表成功。
随后，需安装Node.js及其包管理器NPM。访问官网下载适配操作系统的安装包并完成安装。同样，在命令行输入`node -v`和`npm -v`，两条指令均能正确输出版本号，才算完成了所有前置准备工作。
核心安装
由于网络限制，直接从NPM官方源下载Claude Code通常会很慢或失败。因此，切换到国内镜像源是安装成功的关键第一步。在命令行中执行`npm config set registry https://registry.npmmirror.com`即可完成切换。
随后，执行安装指令`npm install -g @anthropic-ai/claude-code`。若系统提示权限不足，则需要使用管理员权限强制覆盖安装，命令为`sudo npm install -g @anthropic-ai/claude-code --force`（Mac/Linux）或以管理员身份运行命令行（Windows）。安装完成后，输入`claude --version`验证。
模型配置
要让Claude Code工作，必须为其配置模型供应商的API。这需要一个叫作“CC Switch”的辅助工具。下载并安装CC Switch后，打开软件，在Claude标签页点击右上角的加号添加供应商。
配置时，API Key和请求地址是必填项，这些信息可以在模型供应商平台的API文档中找到。模型名称也建议填写，否则可能出现无法识别的情况。确保填写的模型名称与供应商支持的完全一致，配置完成后选择并启用该供应商即可。
启动与排查
配置完成后，在命令行输入`claude`并回车，即可启动Claude Code。启动后，输入`/model`指令并回车，会弹出模型列表，用键盘上下箭头选择CC Switch中启用的模型即可开始对话。
若切换模型后出现“找不到模型”的提示，可按以下步骤排查：首先，退出Claude Code并重新启动。如果问题依旧，请核查CC Switch中的API Key、请求地址和模型名称是否填写无误，并确认模型供应商账户中有充足的可用余额。
进阶技巧
Claude Code的指令可分为三类：启动类（在终端执行，如重启、查看历史）、对话类（在Claude Code内执行，如/help查看所有指令）和安装卸载类。
此外，一个非常实用的技巧是，当安装或使用中遇到任何无法解决的问题时，可以直接将问题描述和截图发给另一个AI助手（如豆包），甚至可以共享屏幕让其远程指导，通常能快速定位并解决大部分疑难杂症。
掌握了这套流程，在国内流畅使用Claude Code已不再是难事。它不仅是一个编程助手，更是一个能融入多种工作流的强大工具。你准备好用它来激发自己的创作和工作潜力了吗？
关键评论
教程非常详细，是目前看过最适合小白的。
使用CC Switch而不是直接改配置是出于什么考虑？
安装的这个是命令行版本还是新出的IDE版本？
能不能直接提供文字版的教程，复制代码太头疼了。
