claude-code/claude-zh/commands/setup-pm.md

description	disable-model-invocation
設定您偏好的套件管理器 (npm/pnpm/yarn/bun)	true

套件管理器設定 (Package Manager Setup)

為此專案或全域環境設定您偏好的套件管理器。

使用方式

# 偵測目前的套件管理器
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. 備選方案 (Fallback)：第一個可用的套件管理器 (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