包管理器配置

概述

为项目或全局配置首选的 Node.js 包管理器（npm/pnpm/yarn/bun），支持多层级检测优先级和灵活的配置方式。

使用方法

# 检测当前包管理器
node scripts/setup-package-manager.js --detect

# 设置全局偏好
node scripts/setup-package-manager.js --global pnpm

# 设置项目偏好
node scripts/setup-package-manager.js --project bun

# 列出可用的包管理器
node scripts/setup-package-manager.js --list

检测优先级

确定使用哪个包管理器时，按以下顺序检查：

1. 环境变量：CLAUDE_PACKAGE_MANAGER
2. 项目配置：.claude/package-manager.json
3. package.json：packageManager 字段
4. 锁文件（Lock File）：检测 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 的存在
5. 全局配置：~/.claude/package-manager.json
6. 兜底方案：第一个可用的包管理器（pnpm > bun > yarn > npm）

配置文件

全局配置

// ~/.claude/package-manager.json
{
  "packageManager": "pnpm"
}

项目配置

// .claude/package-manager.json
{
  "packageManager": "bun"
}

package.json 方式

{
  "packageManager": "pnpm@8.6.0"
}

环境变量

设置 CLAUDE_PACKAGE_MANAGER 可覆盖所有其他检测方式：

# Windows (PowerShell)
$env:CLAUDE_PACKAGE_MANAGER = "pnpm"

# macOS/Linux
export CLAUDE_PACKAGE_MANAGER=pnpm

运行检测

查看当前包管理器检测结果：

node scripts/setup-package-manager.js --detect