Files

T

0chencc 2cfa74e7c0 feat: native binary support for v2.1.113+ Claude Code

Anthropic stopped shipping cli.js in the npm package starting v2.1.113;
the package became a thin loader that dispatches to a per-platform Bun
standalone binary. The previous installer cp'd cli.js from the npm
tarball, which is why every install on v2.1.113+ fails with ENOENT.

This release rewrites the install pipeline to extract cli.js source
directly from the user's locally-installed Bun standalone binary
(__BUN segment, anchored on the file:///$bunfs/.../cli.js path),
rewrites virtual /$bunfs paths to local vendor/, runs cli.js under Bun
runtime instead of Node, and reapplies the existing 23 regex patches.

Highlights

- Extract cli.js from Mach-O / ELF / PE __BUN segment (the same source
  Bun bundled at build time — not stale, not injected).
- Auto-install Bun runtime; require ripgrep up front (Bun's bundled rg
  is unreachable when running extracted cli.js outside the standalone
  bundle, so we depend on system rg).
- Wrapper now stamps the source version and detects drift on every
  launch. When the user upgrades Claude Code, ClawGod transparently
  re-extracts and re-patches before invoking the user's command.
- Patcher made resilient: regex tokens widened to [\\w$]+ for Bun's
  newer minified identifiers; updated message-list filter and
  auto-mode patches for v2.1.119 source shape; sentinel-based
  verification catches future silent regex misses.
- New `clawgod` command alongside `claude` — unambiguous entry point
  that survives Windows .exe / .cmd shadowing and official
  self-update overwriting `claude`.
- Critical fix: launcher write no longer follows symlinks. Previously
  `echo > $CLAUDE_BIN` clobbered the real binary when $CLAUDE_BIN was
  the official symlink to ~/.local/share/claude/versions/<v>; we now
  rm the entry first.
- Default features.json adds tengu_prompt_cache_1h_config allowlist
  so 1h prompt cache actually engages (fixes silent 5m TTL fallback
  that drove cache_creation token waste).

Verified: macOS arm64 against v2.1.117/2.1.118/2.1.119 native binaries;
23 patches applied with 0 failures; auto-repatch correctly handles
version transitions; claude / clawgod / claude.orig coexist cleanly.

Closes #40
Closes #41
Closes #42
Closes #43
Closes #45

2026-04-27 15:14:44 +09:00

6.0 KiB

Raw Blame History

ClawGod

English | 中文 | 日本語

Claude Code 上帝模式。

这不是第三方 Claude Code 客户端。 ClawGod 是作用在官方 Claude Code 之上的运行时补丁。它兼容任何版本——当 Claude Code 升级，ClawGod 会在下次启动时自动从新版本重新抽取并重新打补丁。

前置依赖

运行 ClawGod 安装脚本之前先装好：

工具	用途	安装
Claude Code（原生二进制）	ClawGod 是基于你已装的官方 Bun standalone 二进制做 patch	`claude.ai/install.sh`（macOS/Linux）或 `claude.ai/install.ps1`（Windows）
ripgrep	Claude Code 内置 Grep tool 必需	`brew install ripgrep` / `apt install ripgrep` / `winget install BurntSushi.ripgrep.MSVC`
Node.js >= 18	patcher 使用	nodejs.org

Bun 是运行 patched cli.js 的 runtime——installer 检测不到时会自动安装。

安装

macOS / Linux:

curl -fsSL https://github.com/0Chencc/clawgod/releases/latest/download/install.sh | bash

Windows (PowerShell):

irm https://github.com/0Chencc/clawgod/releases/latest/download/install.ps1 | iex

绿色 Logo = 已 Patch。橙色 Logo = 原版。

功能一览

功能解锁

补丁	效果
内部用户模式	24+ 隐藏命令（`/share`、`/teleport`、`/issue`、`/bughunter`...），调试日志，API 请求记录
GrowthBook 覆盖	通过配置文件覆盖任意 Feature Flag
Agent Teams	多智能体协作，无需额外参数
Computer Use	无需 Max/Pro 订阅即可使用屏幕控制（macOS）
Auto-mode	解锁第三方 API 用户的 auto-mode（移除 firstParty 限制）
Ultraplan	通过 Claude Code Remote 进行多智能体规划
Ultrareview	通过 Claude Code Remote 自动化 Bug 查找

限制移除

补丁	移除内容
CYBER_RISK_INSTRUCTION	安全测试拒绝提示（渗透测试、C2 框架、漏洞利用）
URL 限制	"禁止生成或猜测 URL" 指令
操作审慎	破坏性操作前的强制确认
登录提示	启动时的"未登录"提醒

视觉

补丁	效果
绿色主题	品牌色 → 绿色，一眼辨别是否已 Patch
消息过滤	显示对非 Anthropic 用户隐藏的内容

可靠性

功能	作用
1h Prompt Cache	强制启用 1h TTL allowlist（默认实际是 5m → 空闲后导致大量 cache_creation token 浪费）
自动重打补丁	检测到用户官方升级了 native Claude binary 时，下次启动自动重新抽取 + 重新 patch

使用

claude              # 已 Patch 的 Claude Code（替换官方 launcher）
clawgod             # 同 `claude`，显式且永远生效的入口
claude.orig         # 原版未修改版本（自动备份）

clawgod 是一个无歧义的入口：Windows 上即便 claude.exe 抢占了 claude.cmd，clawgod.cmd 始终生效；即便官方自动更新覆盖了 claude，clawgod 仍跑 patched 版本。

配置

首次启动会自动生成 ~/.clawgod/provider.json。填入 apiKey 即可跳过 OAuth 登录，对接任何 Anthropic 协议端点。

{
  "apiKey": "sk-ant-...",
  "baseURL": "https://api.anthropic.com",
  "model": "",
  "smallModel": "",
  "timeoutMs": 3000000
}

填写 apiKey：ClawGod 注入 ANTHROPIC_API_KEY 并与 ~/.claude/settings.json 隔离。可用于 Anthropic 官方、DeepSeek，以及任何 OpenAI-compatible 网关；baseURL 指向非 Anthropic 域名时，还会自动注入 ANTHROPIC_AUTH_TOKEN 以适配网关鉴权。
留空 apiKey：走 OAuth 路径，执行一次 claude auth login，~/.claude 下的 subagents / skills / MCP 配置继续有效。

工作原理

从 @anthropic-ai/claude-code v2.1.113 起，npm 包不再带 cli.js——它只是个 thin loader 转发到平台特定的 Bun standalone 二进制。ClawGod 这样适配：

在 ~/.local/share/claude/versions/ 定位用户已装的 Bun native binary
从 __BUN segment（Mach-O / ELF / PE）抽出嵌入的 cli.js 源码
抽出嵌入的 .node 原生模块（audio-capture、image-processor、computer-use-*、url-handler）放到 ~/.clawgod/vendor/
把 /$bunfs/... 虚拟路径重写到本地 vendor 路径
应用 23 条正则 patch（跨版本兼容，同一组 regex 覆盖多个 release）
claude / clawgod launcher 在 Bun runtime 下跑 patched cli.js

~/.clawgod/.source-version 标记当时被 patch 的版本号。每次启动 wrapper 比对它和 versions/ 里最新二进制；如果用户走官方途径升级了 Claude Code，下次启动会自动重打补丁。

更新

installer 是幂等的——再跑一次即可刷新 patched 副本：

macOS / Linux:

curl -fsSL https://github.com/0Chencc/clawgod/releases/latest/download/install.sh | bash

Windows:

irm https://github.com/0Chencc/clawgod/releases/latest/download/install.ps1 | iex

通常不需要手动重跑——Claude Code 自动更新后，ClawGod 的自动重打补丁会在下次 claude / clawgod 启动时自动处理。

卸载

macOS / Linux:

curl -fsSL https://github.com/0Chencc/clawgod/releases/latest/download/install.sh | bash -s -- --uninstall
hash -r  # 刷新 shell 缓存

Windows:

irm https://github.com/0Chencc/clawgod/releases/latest/download/install.ps1 -OutFile install.ps1; .\install.ps1 -Uninstall

卸载会把 claude.orig 还原成 claude，并移除 clawgod 别名。

安装或卸载后，如果命令未立即生效，请重启终端或执行 hash -r。

许可证

GPL-3.0 — 与 Anthropic 无关，风险自负。

6.0 KiB Raw Blame History Unescape Escape

ClawGod

前置依赖

安装

功能一览

功能解锁

限制移除

视觉

可靠性

使用

配置

工作原理

更新

卸载

许可证

6.0 KiB

Raw Blame History