Skip to content

[PR] docs(claude): disclose that bili routing disables account-bound features like Remote Control (#4693) - #4709

Closed
ranxianglei wants to merge 7 commits into
masterfrom
2026-10-25_claude-remote-control-disclosure
Closed

ranxianglei wants to merge 7 commits into
masterfrom
2026-10-25_claude-remote-control-disclosure

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

Refs #4693

What & why

bili plugin install claude routes Claude Code model traffic through a local proxy by setting a custom ANTHROPIC_BASE_URL. Claude Code treats any non-default base URL as third-party/API-key mode and hides features bound to your Anthropic account/Cloud — notably Remote Control (/remote-control, driving a local session from mobile/desktop/web) disappears from the command list while bili routes traffic. Removing bili restores the default base URL and the command returns (the reporter's exact A/B).

This is inherent to the base-URL routing seam: CC's undici stack ignores HTTPS_PROXY/MITM (#2290, field-tested) and there is no in-process extension point, so compression and Remote Control cannot coexist on the same claude session today. Nothing in settings.json is deleted — applyClaudeManagedBlock clones the file and touches only env.ANTHROPIC_BASE_URL / DISABLE_AUTO_COMPACT / VERTEX_BASE_URL + hooks.SessionStart.

This PR makes that tradeoff explicit instead of leaving it a surprise:

  1. README claude bullet (en + zh): a new "Account-bound features (Installing billion-context removes '/remote-control' command from claude-code #4693)" note explaining the mechanism, that compression is unaffected, and the plain-claude workaround.
  2. bili plugin install claude success message: one appended sentence surfacing the same note at install time (with the Installing billion-context removes '/remote-control' command from claude-code #4693 ref).

Behavior change disclosure

  • The claude install success message gains one trailing sentence (old → new: it ended at …restart claude to activate; it now appends . Note: routing claude through bili sets a custom ANTHROPIC_BASE_URL, which disables account-bound features (e.g. Remote Control /remote-control) while the proxy routes traffic — run plain claude without bili for sessions that need them (#4693)). Purely additive text; no logic/wire/default/semantics change.
  • Two README lines gain one sentence each (en/zh kept in sync).

No config surface added. No change under kernel/, src/update.ts, wire/message shape, or identity/session binding.

Verification

  • Targeted local: tests/claude-native.test.ts + tests/claude-mcp-entry.test.ts → 78 pass / 0 fail / 8 gated skips; npm run typecheck clean. Full-suite verdict = remote CI on this head.
  • Existing assertions on the install string are substring/regex matches with all preserved substrings intact, so the appended text cannot break them.

Does not close #4693 (owner decides); this documents the limitation + workaround rather than changing routing behavior.

@ranxianglei ranxianglei changed the title docs(claude): disclose that bili routing disables account-bound features like Remote Control (#4693) [PR] docs(claude): disclose that bili routing disables account-bound features like Remote Control (#4693) Oct 25, 2026
…res (Remote Control) (#4693)

Routing claude through bili sets a custom ANTHROPIC_BASE_URL, which puts Claude Code in third-party/API-key mode and hides account/cloud-bound features such as Remote Control (/remote-control). Document this inherent base-URL-routing tradeoff in the README claude bullet (en+zh) and surface it once in the 'bili plugin install claude' success message, with the plain-claude workaround. No logic/wire/default change; no auto-close of #4693 (owner decides).
@ranxianglei
ranxianglei force-pushed the 2026-10-25_claude-remote-control-disclosure branch from 944f50d to 133458d Compare October 25, 2026 13:32
@github-actions

github-actions Bot commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

📦 Built Package Artifact

Branch: 2026-10-25_claude-remote-control-disclosure (53eae17)

Latest build — install this exact version

npm install -g billion-context@0.0.6153-pr.4709.c2b6d2c

This exact version is immutable and reproducible. The rolling pr tag tracks the newest test build across all PRs.

Recent builds (commit → version)

commit version build
53eae17 billion-context@0.0.6153-pr.4709.c2b6d2c build
400b234 billion-context@0.0.6068-pr.4709.ac8d73d build
171675c billion-context@0.0.5966-pr.4709.be9f869 build
47dab30 billion-context@0.0.5892-pr.4709.3db509b build
06d377f billion-context@0.0.5824-pr.4709.6b79768 build
2c057aa billion-context@0.0.5743-pr.4709.c0b021f build
133458d billion-context@0.0.5740-pr.4709.990a374 build

Download artifact

  1. Download the artifact from the Actions run
  2. Extract the tarball and install:
tar xzf billion-context-pr4709.tgz
npm install -g package

Install instructions are refreshed on each push.

@ranxianglei
ranxianglei force-pushed the 2026-10-25_claude-remote-control-disclosure branch from 133458d to 2c057aa Compare October 25, 2026 13:36
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

冲突已解决,rebase 完成并已推回本 PR 分支(2026-10-25_claude-remote-control-disclosure,新 head 2c057aa44,原 base 落后 master 526 个提交)。CI 会自动重跑。

八问:

  1. 是什么问题:PR 分支与 master 冲突——master 在此期间重写了 README(中/英)claude 条目里"真机验证"那段(补了 CC 2.1.301+ 起 CLI 遵守 HTTPS_PROXY、launcher 不再设代理/CA 的说明,[Bug] bili claude: Claude Code 2.1.301 honours HTTPS_PROXY, so the /bili/ base URL self-tunnels (403 tunnel_destination_denied: self) #3446),而本 PR 在同一段落里插入"账号绑定功能(Installing billion-context removes '/remote-control' command from claude-code #4693)"披露句,两边动了同一段文字。
  2. 什么原因导致的:PR 基于旧 master 开出,期间 master 在该文件同一位置落了新内容,纯文本相邻编辑冲突,无设计分歧。
  3. 影响范围与严重程度:仅文档两行 + src/plugin-install.ts 一条安装提示字符串;不影响任何运行行为,只阻塞 PR 合并。
  4. 怎么修复的:rebase 到当前 master(ac844facd)后按「意图并集」解冲突——完整保留 master 的 [Bug] bili claude: Claude Code 2.1.301 honours HTTPS_PROXY, so the /bili/ base URL self-tunnels (403 tunnel_destination_denied: self) #3446 新表述,把本 PR 的披露句插回其原位置(英文版在 "Desktop-only users can restore native auto-compact…" 之前,中文版在 "仅用桌面的用户可用…" 之前);plugin-install.ts 自动合并成功,已核对第 949 行字符串完整。
  5. 是否有回归问题:无。rebase 后对 master 的最终 diff 恰好 3 个文件 × 1 行,与原 PR 提交内容逐字一致;typecheck 通过;定向测试 tests/claude-native.test.ts + tests/claude-mcp-entry.test.ts = 78 过 / 0 败 / 8 跳过(live e2e 门控)。全量回归以 CI 为准。
  6. 是否破坏缓存:不涉及——纯文档与一条用户可见文案,未触碰任何缓存/存储逻辑。
  7. 是否改了设计方向:不涉及。
  8. 是否引入了新的配置:不涉及。

判定:冲突干净收敛,语义零漂移,等 CI 绿即可由人工合并。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重: 不重复。本 PR(#4709)是 #4693(claude 装完 bili 后 /remote-control 消失)的配套披露 PR——open/closed 里按同一处(README claude 段 + claude install 文案)检索过,没有第二个改同一段的同类 PR;它正确引用 #4693 且不自动关闭它。

标签: claude-code scope/docs p3(纯文档/披露类改动,零运行时行为变化;底层缺陷 #4693 已挂 bug/p2)。

先说结论:方向对、改动干净,CI 绿即可合。 审核时发现一个阻塞项并已当场修掉:PR 是在 master 落 #3446 之前拉出来的,而 master 后来改了同一行 claude bullet(#3446 补了「CC 2.1.301+ 会遵守 HTTPS_PROXY」的说法),于是 PR 处于 dirty 冲突态、CI 被卡。我已把它 rebase 到当前 master(ac844facd)并按「并集」解冲突——保留 master 的 #3446 措辞、追加本 PR 的 Account-bound 句,两边内容都逐一验证在位(EN/ZH 各含 #3446 与 #4693 两句),已推回(944f50d7a → 133458d4d)。现在 mergeable=true;CI 在新 head 上跑,e2e/native 车道已绿(PR Build Artifact / codex overlay / e2e-native-pi / e2e-local-registry / e2e-pi-codex-ws),主 test 分片在跑,全量以远程 CI 为准。

独立审核(自己重读 diff 与代码路径,未照抄 issue 结论):

  • 机制核对:bili 的 claude native lane 确实把 env.ANTHROPIC_BASE_URL 钉到本地 loopback(src/launcher.ts:5914、src/claude-native-bootstrap.ts),所以「设自定义 base URL → CC 切第三方/API-key 模式 → 隐藏账号绑定功能」这条因果链成立;CC 侧没有能绕过其 undici 栈的拦截点(Claude Desktop (Code tab) overrides ANTHROPIC_BASE_URL: claude native lane never sees traffic, and auto-compact is left disabled #2290 实测),压缩与 Remote Control 目前确实不能兼得。披露而非硬修 = 对症,不是遮丑,符合「疏不堵」。
  • 回归清点:vs 重 base 后 diff 恰好 3 文件 3 行。README en/zh 各加一句、install 成功文案末尾加一句,纯新增文本,不碰合并/删除逻辑、wire、默认值、identity/session binding。现有对 install 串的断言全是 .includes() 子串匹配(tests/claude-native.test.ts:918),保留子串未动 → 追加文本不可能破坏它们。
  • 测试有效性:纯文档改动,无新行为可测,不需新增测试;已有子串断言足以兜住 install 文案不被意外截断。本地未跑全量(遵守共享资源纪律),全量交远程 CI。

结构化八问:

  1. 是什么问题:装了 bili 的 claude 车道后,CC 的 /remote-control 等账号绑定命令消失;本 PR 把这个固有取舍写进文档和安装提示,而不是让它继续当惊喜。
  2. 什么原因导致的:bili 压缩必须把 claude 流量改道到本地代理(设自定义 ANTHROPIC_BASE_URL);CC 见非默认 base URL 即进第三方/API-key 模式并隐藏账号绑定功能。根因在「改 base URL」这一步的路由缝隙,不是配置被删。
  3. 影响范围与严重程度:所有用 bili 压缩 claude 的用户在该客户端失去 Remote Control(同类账号绑定功能亦然);压缩本身不受影响。就本 PR 而言纯文档、零运行时影响 → p3。
  4. 怎么修复的:显式化取舍——README(en/zh)+ install 提示各加一句,讲清机制与绕行(用原生 claude,或 bili plugin remove claude)。
  5. 是否有回归问题:无。纯新增文本;install 串断言为子串匹配且保留子串完整;diff 恰好 3 文件 3 行。高危模式(语义漂移 / fail-fast 变吞错 / 阈值·时序·输出格式漂移)逐项不涉及。
  6. 是否破坏缓存:不涉及。
  7. 是否改了设计方向:不涉及。
  8. 是否引入新配置:不涉及(无新 env/config/默认值)。

判定:可合(CI 绿即合)。合并权在你,我不代合:#4709 。#4693 关不关由你定,本 PR 不动它的状态。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

CI 状态更正(跟进上一条)

上一条我说「主 test 分片在跑」——现在更正:这批 test (...) 分片实际是被 cancel,不是 failed。原因是当前 master 侧的瞬时 churn:短时间内 master 连续推多笔、且 master 自己的 CI 运行也在被 cancel(cancel-in-progress 风暴)。这不是本 PR 代码的问题,佐证:

分支状态:我已把分支从旧 base rebase 到最新 master,清掉了与 master #3446 在同一 claude bullet 行的内容冲突(两处 README 取并集保留双方,plugin-install.ts 逐字节同原)。当前分支 mergeable: true、无冲突(相对最新 master 是 behind,但 master 未再动这几行,不构成合并障碍)。分支随后被并行推进到含同样披露的版本(2c057aa44),内容与本 PR 一致——为避免互相覆盖,我停止继续 push。

结论:PR 已可合并,等 master churn 平息后拿到一次干净的 CI 全绿即可合入;无需我再做代码动作,由你手动 merge。#4693 是否关闭仍归你决定。

ci-check added 6 commits October 26, 2026 01:34
master window commits 293ae65/de5e03659 bumped kernel/package.json to
0.0.165 without regenerating the lockfiles; lock-sync re-resolution then
rewrites the stale recorded versions (root 0.0.163, kernel 0.0.164) and
fails. Pure recorded-version sync via npm install --package-lock-only;
no dependency or semantic change.
@ranxianglei

Copy link
Copy Markdown
Owner Author

(ai: sglang-gpu0/qwen3.8-27b)
本 PR 的全部内容已随合集 PR #5918 合入 master(2026-11-08),此 PR 重复,关闭。

@ranxianglei ranxianglei closed this Nov 8, 2026
Louie0806 pushed a commit to Louie0806/billion-context that referenced this pull request Nov 8, 2026
@github-actions github-actions Bot mentioned this pull request Nov 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Installing billion-context removes '/remote-control' command from claude-code

1 participant