Mashang Claude Code（码上全栈创享家）

基于 @anthropic-ai/claude-code 还原源码进行二次开发，当前版本重点增强：一键启动面板、多服务商接入、开发者模式功能开关。

[!WARNING]
本仓库为社区二开版本（非 Anthropic 官方）。原始源码版权归 Anthropic 所有；本仓库中的增强功能与文档由当前维护者持续更新。

维护者信息

• 公众号：码上全栈创享家
• 抖音：码上全栈创享家
• 小红书：码上全栈创享家
• Git 地址：https://github.com/wmuj/mashang-claude-code

快速开始

bun install       # 安装依赖（需要 Bun ≥ 1.3.5、Node.js ≥ 24）
bun run dev       # 启动 CLI
bun run version   # 验证版本
bun run launcher  # 启动本地一键面板

Windows 用户可直接双击：

mashang-claude-code-launcher.bat

说明：mashang-claude-code-launcher.bat 是唯一启动入口。

一键启动面板（新增）

面向小白的目标

• 不改命令、不改环境变量，填写配置后点击“保存并启动 Claude”即可使用。
• 配置保存在项目根目录 .launcher-config.json（已默认加入 .gitignore，避免误提交）。

当前支持的服务商

• Anthropic（官方）
• xAI
• OpenRouter
• GLM（需填写兼容网关 API 地址）
• DeepSeek（需填写兼容网关 API 地址）
• Qwen（需填写兼容网关 API 地址）
• Kimi（需填写兼容网关 API 地址）
• 自定义第三方（必填 API 地址 / Base URL）
• AWS Bedrock（使用本机 AWS 凭证）
• Google Vertex（使用本机 GCP 凭证）
• Azure Foundry

操作系统支持

• Windows：已重点适配（含 mashang-claude-code-launcher.bat 双击启动）
• macOS / Linux：可通过 bun run launcher 使用面板

开发者模式（新增）

• 面板内置开发者模式开关，可按白名单启用被门控能力（如 Buddy / Proactive / Bridge / Voice）。
• 默认关闭，优先保证普通用户稳定性。

面板与终端展示

从源码中发现的 7 大隐藏功能

通过阅读还原后的 1,987 个 TypeScript 源文件，我们发现了大量未公开的隐藏功能。这些功能通过编译开关（feature()）和用户类型（USER_TYPE）进行门控，外部发布版中大部分被裁剪。

1. BUDDY — AI 电子宠物

源码位置：src/buddy/

终端里的拓麻歌子！一个完整的虚拟宠物系统。

• 18 种物种：鸭子、鹅、猫、龙、章鱼、猫头鹰、企鹅、乌龟、蜗牛、幽灵、六角恐龙、水豚、仙人掌、机器人、兔子、蘑菇、果冻、胖猫
• 5 级稀有度：普通(60%) → 非凡(25%) → 稀有(10%) → 史诗(4%) → 传说(1%)
• 1% 闪光概率：独立于稀有度，任何宠物都有 1% 概率成为闪光个体
• 确定性生成：使用账号 UUID + 固定盐值 'friend-2026-401' 经 FNV-1a 哈希 → Mulberry32 PRNG，每人只会得到一只固定的宠物，改配置也没用
• 外观系统：6 种眼睛样式 + 8 种帽子（皇冠、巫师帽、光环等），common 稀有度没有帽子
• 交互：/buddy pet 抚摸（爱心动画）、/buddy hatch 首次孵化、/buddy rehatch 重新随机抽取、/buddy legendary 抽取随机五星宠物
• 动画：500ms 帧率的 ASCII 精灵动画，气泡对话，窄终端自动退化为表情文字脸（如 =·ω·=）
• 编译开关：feature('BUDDY')

2. KAIROS — 永不关机的 Claude

源码位置：src/assistant/、src/proactive/、src/services/autoDream/

关掉终端 Claude 还在运行的持久助手模式。

• 跨会话持久运行：通过 .claude/settings.json 的 assistant: true 激活，会话状态持久化到磁盘
• 每日日志：自动在 <autoMemPath>/logs/YYYY/MM/YYYY-MM-DD.md 记录工作日志
• 自动做梦（Dream）：距上次整合超 24 小时且有 5+ 新会话时，后台自动启动记忆整合子代理，分四阶段运行：Orient → Gather → Consolidate → Prune
• 锁机制：.consolidate-lock 文件 + PID 存活检查，防止多进程同时做梦
• 主动模式（Proactive）：没人说话时自己找活干，没活就调用 SleepTool 等着。接收周期性 <tick> 提示来检查是否有事可做
• 后台任务：命令超 15 秒自动丢后台，支持持久 cron 任务（permanent: true 不受 7 天过期限制）
• 编译开关：feature('KAIROS')、feature('KAIROS_BRIEF')、feature('KAIROS_CHANNELS')
• 远程开关：GrowthBook tengu_kairos、tengu_onyx_plover（Dream 阈值配置）

3. ULTRAPLAN — 云端深度规划

源码位置：src/commands/ultraplan.tsx、src/utils/ultraplan/

把难题甩给云端 Opus 独立研究最长 30 分钟。

• 流程：/ultraplan <prompt> → 创建远程 CCR 会话 → Opus 模型独立研究 → 后台轮询等待（30 分钟超时）→ 浏览器查看/修改方案 → 批准执行或传送回本地
• 关键词触发：消息中包含 "ultraplan" 自动触发，智能排除引号/路径/标识符中的误触发
• 传送（Teleport）：src/utils/teleport.tsx 实现本地 ↔ 远程会话传输，支持 Git Bundle 打包代码上下文
• 完全内部限定：isEnabled: () => "external" === 'ant'，外部版永远不可用
• 编译开关：feature('ULTRAPLAN')
• 远程开关：tengu_ultraplan_model（控制使用的模型）

4. Coordinator — 多 Agent 编排模式

源码位置：src/coordinator/

主 Claude 变成纯指挥官，Worker 并行执行任务。

• 角色分离：Coordinator 只有三个工具——派活（Agent）、通信（SendMessage）、停工（Shutdown）
• Worker 机制：Worker 在独立子进程中运行，各自拥有完整工具集
• 核心铁律：系统提示中明确规定"禁止甩锅式委派"——不能把不清楚的需求直接丢给 Worker
• 任务追踪：基于文件的共享任务列表（~/.claude/tasks/），Coordinator 和 Worker 共同读写
• 编译开关：feature('COORDINATOR_MODE')
• 环境变量：CLAUDE_CODE_COORDINATOR_MODE

5. 26+ 隐藏命令 & 秘密开关

源码位置：src/commands.ts、src/commands/

Feature-gated 命令（编译开关控制）

仅内部用户（USER_TYPE === 'ant'）命令

隐藏 CLI 参数

--teleport [session]    恢复传送会话
--remote [description]  创建远程会话
--proactive             主动模式
--assistant             助手模式
--brief                 简报模式
--remote-control        远程控制
--hard-fail             硬失败模式
--agent-teams           多代理团队

6. Bridge — 远程遥控终端

源码位置：src/bridge/（34 个文件）

从 claude.ai 或手机直接操控本地 CLI。

• WebSocket 实时连接：本地 CLI 通过 WebSocket 与 claude.ai 建立双向通道
• 完整远程控制：远程端可以发送消息、批准权限、查看输出
• 进程间通信：跨 Claude 会话的消息传递机制
• 状态同步：bridgeStatusUtil.ts 实时同步运行状态
• 权限回调：bridgePermissionCallbacks.ts 远程权限审批
• 编译开关：feature('BRIDGE_MODE')、feature('DAEMON')

7. 50 个编译开关 + 远程门控

外部发布版是阉割版。Anthropic 通过三层门控控制功能：

第一层：编译时开关（feature()，约 50 个）

构建时决定代码包含/排除，以下是完整列表：

第二层：用户类型（USER_TYPE）

• ant（Anthropic 内部）— 解锁全部功能、20 分钟 GrowthBook 刷新、调试工具、200+ 处专属检查
• external（外部用户）— 裁剪版，6 小时 GrowthBook 刷新

第三层：GrowthBook 远程 A/B 测试

隐藏环境变量速查

项目结构

src/                    # 核心源码（1,987 个 TS/TSX）
├── tools/              # 53 个工具（Bash/FileEdit/Agent/MCP...）
├── commands/           # 87 个斜杠命令
├── services/           # API / MCP / analytics / autoDream
├── components/         # 148 个终端 UI 组件（React + Ink）
├── hooks/              # 87 个自定义 Hooks
├── buddy/              # 宠物伴侣系统
├── assistant/          # KAIROS 助手模式
├── coordinator/        # 多 Agent 协调器
├── bridge/             # 远程控制桥接（34 文件）
├── proactive/          # 主动模式
├── vim/                # Vim 模式引擎
├── voice/              # 语音交互
└── ...
shims/                  # 原生模块兼容替代
vendor/                 # 原生绑定源码

数据来源

• npm 包：@anthropic-ai/claude-code
• 还原方式：提取 cli.js.map 中的 sourcesContent

开源标准与协作规范

许可证与版权

• 本项目是社区二开增强，保持对上游版权与来源的明确标注。
• 请在二次分发时保留本 README 的来源声明与版权说明。

安全与隐私

• 不要将真实 API Key 提交到仓库（.launcher-config.json 已在 .gitignore 中）。
• 提交前请检查日志、截图、示例配置是否含敏感信息。

Issue 与 PR 规范

• Bug 反馈请包含：复现步骤、环境信息、错误输出。
• PR 建议保持“小步提交”，一类改动一个 PR，便于审查与回滚。
• 涉及 UI 变更请附截图，涉及行为变更请附验证步骤。

版本与兼容性承诺

• 优先保证已有用户配置可继续工作（不破坏现有启动链路）。
• 对新增门控功能，默认策略是“缺模块自动降级，不阻断启动”。

声明

• 源码版权归 Anthropic 所有
• 仅用于技术研究与学习，请勿用于商业用途
• 如有侵权，请联系删除
• 如果有问题请提交 PR，联系作者进行新增或者修改。

请作者喝杯咖啡

如果这个项目帮你省了时间、解决了问题，可以赞助一杯咖啡，支持后续维护与功能迭代。

⭐ Star 趋势