Claude Code安装过程记录

2026-03-31 22:16 已关闭评论

我的Claude Code安装与配置实战

今天我想和大家分享一下我安装和配置Claude Code的完整过程。Claude Code是Anthropic推出的一个命令行AI编程助手，能直接在终端里帮你写代码、调试、解释代码片段，非常方便。不过在开始之前，我们需要先准备好一些基础环境。

第一步：环境准备

首先，你得确保电脑上已经安装了三个必备工具：Git、Node.js和npm。Node.js是运行环境，npm是Node.js的包管理器，Claude Code就是通过npm来安装的。

在Windows上验证安装很简单，打开命令提示符（CMD）或PowerShell，分别输入以下命令：

node -v

和

npm -v

如果能看到版本号输出，比如v18.17.0和9.6.7，那就说明安装成功了。我个人的经验是，最好安装LTS（长期支持）版本，稳定性更有保障。

如果你习惯在Git Bash里操作，验证方法也类似：

node --version

npm --version

第二步：安装Claude Code

环境准备好了，我们就可以开始安装Claude Code了。这里有个小技巧，由于网络原因，直接使用npm官方源下载可能会很慢甚至失败。我强烈建议先切换到国内的镜像源，速度会快很多。

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

设置完后，可以验证一下是否生效：

npm config get registry

看到返回的是https://registry.npmmirror.com就对了。接下来，执行安装命令：

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

这里的-g参数表示全局安装，这样你才能在任意目录下使用claude命令。我在安装时遇到了一个小插曲，系统提示权限不足。这在Linux或Mac上很常见，Windows上如果你用的是管理员权限的终端可能不会遇到。解决方法是加上sudo（Linux/Mac）或以管理员身份运行，并添加--force参数：

sudo npm install -g @anthropic-ai/claude-code@latest --force

安装完成后，别忘了验证一下是否成功：

claude --version

如果输出了版本信息，比如claude-code/1.0.0，那么恭喜你，核心工具已经就位了！

第三步：配置模型（关键步骤）

安装好Claude Code只是第一步，它本身只是一个客户端，需要连接到AI模型才能工作。默认情况下，它可能没有可用的模型，或者你需要切换不同的模型（比如Claude 3.5 Sonnet, Haiku等）。这就需要用到另一个工具——CC Switch。

CC Switch是一个图形化工具，专门用来管理Claude Code的模型配置。你需要去GitHub releases页面下载它。

https://github.com/farion1231/cc-switch/releases/tag/v3.11.1

根据你的操作系统选择对应的安装包。我是Windows用户，所以下载了CC-Switch-v3.11.1-Windows.msi。不过我发现最新版有时会有兼容性问题，所以我实际安装的是稍早一点的v3.10.3版本（CC-Switch-v3.10.3-Windows.msi），用起来更稳定。Mac或Linux用户选择对应的dmg或AppImage文件即可。

安装并打开CC Switch后，你需要配置模型。这里就需要用到API Key了。你需要一个有效的Anthropic API Key，可以从Anthropic的官网获取。在CC Switch的配置界面，填入你的API Key，然后选择你想要使用的模型（例如claude-3-5-sonnet-20241022），保存配置。