/setup-pm

description: 配置你偏好的包管理器 (npm/pnpm/yarn/bun)
disable-model-invocation: true

包管理器设置 (Package Manager Setup)

为本项目或全局配置你偏好的包管理器。

用法 (Usage)

# 检测当前包管理器
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

检测优先级 (Detection Priority)

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

1. **环境变量 (Environment variable)**: `CLAUDE_PACKAGE_MANAGER` 2. **项目配置 (Project config)**: `.claude/package-manager.json` 3. **package.json**: `packageManager` 字段 4. **锁定文件 (Lock file)**: 是否存在 package-lock.json、yarn.lock、pnpm-lock.yaml 或 bun.lockb 5. **全局配置 (Global config)**: `~/.claude/package-manager.json` 6. **后备方案 (Fallback)**: 第一个可用的包管理器 (pnpm > bun > yarn > npm)

配置文件 (Configuration Files)

全局配置

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

项目配置

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

package.json

{
  "packageManager": "pnpm@8.6.0"
}

环境变量 (Environment Variable)

设置 `CLAUDE_PACKAGE_MANAGER` 以覆盖所有其他检测方法：

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

# macOS/Linux
export CLAUDE_PACKAGE_MANAGER=pnpm

运行检测 (Run the Detection)

若要查看当前的包管理器检测结果，请运行：

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