安装 Claude Code ​

推荐使用 npm 并配合 淘宝镜像 提升国内下载速度：

# 1. 配置 npm 使用淘宝镜像（可选，若已有其他镜像可跳过）
npm config set registry https://registry.npmmirror.com

# 2. 全局安装 Claude Code（指定可用版本 2.1.112，防止自动升级到不可用的 2.1.114）
npm install -g @anthropic-ai/claude-code@2.1.112

# 3. 成功后
claude --version

提示：如果你使用的是 yarn 或 pnpm，同样可以加 @2.1.112 锁定版本。

首次运行 & 初始化 ​

安装完成后，直接运行 claude 命令 会触发首次初始化，此时会在用户目录下生成配置文件（如 .claude.json）：

claude

• 如果此时查看用户目录（~/.claude/）仍然看不到 .claude.json，说明你还未执行过 claude 命令，初始化尚未发生。
• 执行一次 claude（可以直接回车退出）后，再次检查目录，就会看到初始生成的配置文件。

配置文件说明 ​

初始化后，主要的配置文件位于 ~/.claude/settings.json（或 .claude.json，取决于版本）。我们需要在此文件中：

1. 锁定 Claude 版本为 2.1.112，防止自动升级到 2.1.114（该版本由于 npm 兼容性问题导致部分功能不可用）。
2. 禁止自动更新，避免npm在后台悄悄把版本提升到不可用的版本。
3. 添加 OpenRouter 配置，使用免费模型 nvidia/nemotron-3-super-120b-a12b:free 进行初步测试。

示例 .claude.json ​

{
  "env": {
    "DISABLE_AUTOUPDATER": "1",
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "你的-OpenRouter-API-Key",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "nvidia/nemotron-3-super-120b-a12b:free",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "nvidia/nemotron-3-super-120b-a12b:free",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "nvidia/nemotron-3-super-120b-a12b:free"
  }
}

• DISABLE_AUTOUPDATER：阻止 Claude Code 自行检查并升级 npm 包。
• openrouter：配置 OpenRouter 服务的 API Key、模型名称以及基础 URL（若你已有其他提供商可自行替换）。

注意：填入你在 OpenRouter 注册后获得的 API Key。免费额度通常足够进行初步对话测试。

验证安装与配置 ​

完成以上步骤后，再次运行 Claude Code 并输入 /status 命令，检查当前状态：

claude
> /status

你应该会看到类似下面的输出（版号为 2.1.112，模型显示为你在 OpenRouter 配置的免费模型）：

这篇文章就是让 claude code 写的，我在基础上随便改了改，一次聊天一分钟以上，免费的就是慢啊。