Skip to content

wmuj/mashang-claude-code

Repository files navigation

Mashang Claude Code(码上全栈创享家)

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


Important

📢 项目归档公告

感谢每一位关注、使用和 Star 本项目的朋友!

经过认真考虑,本项目将停止主动维护和功能更新。随着社区生态的不断发展,目前已有 CC Switch 等优秀的开源工具可以更好地满足 Claude Code 多服务商配置管理的需求,且无需修改源码、维护成本更低。

本仓库将保持公开可访问状态,现有代码和文档依然可以正常使用。如果你觉得这个项目的思路对你有帮助,非常欢迎:

  • 🍴 Fork 本仓库,在此基础上继续开发你自己的增强版本
  • 📖 参考文档中的隐藏功能梳理,用于你自己的研究和学习
  • 💡 提交 PR,如果你做了有价值的改进,我仍然会审阅和合并

再次感谢大家一路以来的支持,祝各位编码愉快!🎉

— 码上全栈创享家


Stars Forks Issues License

Claude Code CLI

Warning

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

维护者信息


快速开始

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

macOS / Linux 用户可在终端执行(首次需赋权):

chmod +x mashang-claude-code-launcher.sh   # 仅首次
./mashang-claude-code-launcher.sh

macOS 用户也可以在 Finder 中右键 → 打开方式 → 终端,即可双击启动。

说明:.bat 文件为 Windows 启动入口,.sh 文件为 macOS / Linux 启动入口。


一键启动面板(新增)

面向小白的目标

  • 不改命令、不改环境变量,填写配置后点击“保存并启动 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 双击启动,面板点击启动后自动打开新 CMD 窗口)
  • macOS:已适配(含 mashang-claude-code-launcher.sh 脚本启动,面板点击启动后自动打开 Terminal.app)
  • Linux:已适配(面板点击启动后自动检测系统终端模拟器并打开新窗口,支持 gnome-terminal / konsole / xfce4-terminal / mate-terminal / x-terminal-emulator / xterm,未检测到时回退为后台运行)

开发者模式(新增)

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

跳过权限确认(新增)

  • 面板提供「⚠️ 全程跳过安全确认」开关,开启后 Claude 在执行命令、修改文件时不再逐步弹窗确认,直接执行。
  • 等同于 CLI 的 --dangerously-skip-permissions 参数。
  • 注意:对话控制权仍在用户手中,Claude 不会自行启动任务;仅省略每步操作前的权限确认弹窗。
  • 默认关闭,适合明确知道要做什么、不想反复点确认的场景。

支持第三方模型调用系统工具(核心修复)

  • 解除官方限制:原版源码强行剥夺了非 Anthropic 域名网关的 Tools 权限。此版本已完全干掉这一限制
  • 真·生产力:无论是 xAI 的 Grok-2、Grok-3 还是 DeepSeek,只要模型本身支持工具调用,在这个客户端里均能通过工具帮你自动建文件、写代码、甚至执行终端命令(不再是“只会聊天的废物”)。

防止 Ctrl+C 意外退出(核心修复)

  • 默认行为优化:原版终端框架如果检测到用户双击或长按 Ctrl+C(超过800毫秒)会直接强行退出,导致聊天历史记录和会话状态丢失。
  • 安全防手滑:我们从底层剥离了这一限制。现在长按或多次按下 Ctrl+C 只会安全地清空当前输入框(符合标准 Bash/CMD 交互逻辑),绝不自动退出。
  • 退出方式:如需退出请主动输入 /exit 或按下更安全的 Ctrl+D 快捷键。

版本无感自动检测与热更新(新增)

  • 彻底抛却命令行维护的烦恼,全平台(Windows, macOS, Linux)生效!
  • 每次打开面板执行 bun run launcher 时,终端会在 1 秒内无感探测并自动拉取 GitHub 的最新代码 (git pull)。
  • 当我(开发者)发布了重要 BUG 修复或黑科技后,你只需日常照常启动,面板就会自动静默更新到最新版本,网页弹窗上也会给你相应的更新功能提醒保障。

面板与终端展示

一键启动面板截图

四种主色调终端拼图

青色主题终端 粉色主题终端

紫色主题终端 蓝色主题终端


从源码中发现的 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')

Buddy legendary 五星宠物随机抽取示例


2. KAIROS — 永不关机的 Claude

源码位置:src/assistant/src/proactive/src/services/autoDream/

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

  • 跨会话持久运行:通过 .claude/settings.jsonassistant: 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_kairostengu_onyx_plover(Dream 阈值配置)

3. ULTRAPLAN — 云端深度规划

源码位置:src/commands/ultraplan.tsxsrc/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.tssrc/commands/

Feature-gated 命令(编译开关控制)

命令 功能 开关
/buddy 宠物系统 BUDDY
/proactive 主动自主模式 PROACTIVE / KAIROS
/assistant 助手模式 KAIROS
/brief 简报模式 KAIROS / KAIROS_BRIEF
/bridge 远程控制桥接 BRIDGE_MODE
/voice 语音模式 VOICE_MODE
/ultraplan 云端深度规划 ULTRAPLAN
/fork 子代理分叉 FORK_SUBAGENT
/peers 对等通信 UDS_INBOX
/workflows 工作流脚本 WORKFLOW_SCRIPTS
/torch Torch 功能 TORCH
/force-snip 强制历史截断 HISTORY_SNIP

仅内部用户(USER_TYPE === 'ant')命令

命令 功能
/teleport 传送会话到远程/本地
/bughunter 内部 Bug 猎人
/mock-limits 模拟速率限制
/ctx_viz 上下文可视化
/break-cache 强制缓存清除
/ant-trace 内部追踪工具
/good-claude 内部反馈
/agents-platform 智能体平台
/autofix-pr 自动修复 PR
/debug-tool-call 调试工具调用
/reset-limits 重置速率限制

隐藏 CLI 参数

--teleport [session]              恢复传送会话
--remote [description]            创建远程会话
--proactive                       主动模式
--assistant                       助手模式
--brief                           简报模式
--remote-control                  远程控制
--hard-fail                       硬失败模式
--agent-teams                     多代理团队
--dangerously-skip-permissions    跳过所有安全确认(一键运行)

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 个)

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

点击展开全部 50 个编译开关
开关 说明
BUDDY 宠物伴侣系统
KAIROS 持久助手模式
KAIROS_BRIEF 简报模式
KAIROS_CHANNELS 通道通知
KAIROS_GITHUB_WEBHOOKS GitHub Webhook
ULTRAPLAN 云端深度规划
COORDINATOR_MODE 多 Agent 编排
BRIDGE_MODE 远程控制桥接
VOICE_MODE 语音交互
PROACTIVE 主动自主模式
FORK_SUBAGENT 子代理分叉
DAEMON 守护进程模式
UDS_INBOX Unix Socket 收件箱
WORKFLOW_SCRIPTS 工作流脚本
TORCH Torch 功能
MONITOR_TOOL 监控工具
HISTORY_SNIP 历史截断
ANTI_DISTILLATION_CC 反蒸馏保护
BASH_CLASSIFIER Bash 命令分类器
BG_SESSIONS 后台会话
CACHED_MICROCOMPACT 缓存微压缩
CCR_REMOTE_SETUP Web 远程设置
CHICAGO_MCP MCP 扩展(Computer Use)
COMMIT_ATTRIBUTION 提交归属标注
CONNECTOR_TEXT 连接器文本
CONTEXT_COLLAPSE 上下文折叠
COWORKER_TYPE_TELEMETRY 协作者遥测
DOWNLOAD_USER_SETTINGS 下载用户设置
EXPERIMENTAL_SKILL_SEARCH 实验性技能搜索
EXTRACT_MEMORIES 自动提取记忆
FILE_PERSISTENCE 文件持久化
HARD_FAIL 硬失败模式
LODESTONE Lodestone 功能
MCP_SKILLS MCP 技能系统
MEMORY_SHAPE_TELEMETRY 记忆形状遥测
MESSAGE_ACTIONS 消息操作
NATIVE_CLIENT_ATTESTATION 客户端证明
PROMPT_CACHE_BREAK_DETECTION 缓存中断检测
QUICK_SEARCH 快速搜索
REACTIVE_COMPACT 响应式压缩
SLOW_OPERATION_LOGGING 慢操作日志
STREAMLINED_OUTPUT 精简输出
TEAMMEM 团队记忆同步
TEMPLATES 模板/分类器
TERMINAL_PANEL 终端面板
TOKEN_BUDGET Token 预算
TRANSCRIPT_CLASSIFIER 转录分类器
UNATTENDED_RETRY 无人值守重试
UPLOAD_USER_SETTINGS 上传用户设置
BREAK_CACHE_COMMAND 缓存清除注入

第二层:用户类型(USER_TYPE

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

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

开关 控制内容
tengu_kairos KAIROS 助手模式开关
tengu_onyx_plover 自动做梦阈值(间隔/会话数)
tengu_cobalt_frost 语音识别(Nova 3)开关
tengu_ultraplan_model Ultraplan 使用的模型
tengu_ant_model_override 内部用户模型覆盖
tengu_session_memory 会话记忆功能
tengu_max_version_config 自动更新 Kill Switch
tengu_frond_boric 数据接收器 Kill Switch
tengu_herring_clock 团队记忆路径
tengu_sm_config 会话记忆配置

隐藏环境变量速查

点击展开完整环境变量列表
环境变量 说明
ANTHROPIC_MODEL 模型覆盖
CLAUDE_CODE_MAX_OUTPUT_TOKENS 最大输出 token
CLAUDE_CODE_DISABLE_THINKING 禁用思考
CLAUDE_CODE_PROACTIVE 主动模式
CLAUDE_CODE_COORDINATOR_MODE 协调器模式
CLAUDE_CODE_BRIEF 简报模式
CLAUDE_CODE_USE_BEDROCK 使用 AWS Bedrock
CLAUDE_CODE_USE_VERTEX 使用 Google Vertex
CLAUDE_CODE_DISABLE_AUTO_MEMORY 禁用自动记忆
CLAUDE_CODE_EXTRA_BODY API 附加 JSON
CLAUDE_CODE_SYNTAX_HIGHLIGHT 语法高亮主题
CLAUDE_CODE_IDLE_THRESHOLD_MINUTES 空闲阈值(默认 75 分钟)
CLAUDE_INTERNAL_FC_OVERRIDES GrowthBook 覆盖(仅 ant)

项目结构

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/                 # 原生绑定源码

数据来源


开源标准与协作规范

许可证与版权

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

安全与隐私

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

Issue 与 PR 规范

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

版本与兼容性承诺

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

声明

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

请作者喝杯咖啡

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

支付宝赞助二维码 微信赞助二维码

⭐ Star 趋势

⭐ Star History Chart

About

Mashang Claude Code: 社区增强版 Claude Code 工具集,支持一键启动面板、多服务商接入与开发者模式。

Topics

Resources

License

Stars

Watchers

Forks