多智能体编排 · 收录于 2026-08-29 · 适用 1 工具 ✓ 实测验证

Claude Code 本体环境类报错(OOM / Homebrew 冲突 / PowerShell 执行策略)

已验证 2026-08-29Claude Code 本体环境报错——WSL/Linux 走 npm 路径装 CLI 避免 brew 双写;Windows PowerShell 先放开执行策略 RemoteSigned。

快速修复

# 一键:WSL/Linux 走 npm 路径装 CLI(避免 brew 双写)
npm i -g oh-my-claude-sisyphus --registry=https://registry.npmmirror.com

Windows PowerShell 先放开执行策略:Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

你会遇到什么

安装 OMC 过程中 Claude Code 本体出问题:OOM Killed、Homebrew 与 npm 冲突、Windows 提示"禁止运行脚本"。你会以为 OMC 装坏了——其实不是 OMC 的问题,是 Claude Code 安装环境的常见坑。

本文路径:快速修复(30 秒一段命令)→ 一步步排查(可跳读)→ 原理与变体(症状/原因/证据)。赶时间直接跳到「快速修复」。

为什么会这样

报错根因
OOM Killed内存不足(/omc-setup 依赖 Claude Code 本体)
Homebrew 冲突brew 与 npm 双写冲突
禁止运行脚本PowerShell 默认执行策略

这一条的关键认知是问题分层:OMC 是 Claude Code 之上的封装层,/omc-setup 这类流程最终要调用 Claude Code 本体和系统包管理器——报错发生在哪一层,根因就在哪一层。

三个报错分别对应三个不同的层:OOM Killed 是资源层(内存不足,任何进程都可能被杀,跟 OMC 无关);Homebrew 冲突是包管理层(brew 和 npm 都写 bin 链接和全局包目录,双写同一位置互相覆盖);“禁止运行脚本”是策略层(PowerShell 默认只允许签名脚本,未签名的 .ps1 一律拒绝执行)。

判断方法固定:先看报错发生在哪个环节(OMC 自己的命令 vs Claude Code 本体 vs 系统工具),再按层找根因。

这也解释了为什么 WSL 实测无此问题——Linux 没有 PowerShell 执行策略这一层。

一步步来

1. OOM:加大内存/关闭多余进程 — 必做

/omc-setup 依赖 Claude Code 本体,内存不足就关多余进程或加内存后重试。

2. Homebrew 冲突:统一 npm 路径 — 必做

统一用 npm 路径装 CLI(本市场路径 B),避免 brew 与 npm 双写:

npm i -g oh-my-claude-sisyphus

3. PowerShell:放开执行策略 — 必做

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

(按需)后再跑脚本。

怎么确认修好了

安装与命令面正常(实测形态):

npm i -g oh-my-claude-sisyphus → 安装完成
omc --version → 5.0.0(WSL npm CLI 形态实测无此问题)

其它环境的表现

环境说明
OOM加内存/关进程(CSDN 2026-03)
Homebrew 冲突统一 npm 路径
PowerShellRemoteSigned 放开执行策略
WSL实测无此问题(闭环日志)

症状

安装 OMC 过程中 Claude Code 本体出问题:OOM Killed、Homebrew 与 npm 冲突、Windows 提示"禁止运行脚本"。

原因

不是 OMC 自身问题,是 Claude Code 安装环境的常见坑(内存不足、包管理器冲突、PowerShell 默认执行策略)。

解法

  1. OOM:加大内存/关闭多余进程后重试(/omc-setup 依赖 Claude Code 本体)。
  2. Homebrew 冲突:统一用 npm 路径装 CLI(本市场路径 B),避免 brew 与 npm 双写。
  3. PowerShell:Set-ExecutionPolicy -Scope CurrentUser RemoteSigned(按需)后再跑脚本。
验证证据
  • 网页案例:CSDN(Claude Code 安装找不到命令/代理配置:OOM Killed/Homebrew 冲突;PowerShell 禁止运行脚本,2026-03;均为 Claude Code 本体弱相关)。
  • 本市场实测:WSL 环境 npm CLI 形态无此问题(闭环日志)。

适用工具 (1)

本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。

oh-my-claudecode

来源与证据

收录 验证 ✓ 实测验证适用 1 工具
方案含本地实测或来源可复核的解法;未实测项已在文中如实标注。

← 多智能体编排 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡