用npm安装并配置Claude code

  本文针对国内开发者使用 npm 安装 Claude Code 时遇到的网络问题导致安装失败或速度极慢。推荐选择无需FQ的淘宝镜像源。

安装node.js

  在开始安装Claude Code命令行工具之前，确保你的开发环境已经准备就绪，这是避免后续各种奇怪问题的关键。我见过太多开发者因为环境配置不当，在安装过程中浪费了大量时间排查错误。

  Claude Code基于Node.js开发，因此Node.js环境是必须的。如果没有安装node js ，请问问AI如何安装。在命令行界面（CLI）输入 node --version，如果显示版本号（如下述代码所示的、我安装的v24.14.0），说明安装成功！

wienerMacBook-Pro ~ % node -v
v24.14.0

安装Claude Code

  在国内，推荐使用 npm 镜像源（https://registry.npmmirror.com）进行安装，可以显著提升包安装速度，避免网络超时。mac 系统基于管理员权限使用如下脚本安装：

wiener-Pro workspace % sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
Password:

added 3 packages in 44s

2 packages are looking for funding
  run `npm fund` for details
wiener-Pro workspace % claude -v
2.1.77 (Claude Code)

  上述命令使用国内镜像源，解决安装很慢或者卡住问题，因为直接以管理员权限设置，故安装时需要录入开机密码。安装完成后，如果执行命令 claude -v 时像我这样拿到了版本号2.1.77，说明安装成功!

进入项目文件夹启动程序

  从终端进入项目所在的目录之后，运行以下命令启动 Claude Code：

cd ~/your-project
// 在工程目录通过claude启动终端命令行
claude

  启动界面会输出当前版本号、使用的model等。

升级

  和首次安装Claude code一样，本次也需以管理员身份在终端执行命令。要升级 Claude Code 到最新版本，只需运行相同的安装命令：

sudo npm install -g @anthropic-ai/claude-code -registry=https://registry.npmmirror.com

  楼兰胡杨建议您定期升级，以确保获得最新功能、性能改进和错误修复。

卸载Claude code

@anthropic-ai/claude-code 是 Anthropic 官方推出的命令行编程助手（CLI），用于在终端中与 Claude 协作编写和运行代码。如果想卸载它，用以下命令即可安全移除：

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

sudo 表示以管理员身份卸载，避免因没有权限导致无法删除。卸载过程中，请根据提示录入一次开机密码。

修改配置

  在 Mac 终端中，依次运行以下命令，创建配置文件夹和文件

# 创建配置文件：在终端中，依次运行以下命令，创建配置文件夹和文件
# 1. 创建 .claude 配置文件夹
mkdir -p ~/.claude

# 2. 进入该文件夹并创建 settings.json 文件
cd ~/.claude
touch settings.json

  编辑配置文件。我们需要用文本编辑器来修改 settings.json 文件，可以使用任何文本编辑器，下面以vim为例进行演示：

1. vim .claude/settings.json
2. 添加以下配置
 {
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-token-here",
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn"
  },
  "model": "claude-sonnet-4-6"
}

3. 查看配置内容确认是否正确
cat .claude/settings.json

  请提前获取ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。如果不知道怎么获取，问问deepseek。

跳过官方登录引导

众所周知，Claude 对 中国大陆用户非常不友好：不仅账号极其容易被封 而且claude的API 价格很贵因此很多开发者会选择 跳过官方登录，直接接入第三方更具性价比模型的API。

跳过登录验证需要在配置文件 ~/.claude.json 中修改，它是用户级全局配置，适用场景：个人跨项目复用的 MCP（比如 GitHub、个人数据库等）。进入上述用户文件，加入一行"hasCompletedOnboarding": true,即可跳过 Claude Code 的官方登录引导，即不需要登录 Claude 账号了，直接接入第三方更具性价比模型的API。

结束语

  后续再介绍 MCP 和 agent skills等。 楼兰胡杨非常赞同知行合一：学习完一个知识点要尽量及时实践，这样才能记得牢靠。

  希望这篇指南能帮大家避开我之前踩过的坑，顺利在国内环境下使用 Claude Code！如果有其它问题，欢迎在评论区交流～