English version: README.en.md
免责声明：本项目仅供学习和研究使用。 请勿将其用于你不拥有或未获授权分析的软件或服务。
这是一个针对 Claude Code 的二进制补丁，可在无需 claude.ai OAuth 认证的情况下启用 --channels 功能。
Claude Code 的 --channels 参数允许 MCP 服务器向当前会话推送实时消息，例如 Telegram 机器人插件可以把聊天消息直接转发给 Claude。不过，这个功能被三层检查所限制：
| 限制项 | 检查内容 | 为什么会阻止 |
|---|---|---|
| 功能开关 | 通过 GrowthBook 检查 tengu_harbor 和 tengu_harbor_permissions |
默认值为 false；当 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 时无法访问 |
| OAuth | accessToken 检查 |
需要登录 claude.ai，会阻止 API key 或第三方代理用户 |
| Allowlist | Channel allowlist ledger | 没有 GrowthBook 时，服务端批准列表为空 |
默认情况下，脚本会优先尝试整体改写 channel decision function：保留 MCP capability check，并直接让后续流程返回 register。如果无法安全定位该函数，再回退到原来的等长字节替换方案。
- Python 3.10+
- 该脚本适用于 Claude Code v2.1.80 及以上版本；已在 2.1.81 和 2.1.83 上于 Windows、Linux、macOS 测试
- 在 macOS 上，补丁写入后脚本会自动执行 ad-hoc
codesign；这一点在 Apple Silicon（arm64）上尤其重要，否则系统可能会因代码签名失效直接终止二进制 - 当前没有 Mac M 系列机器，Apple Silicon 相关路径尚未完成维护者本地真机测试
- 使用 稳定字符串锚点（属性名、返回值、字符串字面量），不依赖混淆后的变量名
- 自动检测官方安装方式对应的二进制（Native Install、Homebrew、WinGet）并全部打补丁
- 支持
2.1.85这类带点版本号的独立二进制文件名；对应备份会写成同目录下的2.1.85.bak - 如果你的安装路径是自定义的，使用
python patch.py --binary /path/to/claude - 如果未找到预期代码模式，补丁会拒绝执行
# 应用补丁（自动检测所有已安装的二进制）
python patch.py
# 只检查检测结果和将采用的补丁策略，不修改文件
python patch.py --check
# 对指定二进制路径应用补丁
python patch.py --binary /path/to/claude
# 强制使用整体 decision-function 补丁策略
python patch.py --strategy decision
# 强制使用 legacy 等长字节替换策略
python patch.py --strategy legacy
# 恢复原始状态
python patch.py revert修改 macOS 上的 Mach-O 二进制会使原有代码签名失效。当前版本的 patch.py 会在 Darwin 环境下统一执行 ad-hoc 重签名，不依赖运行脚本的 Python 进程架构；这可以覆盖 Apple Silicon 机器上通过 Rosetta 或 x86_64 Python 执行脚本的场景。
Apple Silicon（arm64）上对无效签名更敏感，因此这一步尤其重要。需要说明的是，当前仓库维护者没有 Mac M 系列机器，这条路径目前仍然缺少维护者本地真机回归验证。
如果你使用的是旧版脚本，或需要手动恢复签名，请执行：
codesign --remove-signature /path/to/claude
codesign -s - /path/to/claude打完补丁后，使用 channels 启动 Claude Code：
claude --channels plugin:telegram@claude-plugins-officialClaude Code 的二进制是一个 Node.js SEA（Single Executable Application），其中包含两份打包后的 JS 文件。脚本支持两种补丁策略，在 auto 模式下会优先选择语义更完整的方案：
脚本会定位 channel decision function，保留最前面的 claude/channel capability check，然后把函数体后半段改写成直接返回 register。这个策略更接近“保留协议层检查，去掉业务限制”的语义。
无论采用哪种补丁策略，脚本都会同步处理较新版本里的 Bun runtime fallback：把 // @bun @bytecode 标记改成 // @bun @source__，确保运行时使用已经修改过的源码副本；--check 输出中的 bun bytecode fallback 也会参与 clean / patched / mixed 状态判断。
如果你只想看脚本会采用哪种策略，而不实际写入文件，可以执行：
python patch.py --check如果无法安全定位 decision function，脚本会回退到原来的 6 处稳定代码模式替换，并在两份 bundle 副本上分别应用（总计 12 处修改）：
// 修改前
function waH() { return l$("tengu_harbor", !1) } // default = false
// 修改后
function waH() { return l$("tengu_harbor", !0) } // default = truel$ 函数会从 GrowthBook（Anthropic 的远程配置）读取功能开关。当设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 时，GrowthBook 无法访问，l$ 会返回默认值。把默认值从 false 改为 true 后，该功能就会被启用。
// 修改前
return l$("tengu_harbor_permissions", !1) // default = false
// 修改后
return l$("tengu_harbor_permissions", !0) // default = true较新的 Claude Code 构建还会读取 tengu_harbor_permissions。脚本会和 tengu_harbor 一起把它的默认值改为 true，避免只开启主 channels 开关、却遗漏权限相关分支。
// 修改前：位于 B6f() 的 channel 注册逻辑中
if (!SL()?.accessToken)
return { action: "skip", kind: "auth", ... };
// 修改后
if ( SL()?.accessToken) // 条件取反，不再进入 skip
return { action: "skip", kind: "auth", ... };SL()?.accessToken 读取 claude.ai 的 OAuth token。API key 用户没有这个 token，因此它会返回 undefined。移除 ! 后，条件变为 if(undefined)，结果为假，因此 skip 分支不会执行。
// 修改前
if (!D.dev && !KaH().some((L) => L.plugin === D.name && L.marketplace === D.marketplace))
return { action: "skip", kind: "allowlist", ... };
// 修改后
if (!D.dev && KaH().some(...)) // 取反：只有在 allowlist 上时才会 skip
return { action: "skip", kind: "allowlist", ... };移除 allowlist 查询前的 ! 后，判断条件被反转：现在只有插件已经在 allowlist 中时才会跳过，从而允许不在 allowlist 中的插件通过。
// 修改前
else if (!D.dev) return { action: "skip", kind: "allowlist", ... };
// 修改后
else if ( D.dev) return { action: "skip", kind: "allowlist", ... };对于生产插件，D.dev 为 undefined，因此 if( D.dev) 始终为假，skip 不会执行。
// 修改前
noAuth: !SL()?.accessToken // 没有 OAuth token 时为 true
// 修改后
noAuth: +SL()?.accessToken // +undefined -> NaN（假值），会被视为 not-noAuth二进制内部嵌入了两份 JS bundle（主线程和 worker）。每个补丁都会应用到两个偏移位置，以保持一致性。
| # | 锚点 | 字节修改 | 目的 |
|---|---|---|---|
| 1 | tengu_harbor",!1)} |
1 -> 0 |
功能开关默认值 |
| 2 | tengu_harbor_permissions",!1)} |
1 -> 0 |
权限功能开关默认值 |
| 3 | ?.accessToken)return{action:"skip",kind:"auth" |
! -> |
绕过 OAuth |
| 4 | .marketplace))return{action:"skip",kind:"allowlist" |
! -> |
绕过插件 allowlist |
| 5 | )return{action:"skip",kind:"allowlist",reason:\server` |
! -> |
绕过服务端 allowlist |
| 6 | noAuth:! |
! -> + |
UI 的 noAuth 状态 |
- 备份：修改前会将原始二进制保存为
*.bak - 模式匹配：动态定位目标，不依赖硬编码偏移，也不会静默损坏文件
- 原子写入：使用临时文件和
os.replace()，避免破坏正在运行的二进制 - 可恢复：
python patch.py revert可以随时恢复所有二进制
MIT