基于
@anthropic-ai/claude-code还原源码进行二次开发,当前版本重点增强:一键启动面板、多服务商接入、开发者模式功能开关。
Important
感谢每一位关注、使用和 Star 本项目的朋友!
经过认真考虑,本项目将停止主动维护和功能更新。随着社区生态的不断发展,目前已有 CC Switch 等优秀的开源工具可以更好地满足 Claude Code 多服务商配置管理的需求,且无需修改源码、维护成本更低。
本仓库将保持公开可访问状态,现有代码和文档依然可以正常使用。如果你觉得这个项目的思路对你有帮助,非常欢迎:
- 🍴 Fork 本仓库,在此基础上继续开发你自己的增强版本
- 📖 参考文档中的隐藏功能梳理,用于你自己的研究和学习
- 💡 提交 PR,如果你做了有价值的改进,我仍然会审阅和合并
再次感谢大家一路以来的支持,祝各位编码愉快!🎉
— 码上全栈创享家
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.batmacOS / Linux 用户可在终端执行(首次需赋权):
chmod +x mashang-claude-code-launcher.sh # 仅首次
./mashang-claude-code-launcher.shmacOS 用户也可以在 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(超过800毫秒)会直接强行退出,导致聊天历史记录和会话状态丢失。 - 安全防手滑:我们从底层剥离了这一限制。现在长按或多次按下
Ctrl+C只会安全地清空当前输入框(符合标准 Bash/CMD 交互逻辑),绝不自动退出。 - 退出方式:如需退出请主动输入
/exit或按下更安全的Ctrl+D快捷键。
- 彻底抛却命令行维护的烦恼,全平台(Windows, macOS, Linux)生效!
- 每次打开面板执行
bun run launcher时,终端会在 1 秒内无感探测并自动拉取 GitHub 的最新代码 (git pull)。 - 当我(开发者)发布了重要 BUG 修复或黑科技后,你只需日常照常启动,面板就会自动静默更新到最新版本,网页弹窗上也会给你相应的更新功能提醒保障。
通过阅读还原后的 1,987 个 TypeScript 源文件,我们发现了大量未公开的隐藏功能。这些功能通过编译开关(feature())和用户类型(USER_TYPE)进行门控,外部发布版中大部分被裁剪。
源码位置:
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')
源码位置:
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 阈值配置)
源码位置:
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(控制使用的模型)
源码位置:
src/coordinator/
主 Claude 变成纯指挥官,Worker 并行执行任务。
- 角色分离:Coordinator 只有三个工具——派活(Agent)、通信(SendMessage)、停工(Shutdown)
- Worker 机制:Worker 在独立子进程中运行,各自拥有完整工具集
- 核心铁律:系统提示中明确规定"禁止甩锅式委派"——不能把不清楚的需求直接丢给 Worker
- 任务追踪:基于文件的共享任务列表(
~/.claude/tasks/),Coordinator 和 Worker 共同读写 - 编译开关:
feature('COORDINATOR_MODE') - 环境变量:
CLAUDE_CODE_COORDINATOR_MODE
源码位置:
src/commands.ts、src/commands/
| 命令 | 功能 | 开关 |
|---|---|---|
/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 |
| 命令 | 功能 |
|---|---|
/teleport |
传送会话到远程/本地 |
/bughunter |
内部 Bug 猎人 |
/mock-limits |
模拟速率限制 |
/ctx_viz |
上下文可视化 |
/break-cache |
强制缓存清除 |
/ant-trace |
内部追踪工具 |
/good-claude |
内部反馈 |
/agents-platform |
智能体平台 |
/autofix-pr |
自动修复 PR |
/debug-tool-call |
调试工具调用 |
/reset-limits |
重置速率限制 |
--teleport [session] 恢复传送会话
--remote [description] 创建远程会话
--proactive 主动模式
--assistant 助手模式
--brief 简报模式
--remote-control 远程控制
--hard-fail 硬失败模式
--agent-teams 多代理团队
--dangerously-skip-permissions 跳过所有安全确认(一键运行)
源码位置:
src/bridge/(34 个文件)
从 claude.ai 或手机直接操控本地 CLI。
- WebSocket 实时连接:本地 CLI 通过 WebSocket 与 claude.ai 建立双向通道
- 完整远程控制:远程端可以发送消息、批准权限、查看输出
- 进程间通信:跨 Claude 会话的消息传递机制
- 状态同步:
bridgeStatusUtil.ts实时同步运行状态 - 权限回调:
bridgePermissionCallbacks.ts远程权限审批 - 编译开关:
feature('BRIDGE_MODE')、feature('DAEMON')
外部发布版是阉割版。Anthropic 通过三层门控控制功能:
构建时决定代码包含/排除,以下是完整列表:
点击展开全部 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 |
缓存清除注入 |
ant(Anthropic 内部)— 解锁全部功能、20 分钟 GrowthBook 刷新、调试工具、200+ 处专属检查external(外部用户)— 裁剪版,6 小时 GrowthBook 刷新
| 开关 | 控制内容 |
|---|---|
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/ # 原生绑定源码
- npm 包:@anthropic-ai/claude-code
- 还原方式:提取
cli.js.map中的sourcesContent
- 本项目是社区二开增强,保持对上游版权与来源的明确标注。
- 请在二次分发时保留本 README 的来源声明与版权说明。
- 不要将真实 API Key 提交到仓库(
.launcher-config.json已在.gitignore中)。 - 提交前请检查日志、截图、示例配置是否含敏感信息。
- Bug 反馈请包含:复现步骤、环境信息、错误输出。
- PR 建议保持“小步提交”,一类改动一个 PR,便于审查与回滚。
- 涉及 UI 变更请附截图,涉及行为变更请附验证步骤。
- 优先保证已有用户配置可继续工作(不破坏现有启动链路)。
- 对新增门控功能,默认策略是“缺模块自动降级,不阻断启动”。
- 源码版权归 Anthropic 所有
- 仅用于技术研究与学习,请勿用于商业用途
- 如有侵权,请联系删除
- 如果有问题请提交 PR,联系作者进行新增或者修改。
如果这个项目帮你省了时间、解决了问题,可以赞助一杯咖啡,支持后续维护与功能迭代。








