Claude Code 安装与使用完全指南

本文整合 Claude Code 命令行工具的完整安装、卸载、报错处理及常用管理操作，帮助你顺利安装并使用 Claude Code。

避免安装时出现警告，推荐使用2.2的方案。

---

一、安装 Claude Code

1.1 标准安装

通常建议全局安装，以便在终端任何位置直接使用 claude 命令：

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

注意：如果提示权限错误（EACCES），macOS/Linux 用户可能需要加 sudo：

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

1.2 国内网络安装（推荐）

由于该包体量较大（约 100+ MB），且托管在 npm 官方源，国内下载可能会很慢或超时。建议配置国内镜像源：

# 临时使用淘宝镜像安装
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

1.3 验证安装

安装完成后，可通过以下命令验证是否安装成功并登录：

claude --version
claude login

---

二、安装报错完整解析与解决方案

警告内容如下：

npm i -g @anthropic-ai/claude-code@latest                                                                
                                                                                                                        
added 2 packages in 13s                                                                                                 
npm warn install-scripts 1 package had install scripts blocked because they are not covered by allowScripts:            
npm warn install-scripts   @anthropic-ai/claude-code@2.1.209 (postinstall: node install.cjs)                            
npm warn install-scripts                                                                                                
npm warn install-scripts Run `npm install -g --allow-scripts=@anthropic-ai/claude-code` to allow these scripts once, or `npm config set allow-scripts=@anthropic-ai/claude-code --location=user` to allow them for all global installs.

2.1 警告含义

如果你执行 npm i -g @anthropic-ai/claude-code@latest 安装成功后看到类似 “added 2 packages” 的提示，不是安装失败，只是安全拦截提示：

claude-code 包里自带 postinstall 自动安装脚本，你当前 npm 全局配置默认禁止第三方包运行安装脚本，所以脚本没执行，这就会导致 CC Switch 识别为「未安装/not executable」。

简单说：文件装好了，但配套初始化脚本被拦截，程序无法正常调用。

2.2 方案一：一次性允许脚本（推荐，用完即失效）

直接执行这条命令重装，临时放行它的安装脚本：

npm install -g @anthropic-ai/claude-code@latest --allow-scripts=@anthropic-ai/claude-code

2.3 方案二：永久放行该包脚本（长期使用选这个）

步骤 1：先配置永久允许脚本

npm config set allow-scripts=@anthropic-ai/claude-code --location=user

步骤 2：重新安装

npm i -g @anthropic-ai/claude-code@latest

2.4 安装完成校验

安装结束后，新开终端执行验证是否可用：

claude --version

能输出版本号（如 2.1.209）就代表正常。回到 CC Switch 点「刷新」，Claude Code 的黄色警告就会消失。

2.5 补充说明

1. 为什么会出现这个拦截：npm 新版加强安全，默认阻止所有全局包自动运行脚本，防止恶意包篡改系统文件。
2. 官方包安全性：@anthropic-ai/claude-code 是官方包，脚本安全，可以放心放行。
3. 取消永久放行：如果你后续想取消永久放行，可执行：

npm config delete allow-scripts --location=user

---

三、卸载 Claude Code

如果你想完全移除该工具，执行全局卸载命令：

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

---

四、其他常用管理操作

操作	命令
更新到最新版	npm update -g @anthropic-ai/claude-code
查看是否已安装	npm list -g --depth=0 | grep claude-code
查看帮助信息	claude --help
登录账号	claude login
查看版本	claude --version

---

五、常见问题排查

如果在安装过程中遇到了具体的报错（比如 Node 版本不匹配或网络超时），可以参考以下方向排查：

• 权限错误：加上 sudo 重试（仅限 macOS/Linux）
• 网络超时：使用国内镜像源（见 1.2 节）
• 脚本被拦截：参考第二节的两种解决方案
• CC Switch 识别异常：执行 claude --version 验证，确认能输出版本号后刷新 CC Switch