Skip to content
 
 

Latest commit

 

History

1,202 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code(go-hare)

English README

GitHub Stars GitHub Issues Last Commit Bun npm

基于官方 Claude Code CLI 的源码还原 / 工程化重建项目。目标是在保留 Claude Code 终端交互体验的同时,补齐多模型接入、自托管 Remote Control、ACP、daemon / 后台会话、MCP、插件与本地自动化等能力。

本仓库不是 Anthropic 官方产品。商标与官方 Claude Code 权利归 Anthropic 所有;本项目仅供学习与研究。

能力 说明
多模型 /login 配置 Anthropic / OpenAI / Gemini / Grok 兼容端点
Remote Control 自托管 RCS + Web UI;claude remote-control / bridge
ACP Agent Client Protocol,可对接 IDE / 代理宿主
Agents / Daemon claude agents dashboard、daemon job、后台会话 resume / fork
Fullscreen 对齐 densable 滚轮、Jump-to-bottom、alt-screen 等交互
Poor Mode /poor 穷鬼模式:跳过记忆提取 / 建议等,降 token
KAIROS / Buddy 常驻助手与终端 buddy(feature 可开关)
Computer Use / Chrome 截图键鼠、Chrome MCP(平台完整度不一)
Artifacts HTML 上传托管(独立 Cloudflare Worker 包)
Voice 语音输入(含豆包 ASR 路径)
Web Search 内置搜索工具
Langfuse Agent loop 可观测(可选)

部分能力由 feature flag 控制(见下方);Analytics / GrowthBook / Sentry 等为占位实现,不要当成可用企业集成


项目定位

这是 CLI-first 的 Claude Code 兼容运行时:

  • 主交互宿主:src/screens/REPL.tsx + src/main.tsx / src/entrypoints/cli.tsx
  • 查询主链:src/query.ts / src/QueryEngine.ts
  • 工具:packages/builtin-tools(经 @claude-code/builtin-tools 导出)
  • 远程 / 守护:src/bridge/src/daemon/packages/remote-control-server/
  • ACP:src/services/acp/packages/acp-link/

仓库里没有独立的 src/core / src/hosts / src/runtime 包级 Agent Core 分层;旧文档里的 createAgent from 'claude/core'./core 子路径描述已过时,请勿依赖。

近期主线已收口 densable 2.1.211 → … → 2.1.229 → 2.1.231 → 2.1.232 → 2.1.233 产品对齐(229 REACTIVE_COMPACT + 231 OAuth FLv + 232 大包 HAVE 45 / N/A 4 + 233 MCP v2 单栈 HAVE 14;官方无 2.1.230)。npm 包版本以 package.json / npm 为准(当前发布线 2.7.44),与 git tag 可能不同步。

densable 2.1.231–2.1.233 对齐说明(2.7.40 → 2.7.43;2.7.44 产品补丁)

对照文档:

  • docs/upstream-extraction/v2.1.231/official-231-checklist.mdHAVE 1 + cup/r8o residual)
  • docs/upstream-extraction/v2.1.232/official-232-checklist.mdHAVE 45 / N/A 4 / PARTIAL 0;官方 49 条)
  • docs/upstream-extraction/v2.1.233/official-233-checklist.mdHAVE 14 + verify-only/pre-exist;N/A 3

叠在 2.1.229(npm 2.7.39)之上。2.7.40 一次收口 231→233(含 232 review residual:G7 cse_*、thinking-only re-stream、ERA 探测、remint 接线)。2.7.41 补齐 MCP v2 残留类型迁移:全量 method+params setNotificationHandler(channel/IDE/VSCode/print)、ctx.mcpReq、elicitation complete 守卫顺序、以及 mock.module 进程全局污染隔离。2.7.42 收口 tools/list 边界与 residual cast:listToolsResultcreateSdkMcpServer/tools/call densable 路径、k0i implements、channel origin。2.7.43 审查收口:thinking-only cost credit、G7 cse_* abandon clear、epoch_stale-only Ot;OpenAI/Grok/Gemini catch 走 getAssistantMessageFromError 使 PTL 进 reactive compact。2.7.44 teammate 默认模型:unset/null 跟随 leader / ANTHROPIC_MODEL(Opus 仅兜底),并转发 Anthropic 模型 env pin。

已 1:1 落地 故意不扩 / 不动
231 OAuth MCP 预注册 client(Slack 等)redirect:JFr=localhost(listen 仍 127.0.0.1);preferred-port 复用;preserveClientRegistration;custom redirectUri 不启 localhost listener 与 229「strict AS 用 127.0.0.1 redirect」目标不同——redirect host ≠ listen host 故意分离
232 Agent / 跨会话 fork 产品默认 ON(runtime gate,非 compile FORK_SUBAGENT);@ peer mention;SendMessage 裸名直达;本机 session 名唯一;Dialog expiry / 跨会话 inbound 策略 完整 cloud sessions / inProcess team-file 不 invent
232 安全 / 市场 GitLab token 家族脱敏 + glab 路径保护;marketplace 别名;GitLab nested subgroup clone;PS PSDefaultParameterValues;nested git 独立 trust;UDS socket dir 硬化 #10/#11/#22 gateway、#45 Cowork N/A
232 RC / 流 remint ~30min / Ls+Hde/gzp;G7 teleported + cse_* 失败重连保留;thinking-only re-stream(Po=1/sr=2);stream idle→api_timeout;mTLS 热更;region sanitize 真网 e2e remint harness 非默认
232 其它 MCP connect timeout(y0/Obf/ERA/probe);sandbox.ripgrep 仅 user/managed/--settings;plugin install 先 refresh;/code-review high+ bg;OpenAI/Grok max prompt length→PTL
233 MCP v2 产品路径 @modelcontextprotocol/client@2 + server@2 单栈(listen reopen/park、BVa probe、string handlers、mcpServerKeyHash);类型 re-export v2;auth 结构守卫 不 invent apps gateway;agent-sdk 传递依赖仍可能带 sdk 1.x
233 硬化 / UX cgroup TOOL_MEMORY_LIMITWEBFETCH_CACHE_TTL_MS;参数二次展开哨兵;\??\ UNC;bare skills validate;/effort 读屏列表;Todo/Tds opt-in;GitHub tip 非 GH 隐藏;cd && > discard 目标
233 官方回滚 回滚 232 Cygwin symlink 写门 + Bash < file 产品门TREE_SITTER_BASH 不进 DEFAULT;validateInputRedirections residual 保留勿产品调用 待 densable narrower 版再接;勿为 checklist 默认开回
Feature 默认 继承 229:REACTIVE_COMPACT + UDS/LAN/TEAMMEM/KAIROS 外围 ON collapse/snip/ULTRAPLAN 仍 OFF;FORK_SUBAGENT compile 仍 optional

densable 2.1.229 对齐说明(2.7.39,已并入)

对照文档:docs/upstream-extraction/v2.1.229/official-229-checklist.mdHAVE 27 / N/A 5 / GAP 0)、changelog-2.1.229.md。叠在 2.1.228 之上。2.7.39 在 229 产品线上补了 DEFAULT_BUILD REACTIVE_COMPACT(长会话 413/PTL withhold + try 恢复;不含 CONTEXT_COLLAPSE / HISTORY_SNIP)与 densable ex / Jsa / Rhe 门控。

已 1:1 落地 故意不扩 / 不动
上下文 / PTL #20 messages-only >32MB request_body_over_limit;#25 Ysa/bua「automatic compaction failed」;REACTIVE_COMPACT 产品默认 ON;try 经 densable ex()(=isAutoCompactEnabled)+ Jsa(source/$Ir/yAt)+ Rhe(remote GB) CONTEXT_COLLAPSE / HISTORY_SNIP 仍 OFF;precompute swap 未 ship
OAuth / 归因 / 1M #12 MCP OAuth 127.0.0.1;#10 attribution ignoreEnvOptOut + auto-mode force;#11 subscriber 1M 仅 first-party/unix socket
SHR / Windows #2 server launcher hooks;#23 GCM fail-fast;#29 win32 强制 --base-dir;#22 managed-mcp exclusive soft-skip
插件 / 列表 / 流 #4 marketplace command+link;#5 ListAgents offline/cloud;#6 VirtualMessageList keys;#16 plugin in-use markers
工具 / 路径 / 空白 #7 safeToolInput non-string;#8 ProgressBar/MarkdownTable clamp;#9 Windows \\?\/UNC strip;#19 stream-json blank gate
工作流 / 其它 #17 host cores 并发;#24 prefix stagger;#26 IPv6 doctor;#27 login OAUTH 复告;#28 commit-push-pr deny;#13/#14/#15/#18 RC/GH/diagnostics/cron #3 SSE host ping、#21 Desktop OTEL、#30–#32 VSCode N/A invent-ban
Feature 默认 REACTIVE_COMPACT + UDS/LAN/TEAMMEM/KAIROS 外围 ON collapse/snip/ULTRAPLAN 仍 OFF

densable 2.1.228 对齐说明(2.7.37,已并入)

对照文档:docs/upstream-extraction/v2.1.228/official-228-checklist.mdHAVE 17 + PARTIAL 1 / GAP 0;#12 core-only)、changelog-2.1.228.mdcross-pack-residuals.md。叠在 2.1.227 之上(中间 223–227 已并入 git;本 npm 线一次收口到 228)。

已 1:1 落地 故意不扩 / 不动
Ink / 输入 layout fault 立即 re-layout + reportLayoutFault*;kTd text 仅 whole-token SGR/X10 re-ESC;incomplete CSI 在 tokenizer buffer / NORMAL_TIMEOUT flush 不 invent pendingSgr/absorbMm/2-param KE empty;KE progressive sinks = local delta
Windows / SHR uio parent-of-Git where 过滤;checkout hook 非 push 跳过 + warn;follow-up hold + countNonMonitorTasks;emit→clear densable 序 不 invent clear-first / re-arm idle
UDS / LAN / RC key_publish_failed 启动硬失败 + CLAUDE_CODE_MESSAGING_TOKEN;LAN TCP pre-auth + timing-safe;RC reattach owner meta / noHistoryBackfill;left-arrow stash bridge 不 invent dual UDS token / pairing code
技能 / 工具 / 云 syncedSkills harden core(shadow/sanitize/no !/@);Write/Edit Jqy/MCt + l8t errorCode:13(validateInput+call);Vertex fail-fast + Bedrock GKd 接线;St mid-turn attachments #12 core only(无完整 claude.ai ingest);#3 /tui 仅 Bxa --model pin
其它 cleanup 保 memory;plugin symlink 不 orphan;marketplace ssn whole-entry;title ◐/◑;auto-mode 去掉 expensive 句;cross-session from-name;PR 本地订阅 store 223 #3 teleport invent-ban;221 #12 DEP-HAVE(srt)
Feature 默认 UDS_INBOX / LAN_PIPES / TEAMMEM / KAIROS 外围 DEFAULT_BUILD ON ULTRAPLAN 仍 OFF;tengu_ccr_bridge 不默认 true

densable 2.1.222 对齐说明(2.7.36,已并入)

对照文档:docs/upstream-extraction/v2.1.222/official-222-checklist.mdHAVE 21 / GAP 0)、changelog-2.1.222.md。叠在 2.1.221 之上。2.7.36 在 222 发布线上修了 streaming residual:collapsed 工具组后的空 hasContentAfter 去掉 invent 的 ||streamingPreview;whitespace / strip-empty 不画 XEl)。

已 1:1 落地 故意不扩 / 不动
worktree / 权限 全会话 worktree isolation fences(file edits + Bash);PreToolUse auto-allow 不绕过 requireCanUseTool;SendMessage auto-mode classifier;disable-model-invocation 请用户跑 skill
流式 UI / 可靠性 UNf/BNf/WNf/Qci streaming store;salvage 在 pH.clear 保留;close-after-complete 不误报 mid-response;gateway keep-alive ping;preflight proxy + 10s 超时;file watcher error teardown;SR EOL 删除;2.7.36:空 streaming / 假 past-tense “Ran N…”
RC / 设置 / host remoteControlAtStartup:project/local 不能开、可关;flagSettings + projectSettingsAliasesUserSettings;host model overlay 优先于 stale managed-settings
工具 / 成本 / git MCP 份额仅计真消费;SendMessage summary 截断;tool-gone 仍展示;post-push PR link;raw git diff --no-textconv/--no-ext-diff;agent 族别名 step-down
Feature 默认 ULTRAPLAN 产品默认 OFF(FEATURE_ULTRAPLAN=1 可复活 residual) UDS_INBOX / LAN_PIPES / TEAMMEM 默认 ON(2026-08-12);KAIROS 外围 channels/push/webhook 默认 ON;ULTRAPLAN 仍 OFF

densable 2.1.219–2.1.221 对齐说明(2.7.37,已并入)

对照文档:

  • docs/upstream-extraction/v2.1.219/official-219-checklist.mdHAVE 24 / GAP 0
  • docs/upstream-extraction/v2.1.220/official-220-checklist.md(public 1 行 N/A + SEA residual HAVE
  • docs/upstream-extraction/v2.1.221/official-221-checklist.mdHAVE 35 / GAP 2 / N/A 2

叠在 2.1.218 之上。历史 snapshot 叙述(见下表「故意不扩」列):旧文曾写 #10 constructor / #12 large-upload TLS 为 GAP。现状docs/upstream-extraction/v2.1.221/official-221-checklist.mdcross-pack-residuals.md#10 HAVE(API-request null-proto/hasOwn;registry plain densable 1:1);#12 DEP-HAVE(sandbox-runtime,非 CLI invent)。#1 VSCode Focus view / #38 gateway model 400 仍为 N/A

已 1:1 落地 故意不扩 / 不动
2.1.219 模型 / caps Opus 5 catalog(EHl/ON)+ 1M picker「Opus (1M context)」;nest depth 默认 3(hazel_trellis);workflowSizeGuideline;stream-json nested --forward-subagent-text;Fable credits stale cache
2.1.219 权限 / hooks / UX sandbox.network.strictAllowlistDirectoryAdded hook;init mcp_server_errors;GIT_BASH basename 校验;Vim ← empty→agent view;SR 后缀 append;RC endpoint 点名;MCP policy ${VAR}
2.1.220 residual isEntitlementOverlayUnavailable / entitlement deny-set;entitlement_blind 遥测;blind opus-5 → opus-4-8 替身 官方 public 无逐条 product list(N/A)
2.1.221 安全 / 权限 sandbox credential mode:"mask";zsh [[ ]] unquoted &PowerShell 引号路径 pWo fail-closed ask;Bash U5e/cle bareAssignmentNames 全量(for 危险集 / declaration 旗标 / Pws·uVu)+ ZRu 只读 bare 字段;#10 constructor API-request HAVE(null-proto/hasOwn) #12 large-upload TLS = DEP-HAVE(srt,非 CLI locus);勿当 open GAP invent CLI handler
2.1.221 会话 / 插件 / UI prompt-audit;session title sanitize;Vim yank 共享 / undo-to-empty;plugin install catalog refresh + reload 清 notice;/status session kind;Stats cache 分解;ultrareview no-branches;bg commit/draft-PR policy;Vertex ToolSearch native wire #1 VSCode Focus N/A;#38 gateway N/A
Feature 默认 构建默认 feature 集见 build.ts UDS_INBOX / LAN_PIPES / TEAMMEM 默认 ON(2026-08-12);KAIROS 外围 channels/push/webhook 默认 ON;ULTRAPLAN 仍 OFF

densable 2.1.218 对齐说明(2.7.33,已并入)

对照文档:docs/upstream-extraction/v2.1.218/official-218-checklist.mdHAVE 35 / N/A 1 / GAP 0)、changelog-2.1.218.md。叠在 2.1.217 之上。禁止写「36/36 solid HAVE」— #9 官方 gateway spend metering 为 N/A(go-hare 不发 gateway);CLI cousin application-inference-profile 另计 HAVE。

已 1:1 落地 故意不扩 / 不动
code-review / ultrareview /code-review bg subagent + stacked slash;/code-review ultra 非交互 cloud;/ultrareview 描述性参数 + 无效参数反馈
a11y / 输入 SR 删除播报;VoiceOver 末尾空格;plugin/settings declareCursor;多行粘贴 Ctrl+J→换行;← 确认 + AgentView Esc 回原会话
权限 / auto-mode / sandbox dangerous-rm/&/Win path circuitBreaker;plan+auto RO Bash→classifier;sandbox IDE 命令 fail-closed;agent frontmatter hooks 需 workspace trust
会话 / 引擎 Host teardown phantom turn + sticky permissionLayers;假 interrupt 抑制;fork logical_parent_uuid;prompt history race;overflow 重试 + Ctrl+B shell caps
云 / 远程 / IDE Bedrock setup assume-role/partition/proxy;CCR closed-gate 停 heartbeat;IDE selection mid-emoji + sibling_context_error;PR link flush 2s
frontmatter / 技能 / 信任 agent 名禁 :;fork skill 默认 background;布尔 yes/no/on/off/1/0;plugin --config KEY=VALUE/deep-research 仅手动;trust 标 repository root + RC multi-env Add-server #9 gateway metering N/A
Ink / Agent Views(发版加固) skipSyncMarkers;unmount 不写 paused previous-output;无 empty-frame skip;Esc= densable JH done + O7 suppressResumeHint(不 attach-origin 黑屏) UDS/LAN/TEAMMEM 默认 OFF

densable 2.1.217 对齐说明(2.7.32,已并入)

对照文档:docs/upstream-extraction/v2.1.217/official-217-checklist.mdHAVE 20 / GAP 0)、changelog-2.1.217.md。叠在 2.1.216 之上。

已 1:1 落地 故意不扩 / 不动
Caps / 预算 concurrent subagents 默认 20;nested depth 默认 1(CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH / hazel_trellis);--max-budget-usd halt bg subagents
paths brace frontmatter brace budget(Xug=1000 / Jug=4MB);超限 unexpanded + warn
Hyperlink / tips / login FORCE_HYPERLINK;frontend-design tip 终身 ≤3;login-expiry 警告 3 天
emoji shortcode typeahead + emojiCompletionEnabled
bg isolation #5 cwd 符号链接 canonicalize(eq/N6g/XNe/hsr);Shell context_lostworktree_gone→VRu→bash ZRu;bareAssignmentNames+YPg/FJi/tLg;Write e7 / Edit·Notebook e12 U5e 解析失败本地更严parse-unavailable fail-closed,非 densable 空 simple)
可靠性 transcript writer ENOSPC;MCP truncate 不回灌 full;Opus 4.8 Bedrock 1M;SR 启动 quiet;managed OTEL endpoint 统管;malformed attachment resume;attach footer gap;Win absolute taskkill UDS/LAN/TEAMMEM 默认 OFF

densable 2.1.216 对齐说明(2.7.31,已并入)

对照文档:docs/upstream-extraction/v2.1.216/official-216-checklist.mdHAVE 38 / N/A 1 / GAP 0)、pack-report.md、各 extract。叠在 2.1.214/215 之上。

已 1:1 落地 故意不扩 / 不动
Sandbox sandbox.filesystem.disabled(跳过 FS 隔离、保留网络 egress);credentials 一等公民
长会话 / 归一化 message normalize 二次方优化(Map + cursor);/context 超窗警告;失败 compact 标 error
Auth / auto mode OAuth 401 sideQuery 重试;AskUser free-text 中立措辞;Chrome 缺 scope 403 循环;MCP re-auth 不提前吊销
worktree / bg git 隔离(防 git -C/GIT_DIR 指回 shared checkout);foreign-repo resume;无 git worktree 可删;daemon stop --any 不误杀;resume agent identity;bg startup cancel 免疫 interrupt
权限 / Shell / PS list/negation redirect;Win 网络路径 RO 弹窗;非 ASCII 词边界;PS 不可见 Unicode;git/gh 参数加强
UI / 会话 UX @-mention/hooks/vim paste/statusline/resume-picker;Esc-Esc rewind;agent list Ctrl+X 删除;GUI 编辑器 handoff;fullscreen dialog/config/footer;skill 菜单热刷新;plugin skill 前缀;fork 一行确认
其它 /rewind 不经 symlink/hardlink;ultrareview 体积/empty-diff;spend-limit reason;telemetry user_abort;needs-input park;dataviz palette;cloud interrupted turn re-run #39 VSCode RTL N/A;UDS/LAN/TEAMMEM 默认 OFF

densable 2.1.215 对齐说明(已并入 2.7.31)

对照文档:docs/upstream-extraction/v2.1.215/official-215-checklist.mdHAVE 2 / N/A 1 / GAP 0)。

已 1:1 落地 故意不扩 / 不动
Skills 策略 /verify/code-reviewdisableModelInvocation: true + 用户仍可 / 调用 误改 /simplify(仍可被模型调用);verification agent 文案 N/A

densable 2.1.214 对齐说明(2.7.30,已并入)

对照文档:docs/upstream-extraction/v2.1.214/official-214-checklist.mdHAVE 47 / GAP 0)、各 batch extract。在 2.1.212 收口之上叠 214 安全阀 / EndConversation / PS·Bash / bg daemon / RC ready-push 等。

已 1:1 落地 故意不扩 / 不动
权限 / Bash / PS 单段 dir/ allow cwd-only;PS 5.1 bypass;fd redirect fail-closed;>10k prompt;zsh [[ ]];help/man;docker daemon-redirect;PS stdin/encoding/where·fc·diff
会话 / 工具 EndConversation;长工具 progress heartbeat;stream cost 双计修复;advisor network stall;hooks exit 2 优先
GrowthBook / OAuth null/畸形 payload 不崩不清缓存;OAuth 轮换后 refresh flags
bg daemon yield 不删继任 control socket;idle retire;claude rm/AgentView deleteJob;非 git force 删;transcript 目录伪命中
RC ready-push 仅显式 RC + GB nudge;拒绝 outbound/reattach/bg/agentId;impression 计数;onInteraction 活动闩 不扩 KAIROS 其它产品面
OTel / MCP / 其它 message.uuid / client_request_id / tool_source;OTEL content max;out-of-context trace;MCP list_changed 保留;flag settings plugins;ultrareview empty-tree;SessionStart source:"fork"
Feature 默认 构建默认 feature 集见 build.ts UDS_INBOX / LAN_PIPES / TEAMMEM / KAIROS 外围 默认 ON(2026-08-12);ULTRAPLAN 仍 OFF

densable 2.1.212 对齐说明(2.7.29,已并入)

对照文档:docs/upstream-extraction/v2.1.212/official-212-checklist.mdHAVE 44 + N/A 1,0 GAP)、pack-report.md closeout、residual-qre-jes-2026-08-06.md

已 1:1 落地 故意不扩 / 不动
会话安全阀 WebSearch / subagent 默认 200 + env;/clear 重置;MCP 长调用自动后台(默认 2min / env)
/fork · /subtask /fork = 后台会话副本 + keepParent;原会话内 full-context 工人 = /subtask 不把 legacy in-session 仍叫 /fork
Agents UX agent-view /resume picker→bg;重开 stopped;冷 attach transcript;footer N doneNeeds input
claude auto-mode reset 确认提示 + --yes
可靠性 / UX 批次 plan bash 写权限、worktree 符号链接、hook continue:false、print SIGTERM 143、Win PS7 bg、shell ! 路径、btw 重开、SendMessage 预览、Web 529、mid-conv cache 等(见 checklist) 不补 2.1.210 collapsed-tool 实时 elapsed(邻版)
ultrareview / teleport Qre 创建仍 POST /v1/sessions;OTe/KLc/H8/F1g/nts 走 /v1/code/sessions;o9t token、payload wrap、archive=kill 主 CLI 不发明 densable 未注册的 --project/--ref/--on-branch 旗标(中间层 rts 已就绪)
Feature 默认 构建默认 feature 集见 build.ts UDS_INBOX / LAN_PIPES / TEAMMEM / KAIROS 外围 默认 ON(2026-08-12);ULTRAPLAN 仍 OFF

近期更新(2.7.5 → 2.7.44)

版本 要点
2.7.44 teammate 默认模型跟随 leaderteammateDefaultModel unset/null 经 leader → mainLoopModel / ANTHROPIC_MODEL 解析,硬编码 Opus 仅最后兜底;Config/ModelPicker 文案对齐;向 teammate 转发 ANTHROPIC_MODELANTHROPIC_DEFAULT_*_MODEL
2.7.43 densable 1:1 审查收口 + 兼容层 PTL:thinking-only re-stream 前 credit session cost;G7 mint-time cse_* 放弃/teardown 清理(reattach 暂态保留);epoch_stale-only Ot(epoch_conflict 不进 Ba remint);OpenAI/Grok/Gemini catch 经 getAssistantMessageFromErrormaximum prompt length 可进 reactive compact。
2.7.42 MCP tools/list 边界 + residual cast 收口listToolsResult 统一 wire 边界(chrome/weixin as unknown as ListToolsResult);createSdkMcpServer densable cr4 registerTool 无 cast;entrypoints/mcp.ts tools/call 对齐 coerceInputsafeParsevalidateInputcallDensableAjvJsonSchemaValidator implements jsonSchemaValidator;channel enqueue originas any
2.7.41 MCP v2 residual 收口:全量 densable string setNotificationHandler(channel/IDE/VSCode/print enable+reconnect);ctx.mcpReq / elicitation complete 守卫顺序;type residual(deny source keys、callTool 二元、GB boolean);测试隔离 process-global mock.module/env。
2.7.40 densable 2.1.231–2.1.233 收口(无官方 2.1.230):231 MCP OAuth 预注册 redirect FLv(localhost + port 复用 + preserveClient);232 HAVE 45 / N/A 4 — fork 默认、@mention/SendMessage 裸名、session 名唯一、GitLab token/marketplace、PS/nested-git、MCP connect timeout、RC remint/G7 cse_*、thinking-only re-stream、OpenAI/Grok PTL、sandbox.ripgrep 源限制等;233 HAVE 14 — MCP client@2/server@2 产品单栈、cgroup 内存、WebFetch TTL、\??\ UNC、Todo/Tds、/effort a11y;官方回滚 232 Cygwin + Bash < 产品门(residual 保留)。N/A:gateway / Desktop Notification / Cowork。
2.7.39 densable 2.1.229(HAVE 27 / N/A 5 / GAP 0) + 产品默认 REACTIVE_COMPACT:长会话 413/PTL withhold + try 恢复(Ysa/bua #25;messages >32MB unrecoverable #20);try 门控 densable ex/Jsa/Rhe;OAuth 127.0.0.1、attribution force、SHR launcher hooks/GCM/base-dir、plugin command 源、ListAgents offline/cloud、safeToolInput、UNC path、workflow host 并发/prefix stagger、IPv6 doctor、commit-push-pr deny 等。N/A:#3 SSE host、#21 Desktop OTEL、#30–32 VSCode。不含 collapse/snip。
2.7.38 Grok 4.6 推理档 catalog:按模型 ID 最长匹配加 grok-4.6 行(不按厂商启发式)。官方 xAI reasoning(2026-08-12):grok-4.6low | medium | high | xhigh(默认 high);grok-4.5 仍三档(xhigh 当 high)。另有 grok-4.20-reasoning 三档、grok-4.20-multi-agent 含 xhigh(agent count)。queryModelGrok映射后 id 发 Chat Completions reasoning_effort。不加裸 grok-4 / grok-4.20 行。
2.7.37 densable 2.1.228(HAVE 17 + PARTIAL 1 / GAP 0;#12 core-only) + 已并入 223–227:Ink layout recover;kTd whole-token re-ESC + incomplete buffer;Windows uio;SHR checkout skip + follow-up hold;UDS key_publish fail-closed + LAN TCP auth;RC reattach owner / left-arrow;syncedSkills harden core;Write/Edit Jqy/MCt+l8t;Vertex fail-fast + Bedrock GKd;St mid-turn;cross-session from-name;cleanup memory / plugin symlink / marketplace ssn;/tui model pin;title ◐/◑;auto-mode 去 expensive;DEFAULT_BUILD UDS/LAN/TEAMMEM/KAIROS 外围 ON;221 #10 null-proto + createSdkMcpServer。跨 pack 残差见 cross-pack-residuals.md(teleport invent-ban)。
2.7.36 streaming 空 hotfix(densable 222 residual)hasContentAfter 对齐 densable y||aem(去掉 invent ||streamingPreview);whitespace / strip-empty 不画 XEl;Qci trim-empty 清 STREAM_FLAG_DISPLAYED。避免 collapsed 工具组后假 past-tense「Ran N…」+ Cooking 前 lone bullet。
2.7.35 densable 2.1.222 全量 1:1(21/21 HAVE) + 已并入 219–221:全会话 worktree isolation;streaming UNf/WNf/Qci + salvage clear 契约;RC remoteControlAtStartup 源限制(flag/aliases);host model overlay;ULTRAPLAN 产品 OFF;preflight proxy 超时;MCP 份额归因;SendMessage classifier/截断;tool-gone 展示;post-push PR link;raw git diff;agent 族 step-down;SR EOL 删除;file watcher teardown 等。并入 219 24/24 / 220 residual / 221(发版时 snapshot HAVE 35 / GAP 2 / N/A 2之后 #10→HAVE、#12→DEP-HAVE,见 checklist / cross-pack-residuals,勿当现状 GAP)。UDS/LAN/TEAMMEM 发版时默认 OFF(后翻 ON)。
2.7.33 densable 2.1.218 全量 1:1(35 HAVE / 1 N/A / 0 GAP):code-review bg + ultra cloud;ultrareview 描述/无效参数;SR a11y / Ctrl+J / ←确认 / AgentView Esc;Host teardown + permissionLayers;auto-mode/sandbox IDE;fork lineage;Bedrock wizard;CCR heartbeat;frontmatter 布尔/--config/禁 :/deep-research 仅手动;RC multi-env trust。#9 gateway metering N/A。发版加固:Ink skipSyncMarkers/unmount/alt-screen;Agent Views Esc 不 attach-origin 黑屏 + O7 退出。UDS/LAN/TEAMMEM 默认 OFF。
2.7.32 densable 2.1.217 全量 1:1(20/20 HAVE):subagent concurrent 20 / nest depth 1;brace budget;FORCE_HYPERLINK;emoji shortcode typeahead;tip lifetime 3;login 3d;transcript ENOSPC;MCP truncate;Opus 4.8 Bedrock 1M;SR startup quiet;managed OTEL;malformed attachment;attach footer gap;Win taskkill;bg isolation eq/N6g/ZRu bare+YPg(ZRu 仅 Shell.exec)。故意更严:parse-unavailable fail-closed。UDS/LAN/TEAMMEM 默认 OFF。
2.7.31 densable 2.1.215 + 2.1.216 收口:215 /verify·/code-review 禁止模型自启(HAVE 2);216 HAVE 38 / N/A 1 / GAP 0(sandbox.filesystem.disabled、长会话 normalize、auto-mode 401、worktree git 隔离、daemon stop --any、bg/agents UX、Win 网络路径、fullscreen UI、skill 菜单热刷新、/rewind symlink 安全等)。故意不扩 UDS/LAN/TEAMMEM;VSCode RTL N/A。
2.7.30 densable 2.1.214 全量 1:1(47/47 HAVE):权限/Bash/PS 安全阀;EndConversation;tool heartbeat;GrowthBook null payload + OAuth flag refresh;bg daemon control-socket/retire/deleteJob;RC session-ready push 门闩;stream cost / advisor stall / hooks exit2 / OTel / MCP list_changed 等。故意不扩 UDS/LAN/TEAMMEM。
2.7.29 densable 2.1.212 收口:官方 48 条 0 GAP;/fork keepParent + /subtask;会话 caps / MCP auto-bg / auto-mode reset;ultrareview + Qre/code-sessions(OTe/KLc/H8/F1g/nts)1:1。故意不扩 UDS/LAN/TEAMMEM。
2.7.28 Win 打包剪贴板贴图bun --compile 下 sharp 原生模块不可用时改走 System.Drawing 缩放/JPEG;dev 仍用 sharp。
2.7.27 Prompt 通知条高度:绝对定位区 height 2→1,避免最新通知盖住 prompt 顶边框(如剪贴板图片 alt+v 提示)。
2.7.26 Win 剪贴板图片粘贴:Git Bash 下 PowerShell shell:false argv;空 paste 开 Windows;优先 PNG 流;客户端 ≥8px 拦截 1×1;Buddy/KAIROS 文档对齐 densable 211。
2.7.25 Host densable 211 生产路径:永久 model_not_foundsystem/model_fallbacksystem/background_tasks_changed(REPLACE live set);mid-bg didBackground 真 flip;eviction 保 Host progress 事件。
2.7.24 Official 2.1 Host 流/控制 + bypass 1gcommand_lifecycle / thinking_tokens / task_updated / task_summary / background_tasks(Ctrl+B)对齐;mid-bg 发 task_updatedbackgroundAll 排除 main-session;bypass 下 classifierApprovable safetyCheck 可过(densable 1g)。
2.7.23 Tasks dual-emit:agent/shell/monitor/dream/workflow 终止时 once-gated 发 system/task_notification bookend(含 ISO timestamp),Host Tasks 可按 densable Jp 结算;print residual 再发一次-gated,不再只靠 TaskOutput 冒充生命周期。
2.7.22 REPL 更新提示 / go-hare 自动升级路径:去掉 ENABLE_AUTOUPDATER 默认关闭;autoUpdates=false 仍 toast「Update available」;Notifications 挂载 AutoUpdater;npm 包二进制识别为 npm-globalclaude update 使用 @go-hare/claude-code
2.7.21 Workflow / ultracode densable 对齐:完整 playbook 挂在 Workflow 工具 prompt(ONLY-call-when opt-in);/ultracode 改为 disableModelInvocation 用户只读,去掉宽 whenToUse 自举路径。
2.7.20 Workflow host densable 对齐/workflows 改为历史浏览器(GsK);live 监控走 Tasks WorkflowDetailDialog(fv_)+ task.workflowProgress;删除双栏 WorkflowsPanel;补 progress fold / SDK task_progress 桥接与 history 导航键位修复。
2.7.19 Provider 优先级修复modelType=anthropic 不再被残留 USE_OPENAI / USE_GEMINI / USE_GROK 等环境变量抢优先级。
2.7.18 Chrome multi-browser 无 OAuth:无 OAuth 时也暴露并支持本地 multi-browser 工具(对齐 densable 本地 Chrome MCP 能力)。
2.7.17 Claude in Chrome 扩展链路:默认放行 agent-extension fork ID、可追加扩展白名单;本地扩展下载改走 go-hare/agent-extension release;Install local 打开仓库页;/chrome 去掉 (Beta) 后缀。
2.7.16 Host effort 元数据get_settings.applied 增加 effortLevels / ultracodeOfferable,桌面端可据此渲染可用 effort 档位与 ultracode 入口。
2.7.15 Host Effort/Ultracode 链路:densable Host get_settings.ultracode + apply_flag 直写;eee 剥 fence 再 parse,fenced JSON 不再刷 ERROR。
2.7.14 贴图降级修复:图片 resize 失败时降级为文本提示,不再整轮吞消息。
2.7.13 贴图 Enter 抢键修复:贴图时清 footer,避免两个 shell 同时响应 Enter 吞消息;Fable consent 拒绝时不再错误写入 sticky effort / N9。
2.7.12 贴图后打字吞消息修复:共享 live ref,避免贴图 pill 后被同 tick 键入冲掉;Enter 路径进一步对齐。
2.7.11 Effort densable 对齐:模型驱动 effort resolve、ultracode 会话模式、ModelPicker pin 约定、effort pin 落盘;粘性滚动白屏与 effort toast 同 key 刷新修复;文字+图片同 tick Enter 吞消息修复。
2.7.10 Shell 对话框 hooks 崩溃修复:打开 BackgroundTasksDialog 时 PromptInput 的 onKeyDownBefore useCallback 位于 early return 之后导致 "Rendered fewer hooks than expected";钩子上移 + onDoneEvent 延后触发。
2.7.9 全平台二进制重编发布(含 2.7.8 Enter 吞消息修复等当前 main)。
2.7.8 Enter 偶发吞消息修复:对齐 densable Enter 路径(typeahead / history search / PromptInput),避免提交键在部分状态下丢输入。
2.7.7 OpenAI 兼容流多 ● 修复:坏代理对每个 chunk 重发全文并带 finish_reason 时,不再反复开闭 text block(normalizeMessages 一行一个 ●);累计全文 delta 只 emit 后缀;assemble 侧合并相邻相同 text block 作防御。
2.7.6 densable streaming 对齐:Esc 仅 salvage thinking;streaming / final 双 ● 渲染修复;daemon lifecycle 只 log 不写 stderr;agents handoff 期间 quiet daemon takeover。
2.7.5 densable FileEdit/FileWrite 结果渲染;spinner 用主线程队列长度(避免 subagent 假转);idle-return 不清草稿;OSe 剪枝不写 paste ref。

安装(npm)

发布包名:@go-hare/claude-code(平台二进制在 @go-hare/claude-code-<os>-<arch> optionalDependencies)。

npm i -g @go-hare/claude-code

# Windows 若 claude.exe 被占用导致 EBUSY,先结束占用进程再装
# taskkill /F /IM claude.exe

claude                 # 启动(postinstall 落到 bin/)
claude --version
claude agents          # 后台会话 dashboard(需 daemon)
claude update          # 更新

# 自托管 Remote Control 示例(按你的 RCS 改 URL / token)
CLAUDE_BRIDGE_BASE_URL=https://your-rcs.example/ \
CLAUDE_BRIDGE_OAUTH_TOKEN=your-token \
claude --remote-control

安装失败时:npm rm -g @go-hare/claude-code 后再装 @latest(可钉版本 @2.7.17)。
旧文档里的全局包名 claude-code 不再对应本仓库发布流。


源码开发

环境

需要较新的 Bun(建议 ≥ 1.3.11):

curl -fsSL https://bun.sh/install | bash   # macOS / Linux
# Windows: powershell -c "irm bun.sh/install.ps1 | iex"
bun upgrade

安装与运行

仓库根目录(含本 package.json 的目录):

bun install
bun run dev          # 开发模式(MACRO.* 由 scripts/dev.ts 注入)
bun run build        # 代码分割产物 → dist/cli.js + chunks
bun run precheck     # typecheck + biome fix + 全量测试(改完请跑)

跨平台二进制与发布:

bun run build:compile                          # 仅编译当前/指定平台二进制
bun run scripts/publish.ts --build-only        # 同上(publish 脚本路径)
bun run scripts/publish.ts --dry-run           # 构建 + npm publish --dry-run
bun run scripts/publish.ts --with-main         # 含主包 @go-hare/claude-code

平台包内的 claude 二进制由 build 生成,不应长期提交进 git。

/login 配置模型

REPL 中 /login 可选 Anthropic Compatible / OpenAI / Gemini 等:

字段 说明 示例
Base URL API 地址 https://api.example.com/v1
API Key 密钥 sk-xxx
Haiku / Sonnet / Opus 模型 ID 映射 按你的上游填写

Tab / Shift+Tab 切字段,Enter 确认。

Feature Flags

FEATURE_BUDDY=1 bun run dev

构建默认会打开一批 flag(见 build.ts / scripts/defines.ts)。现默认 ONUDS_INBOX / LAN_PIPES / TEAMMEM / KAIROS+外围(channels/push/webhook)。仍默认关闭:FORK_SUBAGENTULTRAPLAN 等。

VS Code 调试

TUI 需真实终端,用 attach:

bun run dev:inspect   # 输出 ws://localhost:… 

VS Code F5 → Attach to Bun (TUI debug)

Teach Me

/teach-me Claude Code 架构
/teach-me React Ink 终端渲染 --level beginner

进度在 .claude/skills/teach-me/(若已安装该 skill)。


仓库结构(精简)

路径 作用
src/entrypoints/cli.tsx 真入口与快速路径
src/main.tsx Commander CLI 与启动装配
src/screens/REPL.tsx 交互 REPL
src/query.ts / QueryEngine.ts API 查询与 turn 编排
packages/builtin-tools/ 内置工具
packages/@ant/ink/ 终端 Ink 框架
src/bridge/ / packages/remote-control-server/ Remote Control
src/daemon/ 长驻 daemon
src/services/acp/ / packages/acp-link/ ACP
scripts/publish.ts 平台二进制编译与 npm 发布
CLAUDE.md 给 agent / 贡献者的详细工程说明

更完整的架构与测试约定见 CLAUDE.md


Contributors

Contributors

Star History

Star History Chart

致谢

许可证

仅供学习研究。Claude Code 相关权利归 Anthropic。请遵守上游与依赖的许可条款。

About

原汁原昧 Claude Code 可运行,可构建, 可调试版; 生产级工程化, 企业级可靠性; 安全无毒, 内存泄露修复

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages