[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-numman-ali--cc-mirror":3,"tool-numman-ali--cc-mirror":64},[4,17,25,39,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":26,"name":27,"github_repo":28,"description_zh":29,"stars":30,"difficulty_score":10,"last_commit_at":31,"category_tags":32,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[33,34,35,36,14,37,15,13,38],"图像","数据工具","视频","插件","其他","音频",{"id":40,"name":41,"github_repo":42,"description_zh":43,"stars":44,"difficulty_score":45,"last_commit_at":46,"category_tags":47,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,3,"2026-04-04T04:44:48",[14,33,13,15,37],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":45,"last_commit_at":54,"category_tags":55,"status":16},519,"PaddleOCR","PaddlePaddle\u002FPaddleOCR","PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来，转换成计算机可读取的结构化数据，让机器真正“看懂”图文内容。\n\n面对海量纸质或电子文档，PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域，它扮演着连接图像与大型语言模型（LLM）的桥梁角色，能将视觉信息直接转化为文本输入，助力智能问答、文档分析等应用场景落地。\n\nPaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显：不仅支持全球 100 多种语言的识别，还能在 Windows、Linux、macOS 等多个系统上运行，并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目，PaddleOCR 既能满足快速集成的需求，也能支撑前沿的视觉语言研究，是处理文字识别任务的理想选择。",74913,"2026-04-05T10:44:17",[15,33,13,37],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":45,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[15,14,13,36],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":81,"owner_twitter":82,"owner_website":83,"owner_url":84,"languages":85,"stars":94,"forks":95,"last_commit_at":96,"license":97,"difficulty_score":10,"env_os":98,"env_gpu":99,"env_ram":99,"env_deps":100,"category_tags":106,"github_topics":83,"view_count":10,"oss_zip_url":83,"oss_zip_packed_at":83,"status":16,"created_at":107,"updated_at":108,"faqs":109,"releases":140},3875,"numman-ali\u002Fcc-mirror","cc-mirror","Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, LiteLLM)","cc-mirror 是一款专为 Claude Code 打造的增强型管理工具，旨在帮助用户轻松创建多个完全隔离的 Claude Code 实例。它解决了原生 Claude Code 配置单一、难以灵活切换不同 AI 模型提供商（如 Z.ai、MiniMax、OpenRouter 等）以及自定义环境受限的痛点。\n\n通过 cc-mirror，用户可以一键生成独立的变体版本，每个实例拥有专属的配置文件、会话记录、MCP 服务器连接及 API 密钥，确保在尝试不同模型或提示词包时，主程序环境不受任何干扰。其核心技术亮点在于“隔离化部署”与“预配置集成”，不仅支持自由锁定稳定版或最新版内核，还内置了经过验证的主题优化和技能扩展包。\n\n这款工具特别适合需要频繁测试不同大模型能力的开发者、AI 研究人员以及希望深度定制编码助手的高级用户。无论是想体验国产大模型在编程场景的表现，还是构建多套并行的开发工作流，cc-mirror 都能通过简单的命令让配置过程变得高效且安全，让用户专注于代码创作而非环境调试。","# CC-MIRROR\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_cc-mirror_readme_c4fbfe72d2ff.png\" alt=\"CC-MIRROR Provider Themes\" width=\"800\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fcc-mirror\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fcc-mirror.svg\" alt=\"npm version\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg\" alt=\"License: MIT\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fnummanali\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fnummanali?style=social\" alt=\"Twitter Follow\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch2 align=\"center\">Claude Code, Unshackled\u003C\u002Fh2>\n\n\u003Cp align=\"center\">\n  Pre-configured Claude Code variants with custom providers,\u003Cbr>\n  prompt packs, and battle-tested enhancements.\u003Cbr>\u003Cbr>\n  \u003Cstrong>One command. Instant power-up.\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n---\n\n## Quick Start\n\n```bash\n# Fastest path to a configured Claude Code variant\nnpx cc-mirror quick --provider mirror --name mclaude\n\n# Run it\nmclaude\n```\n\nThat's it. You now have a Claude Code variant ready to run.\n\n### Claude Code Version (Stable\u002FLatest\u002FPin)\n\nBy default, CC-MIRROR installs the **latest** Claude Code native release. You can pin a channel or version:\n\n```bash\n# Track upstream stable channel\nnpx cc-mirror quick --provider mirror --name mclaude --claude-version stable\n\n# Track upstream latest channel\nnpx cc-mirror update mclaude --claude-version latest\n\n# Pin a specific version\nnpx cc-mirror update mclaude --claude-version 2.1.37\n```\n\nNotes:\n\n- `stable` and `latest` are upstream channels. `stable` may lag behind `latest` (that is normal).\n- cc-mirror resolves the channel to a concrete version during install\u002Fupdate and stores it in `variant.json`.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_cc-mirror_readme_f9be9fd984cf.png\" alt=\"CC-MIRROR Home Screen\" width=\"600\">\n\u003C\u002Fp>\n\n### Or use the interactive wizard\n\n```bash\nnpx cc-mirror\n```\n\n---\n\n## What is CC-MIRROR?\n\nCC-MIRROR is an **opinionated Claude Code distribution**. We did the hacking — you get the superpowers.\n\nAt its core, CC-MIRROR:\n\n1. **Clones** Claude Code into isolated instances\n2. **Configures** provider endpoints, model mapping, and env defaults\n3. **Applies** prompt packs and tweakcc themes\n4. **Installs** optional skills (dev-browser, opt-in)\n5. **Packages** everything into a single command\n\nEach variant is completely isolated — its own config, sessions, MCP servers, and credentials. Your main Claude Code installation stays untouched.\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│  ~\u002F.cc-mirror\u002F                                                          │\n│                                                                         │\n│  ├── mclaude\u002F                        ← Mirror Claude                     │\n│  │   ├── native\u002F                     Claude Code installation           │\n│  │   ├── config\u002F                     API keys, sessions, MCP servers    │\n│  │   ├── tweakcc\u002F                    Theme customization                │\n│  │   └── variant.json                Metadata                           │\n│  │                                                                      │\n│  ├── zai\u002F                            ← Z.ai variant (GLM models)        │\n│  ├── minimax\u002F                        ← MiniMax variant (M2.5)           │\n│  └── kimi\u002F                           ← Kimi Code variant (kimi-for-coding) │\n│                                                                         │\n│  Wrappers: \u003Cbin-dir>\u002Fmclaude, \u003Cbin-dir>\u002Fzai, ...                        │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\nDefault `\u003Cbin-dir>` is `~\u002F.local\u002Fbin` on macOS\u002FLinux and `~\u002F.cc-mirror\u002Fbin` on Windows.\n\n**Windows tip:** add `%USERPROFILE%\\.cc-mirror\\bin` to your `PATH`, or run the `\u003Cvariant>.cmd` wrapper directly. Each wrapper has a sibling `\u003Cvariant>.mjs` launcher.\n\n---\n\n## Providers\n\n### Mirror Claude (Recommended)\n\nThe purest path to vanilla Claude Code. No proxy, no model changes — just clean isolation.\n\n```bash\nnpx cc-mirror quick --provider mirror --name mclaude\n```\n\n- **Direct Anthropic API** — No proxy, authenticate normally (OAuth or API key)\n- **Isolated config** — Experiment without affecting your main setup\n- **Provider presets** — Clean defaults without hidden patches\n\n### Alternative Providers\n\nWant to use different models? CC-MIRROR supports multiple providers:\n\n| Provider       | Models                 | Auth       | Best For                        |\n| -------------- | ---------------------- | ---------- | ------------------------------- |\n| **Kimi**       | kimi-for-coding        | API Key    | Long-context coding (Kimi Code) |\n| **MiniMax**    | MiniMax-M2.5           | API Key    | Unified model experience        |\n| **Z.ai**       | GLM-5, 4.7, 4.5-Air    | API Key    | Heavy coding with GLM reasoning |\n| **OpenRouter** | 100+ models            | Auth Token | Model flexibility, pay-per-use  |\n| **Vercel**     | Multi-provider gateway | Auth Token | Vercel AI Gateway               |\n| **Ollama**     | Local + cloud models   | Auth Token | Local-first + hybrid setups     |\n| **NanoGPT**    | Claude Code endpoint   | Auth Token | Simple endpoint setup           |\n| **CCRouter**   | Ollama, DeepSeek, etc. | Optional   | Local-first development         |\n| **GatewayZ**   | Multi-provider gateway | Auth Token | Centralized routing             |\n\n### Provider Setup Links\n\n| Provider       | Subscribe                                                     | Get Key\u002FToken                                                    | Docs                                                             |\n| -------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |\n| **Kimi**       | https:\u002F\u002Fwww.kimi.com\u002Fcode                                     | https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fconsole                                | https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fdocs\u002Fen\u002Fmore\u002Fthird-party-agents.html   |\n| **MiniMax**    | https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan             | https:\u002F\u002Fplatform.minimax.io\u002Fuser-center\u002Fpayment\u002Fcoding-plan      | https:\u002F\u002Fplatform.minimax.io\u002Fdocs                                 |\n| **Z.ai**       | https:\u002F\u002Fz.ai\u002Fsubscribe                                        | https:\u002F\u002Fz.ai\u002Fmanage-apikey\u002Fapikey-list                           | https:\u002F\u002Fz.ai\u002Fdocs                                                |\n| **OpenRouter** | https:\u002F\u002Fopenrouter.ai\u002Faccount                                 | https:\u002F\u002Fopenrouter.ai\u002Fkeys                                       | https:\u002F\u002Fopenrouter.ai\u002Fdocs                                       |\n| **Vercel**     | https:\u002F\u002Fvercel.com\u002Fai                                         | https:\u002F\u002Fvercel.com\u002Faccount\u002Ftokens                                | https:\u002F\u002Fvercel.com\u002Fdocs\u002Fai-gateway                               |\n| **Ollama**     | https:\u002F\u002Follama.com                                            | https:\u002F\u002Follama.com                                               | https:\u002F\u002Fdocs.ollama.com\u002Fapi\u002Fanthropic-compatibility              |\n| **NanoGPT**    | https:\u002F\u002Fnano-gpt.com                                          | https:\u002F\u002Fnano-gpt.com                                             | https:\u002F\u002Fdocs.nano-gpt.com\u002Fdocs\u002Fanthropic-compatibility           |\n| **CCRouter**   | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#installation | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#2-configuration | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#2-configuration |\n| **GatewayZ**   | https:\u002F\u002Fgatewayz.ai                                           | https:\u002F\u002Fgatewayz.ai                                              | https:\u002F\u002Fdocs.gatewayz.ai\u002Fdocs\u002Fanthropic-compatibility            |\n\n```bash\n# Kimi Code (kimi-for-coding)\nnpx cc-mirror quick --provider kimi --api-key \"$KIMI_API_KEY\"\n\n# MiniMax (MiniMax-M2.5)\nnpx cc-mirror quick --provider minimax --api-key \"$MINIMAX_API_KEY\"\n\n# Z.ai (GLM-5\u002F4.7\u002F4.5-Air)\nnpx cc-mirror quick --provider zai --api-key \"$Z_AI_API_KEY\"\n\n# OpenRouter (100+ models)\nnpx cc-mirror quick --provider openrouter --api-key \"$OPENROUTER_API_KEY\" \\\n  --model-sonnet \"anthropic\u002Fclaude-sonnet-4-20250514\"\n\n# Vercel AI Gateway\nnpx cc-mirror quick --provider vercel --api-key \"$VERCEL_AI_GATEWAY_KEY\" \\\n  --model-sonnet \"anthropic\u002Fclaude-3-5-sonnet-20241022\"\n\n# Ollama\nnpx cc-mirror quick --provider ollama --api-key \"ollama\" \\\n  --model-sonnet \"qwen3-coder\" --model-opus \"qwen3-coder\" --model-haiku \"qwen3-coder\"\n\n# NanoGPT\nnpx cc-mirror quick --provider nanogpt --api-key \"$NANOGPT_API_KEY\"\n\n# CC Router (local LLMs)\nnpx cc-mirror quick --provider ccrouter\n\n# GatewayZ\nnpx cc-mirror quick --provider gatewayz --api-key \"$GATEWAYZ_API_KEY\" \\\n  --model-sonnet \"claude-3-5-sonnet-20241022\"\n```\n\n---\n\n## All Commands\n\n```bash\n# Create & manage variants\nnpx cc-mirror                     # Interactive TUI\nnpx cc-mirror quick [options]     # Fast setup with defaults\nnpx cc-mirror create [options]    # Full configuration wizard\nnpx cc-mirror list                # List all variants\nnpx cc-mirror update [name]       # Update one or all variants\nnpx cc-mirror apply \u003Cname>        # Re-apply tweakcc patches (no reinstall)\nnpx cc-mirror remove \u003Cname>       # Delete a variant\nnpx cc-mirror doctor              # Health check all variants\nnpx cc-mirror tweak \u003Cname>        # Launch tweakcc customization\n\n# Launch your variant\nmclaude                           # Run Mirror Claude\nzai                               # Run Z.ai variant\nminimax                           # Run MiniMax variant\nkimi                              # Run Kimi Code variant\n```\n\n---\n\n## CLI Options\n\n```\n--provider \u003Cname>        kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz | custom\n--name \u003Cname>            Variant name (becomes the CLI command)\n--api-key \u003Ckey>          Provider API key\n--base-url \u003Curl>         Custom API endpoint\n--model-sonnet \u003Cname>    Map to sonnet model\n--model-opus \u003Cname>      Map to opus model\n--model-haiku \u003Cname>     Map to haiku model\n--brand \u003Cpreset>         Theme: auto | kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz\n--no-tweak               Skip tweakcc theme\n--no-prompt-pack         Skip provider prompt pack\n--verbose               Show full tweakcc output during update\n```\n\n---\n\n## Brand Themes\n\nEach provider includes a custom color theme via [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc):\n\n| Brand          | Style                            |\n| -------------- | -------------------------------- |\n| **kimi**       | Teal\u002Fcyan gradient               |\n| **minimax**    | Coral\u002Fred\u002Forange spectrum        |\n| **zai**        | Dark carbon with gold accents    |\n| **openrouter** | Silver\u002Fchrome with electric blue |\n| **vercel**     | Monochrome with green accents    |\n| **ollama**     | Warm sandstone with earthy tones |\n| **nanogpt**    | Aurora green + cyan accents      |\n| **ccrouter**   | Sky blue accents                 |\n| **gatewayz**   | Violet gradients                 |\n\n---\n\n## Documentation\n\n| Document                                        | Description                          |\n| ----------------------------------------------- | ------------------------------------ |\n| [Mirror Claude](docs\u002Ffeatures\u002Fmirror-claude.md) | Pure Claude Code with clean defaults |\n| [Architecture](docs\u002Farchitecture\u002Foverview.md)   | How CC-MIRROR works under the hood   |\n| [Full Documentation](docs\u002FREADME.md)            | Complete documentation index         |\n\n---\n\n## Related Projects\n\n- [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc) — Theme and customize Claude Code\n- [Claude Code Router](https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router) — Route Claude Code to any LLM\n- [n-skills](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fn-skills) — Universal skills for AI agents\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.\n\n**Want to add a provider?** Check the [Provider Guide](docs\u002FTWEAKCC-GUIDE.md).\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cstrong>Created by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnumman-ali\">Numman Ali\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fnummanali\">@nummanali\u003C\u002Fa>\n\u003C\u002Fp>\n","# CC-MIRROR\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_cc-mirror_readme_c4fbfe72d2ff.png\" alt=\"CC-MIRROR 提供商主题\" width=\"800\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fcc-mirror\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fcc-mirror.svg\" alt=\"npm 版本\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg\" alt=\"许可证：MIT\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fnummanali\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fnummanali?style=social\" alt=\"Twitter 关注\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch2 align=\"center\">Claude Code，无拘无束\u003C\u002Fh2>\n\n\u003Cp align=\"center\">\n  预配置的 Claude Code 变体，配备自定义提供商、提示词包和久经考验的增强功能。\u003Cbr>\n  \u003Cstrong>一条命令，即刻获得强大功能。\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n---\n\n## 快速入门\n\n```bash\n# 配置 Claude Code 变体的最快方式\nnpx cc-mirror quick --provider mirror --name mclaude\n\n# 运行它\nmclaude\n```\n\n就是这样。你现在就拥有了一个可以立即运行的 Claude Code 变体。\n\n### Claude Code 版本（稳定版\u002F最新版\u002F固定版本）\n\n默认情况下，CC-MIRROR 会安装 **最新** 的 Claude Code 原生版本。你可以锁定某个渠道或版本：\n\n```bash\n# 跟踪上游稳定渠道\nnpx cc-mirror quick --provider mirror --name mclaude --claude-version stable\n\n# 跟踪上游最新渠道\nnpx cc-mirror update mclaude --claude-version latest\n\n# 锁定特定版本\nnpx cc-mirror update mclaude --claude-version 2.1.37\n```\n\n注意事项：\n\n- `stable` 和 `latest` 是上游渠道。`stable` 可能会落后于 `latest`（这是正常的）。\n- cc-mirror 在安装或更新时会将渠道解析为具体版本，并将其存储在 `variant.json` 中。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_cc-mirror_readme_f9be9fd984cf.png\" alt=\"CC-MIRROR 主屏幕\" width=\"600\">\n\u003C\u002Fp>\n\n### 或者使用交互式向导\n\n```bash\nnpx cc-mirror\n```\n\n---\n\n## 什么是 CC-MIRROR？\n\nCC-MIRROR 是一个 **有明确立场的 Claude Code 发行版**。我们完成了底层工作，你只需享受这些强大的功能。\n\n从本质上讲，CC-MIRROR：\n\n1. **克隆** Claude Code 到隔离的实例中\n2. **配置** 提供商端点、模型映射和环境默认值\n3. **应用** 提示词包和 tweakcc 主题\n4. **安装** 可选技能（开发浏览器等）\n5. **打包** 所有内容到一个命令中\n\n每个变体都是完全隔离的——拥有独立的配置、会话、MCP 服务器和凭据。你的主 Claude Code 安装不会受到影响。\n\n```\n┌─────────────────────────────────────────────────────────────────────────┐\n│  ~\u002F.cc-mirror\u002F                                                          │\n│                                                                         │\n│  ├── mclaude\u002F                        ← Mirror Claude                     │\n│  │   ├── native\u002F                     Claude Code 安装                   │\n│  │   ├── config\u002F                     API 密钥、会话、MCP 服务器       │\n│  │   ├── tweakcc\u002F                    主题定制                             │\n│  │   └── variant.json                元数据                               │\n│  │                                                                      │\n│  ├── zai\u002F                            ← Z.ai 变体（GLM 模型）             │\n│  ├── minimax\u002F                        ← MiniMax 变体（M2.5）               │\n│  └── kimi\u002F                           ← Kimi Code 变体（kimi-for-coding）    │\n│                                                                         │\n│  包装器：\u003Cbin-dir>\u002Fmclaude, \u003Cbin-dir>\u002Fzai, ...                         │\n└─────────────────────────────────────────────────────────────────────────┘\n```\n\n默认的 `\u003Cbin-dir>` 在 macOS\u002FLinux 上是 `~\u002F.local\u002Fbin`，而在 Windows 上则是 `~\u002F.cc-mirror\u002Fbin`。\n\n**Windows 小贴士：** 将 `%USERPROFILE%\\.cc-mirror\\bin` 添加到你的 `PATH` 中，或者直接运行 `\u003Cvariant>.cmd` 包装器。每个包装器都有一个同名的 `\u003Cvariant>.mjs` 启动脚本。\n\n---\n\n## 提供商\n\n### Mirror Claude（推荐）\n\n通往原汁原味 Claude Code 的最纯净路径。无需代理，不更改模型——只有纯粹的隔离。\n\n```bash\nnpx cc-mirror quick --provider mirror --name mclaude\n```\n\n- **直接 Anthropic API** — 无需代理，正常认证（OAuth 或 API 密钥）\n- **隔离配置** — 可以自由实验，而不影响你的主设置\n- **提供商预设** — 干净的默认设置，没有隐藏补丁\n\n### 其他提供商\n\n想使用不同的模型吗？CC-MIRROR 支持多种提供商：\n\n| 提供商       | 模型                 | 认证       | 最适合场景                        |\n| -------------- | ---------------------- | ---------- | ------------------------------- |\n| **Kimi**       | kimi-for-coding        | API Key    | 长上下文编码（Kimi Code）         |\n| **MiniMax**    | MiniMax-M2.5           | API Key    | 统一的模型体验                  |\n| **Z.ai**       | GLM-5, 4.7, 4.5-Air    | API Key    | 大量编码与 GLM 推理              |\n| **OpenRouter** | 100+ 模型            | 认证令牌   | 模型灵活性，按使用付费          |\n| **Vercel**     | 多提供商网关           | 认证令牌   | Vercel AI 网关                   |\n| **Ollama**     | 本地 + 云上模型       | 认证令牌   | 本地优先 + 混合部署              |\n| **NanoGPT**    | Claude Code 端点       | 认证令牌   | 简单的端点设置                  |\n| **CCRouter**   | Ollama、DeepSeek 等    | 可选       | 本地优先开发                    |\n| **GatewayZ**   | 多提供商网关           | 认证令牌   | 集中式路由                      |\n\n### 供应商设置链接\n\n| 供应商       | 订阅                                                     | 获取密钥\u002F令牌                                                    | 文档                                                             |\n| -------------- | ------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |\n| **Kimi**       | https:\u002F\u002Fwww.kimi.com\u002Fcode                                     | https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fconsole                                | https:\u002F\u002Fwww.kimi.com\u002Fcode\u002Fdocs\u002Fen\u002Fmore\u002Fthird-party-agents.html   |\n| **MiniMax**    | https:\u002F\u002Fplatform.minimax.io\u002Fsubscribe\u002Fcoding-plan             | https:\u002F\u002Fplatform.minimax.io\u002Fuser-center\u002Fpayment\u002Fcoding-plan      | https:\u002F\u002Fplatform.minimax.io\u002Fdocs                                 |\n| **Z.ai**       | https:\u002F\u002Fz.ai\u002Fsubscribe                                        | https:\u002F\u002Fz.ai\u002Fmanage-apikey\u002Fapikey-list                           | https:\u002F\u002Fz.ai\u002Fdocs                                                |\n| **OpenRouter** | https:\u002F\u002Fopenrouter.ai\u002Faccount                                 | https:\u002F\u002Fopenrouter.ai\u002Fkeys                                       | https:\u002F\u002Fopenrouter.ai\u002Fdocs                                       |\n| **Vercel**     | https:\u002F\u002Fvercel.com\u002Fai                                         | https:\u002F\u002Fvercel.com\u002Faccount\u002Ftokens                                | https:\u002F\u002Fvercel.com\u002Fdocs\u002Fai-gateway                               |\n| **Ollama**     | https:\u002F\u002Follama.com                                            | https:\u002F\u002Follama.com                                               | https:\u002F\u002Fdocs.ollama.com\u002Fapi\u002Fanthropic-compatibility              |\n| **NanoGPT**    | https:\u002F\u002Fnano-gpt.com                                          | https:\u002F\u002Fnano-gpt.com                                             | https:\u002F\u002Fdocs.nano-gpt.com\u002Fdocs\u002Fanthropic-compatibility           |\n| **CCRouter**   | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#installation | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#2-configuration | https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router#2-configuration |\n| **GatewayZ**   | https:\u002F\u002Fgatewayz.ai                                           | https:\u002F\u002Fgatewayz.ai                                              | https:\u002F\u002Fdocs.gatewayz.ai\u002Fdocs\u002Fanthropic-compatibility            |\n\n```bash\n# Kimi Code (kimi-for-coding)\nnpx cc-mirror quick --provider kimi --api-key \"$KIMI_API_KEY\"\n\n# MiniMax (MiniMax-M2.5)\nnpx cc-mirror quick --provider minimax --api-key \"$MINIMAX_API_KEY\"\n\n# Z.ai (GLM-5\u002F4.7\u002F4.5-Air)\nnpx cc-mirror quick --provider zai --api-key \"$Z_AI_API_KEY\"\n\n# OpenRouter (100+ models)\nnpx cc-mirror quick --provider openrouter --api-key \"$OPENROUTER_API_KEY\" \\\n  --model-sonnet \"anthropic\u002Fclaude-sonnet-4-20250514\"\n\n# Vercel AI Gateway\nnpx cc-mirror quick --provider vercel --api-key \"$VERCEL_AI_GATEWAY_KEY\" \\\n  --model-sonnet \"anthropic\u002Fclaude-3-5-sonnet-20241022\"\n\n# Ollama\nnpx cc-mirror quick --provider ollama --api-key \"ollama\" \\\n  --model-sonnet \"qwen3-coder\" --model-opus \"qwen3-coder\" --model-haiku \"qwen3-coder\"\n\n# NanoGPT\nnpx cc-mirror quick --provider nanogpt --api-key \"$NANOGPT_API_KEY\"\n\n# CC Router (local LLMs)\nnpx cc-mirror quick --provider ccrouter\n\n# GatewayZ\nnpx cc-mirror quick --provider gatewayz --api-key \"$GATEWAYZ_API_KEY\" \\\n  --model-sonnet \"claude-3-5-sonnet-20241022\"\n```\n\n---\n\n## 所有命令\n\n```bash\n# 创建与管理变体\nnpx cc-mirror                     # 交互式 TUI\nnpx cc-mirror quick [options]     # 快速设置，默认配置\nnpx cc-mirror create [options]    # 完整配置向导\nnpx cc-mirror list                # 列出所有变体\nnpx cc-mirror update [name]       # 更新单个或所有变体\nnpx cc-mirror apply \u003Cname>        # 重新应用 tweakcc 补丁（无需重新安装）\nnpx cc-mirror remove \u003Cname>       # 删除一个变体\nnpx cc-mirror doctor              # 检查所有变体的健康状况\nnpx cc-mirror tweak \u003Cname>        # 启动 tweakcc 自定义\n\n# 启动你的变体\nmclaude                           # 运行 Mirror Claude\nzai                               # 运行 Z.ai 变体\nminimax                           # 运行 MiniMax 变体\nkimi                              # 运行 Kimi Code 变体\n```\n\n---\n\n## CLI 选项\n\n```\n--provider \u003Cname>        kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz | custom\n--name \u003Cname>            变体名称（成为 CLI 命令）\n--api-key \u003Ckey>          供应商 API 密钥\n--base-url \u003Curl>         自定义 API 端点\n--model-sonnet \u003Cname>    映射到 sonnet 模型\n--model-opus \u003Cname>      映射到 opus 模型\n--model-haiku \u003Cname>     映射到 haiku 模型\n--brand \u003Cpreset>         主题：auto | kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz\n--no-tweak               跳过 tweakcc 主题\n--no-prompt-pack         跳过供应商提示包\n--verbose               更新时显示完整的 tweakcc 输出\n```\n\n---\n\n## 品牌主题\n\n每个供应商都通过 [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc) 提供自定义颜色主题：\n\n| 品牌          | 风格                            |\n| -------------- | -------------------------------- |\n| **kimi**       | 绿松石\u002F青色渐变               |\n| **minimax**    | 珊瑚色\u002F红色\u002F橙色光谱        |\n| **zai**        | 深碳色配金色点缀            |\n| **openrouter** | 银色\u002F铬色搭配电蓝色          |\n| **vercel**     | 单色配绿色点缀              |\n| **ollama**     | 温暖砂岩色配大地色调        |\n| **nanogpt**    | 极光绿加青色点缀            |\n| **ccrouter**   | 天蓝色点缀                  |\n| **gatewayz**   | 紫色渐变                    |\n\n---\n\n## 文档\n\n| 文档                                        | 描述                          |\n| ----------------------------------------------- | ------------------------------------ |\n| [Mirror Claude](docs\u002Ffeatures\u002Fmirror-claude.md) | 纯 Claude Code，干净默认配置 |\n| [架构](docs\u002Farchitecture\u002Foverview.md)           | CC-MIRROR 的工作原理         |\n| [完整文档](docs\u002FREADME.md)                    | 完整文档索引                 |\n\n---\n\n## 相关项目\n\n- [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc) — 为 Claude Code 定制主题\n- [Claude Code Router](https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router) — 将 Claude Code 路由到任何 LLM\n- [n-skills](https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fn-skills) — 适用于 AI 代理的通用技能\n\n---\n\n## 贡献\n\n欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解开发设置。\n\n**想添加一个供应商吗？** 请查看 [供应商指南](docs\u002FTWEAKCC-GUIDE.md)。\n\n---\n\n## 许可证\n\nMIT — 详见 [LICENSE](LICENSE)\n\n---\n\n\u003Cp align=\"center\">\n  \u003Cstrong>由 \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnumman-ali\">Numman Ali\u003C\u002Fa> 创建\u003C\u002Fstrong>\u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fnummanali\">@nummanali\u003C\u002Fa>\n\u003C\u002Fp>","# CC-MIRROR 快速上手指南\n\nCC-MIRROR 是一个专为 Claude Code 设计的增强版分发工具。它允许你一键创建隔离的 Claude Code 实例，支持自定义模型提供商（如 Kimi、MiniMax、Z.ai 等）、预设提示词包以及主题定制，且不会干扰原有的 Claude Code 安装。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**: macOS, Linux 或 Windows\n*   **Node.js**: 已安装 Node.js (推荐 v18 或更高版本)，因为该工具通过 `npx` 运行。\n*   **Claude Code**: 虽然 CC-MIRROR 会自动处理核心文件，但建议本地已具备运行 Claude Code 的基础环境。\n*   **网络环境**: \n    *   若使用 **Mirror Claude** (官方 Anthropic API)，需确保网络可直达或通过代理配置。\n    *   若使用 **国内模型** (Kimi, MiniMax, Z.ai 等)，可直接连接，无需特殊网络配置。\n*   **路径配置 (Windows 用户)**: \n    *   建议将 `%USERPROFILE%\\.cc-mirror\\bin` 添加到系统 `PATH` 环境变量中，以便直接通过命令启动变体。\n    *   或者，直接进入该目录运行 `\u003Cvariant>.cmd` 文件。\n\n## 安装步骤\n\nCC-MIRROR 无需全局安装，推荐使用 `npx` 直接运行最新版本的交互式向导或快速命令。\n\n### 方式一：交互式向导（推荐新手）\n\n运行以下命令启动图形化配置向导，按提示选择提供商和模型：\n\n```bash\nnpx cc-mirror\n```\n\n### 方式二：命令行快速创建\n\n如果你已经确定要使用的提供商，可以使用 `quick` 命令一键生成。\n\n**示例：创建名为 `mclaude` 的镜像实例（使用官方 Anthropic API）**\n\n```bash\nnpx cc-mirror quick --provider mirror --name mclaude\n```\n\n**示例：创建名为 `kimi` 的实例（使用月之暗面 Kimi 模型）**\n\n请提前准备好 API Key，并替换下方命令中的 `$KIMI_API_KEY`：\n\n```bash\nnpx cc-mirror quick --provider kimi --api-key \"$KIMI_API_KEY\"\n```\n\n> **注意**：安装完成后，工具会自动在 `~\u002F.local\u002Fbin` (macOS\u002FLinux) 或 `~\u002F.cc-mirror\\bin` (Windows) 生成对应的启动命令（如 `mclaude`, `kimi` 等）。\n\n## 基本使用\n\n安装完成后，你可以像使用原生 `claude` 命令一样使用新生成的变体命令。每个变体拥有独立的配置文件、会话记录和 MCP 服务器设置。\n\n### 1. 启动变体\n\n直接使用安装时指定的名称作为命令：\n\n```bash\n# 启动刚才创建的 mclaude 实例\nmclaude\n\n# 启动 kimi 实例\nkimi\n```\n\n### 2. 管理版本通道\n\n默认情况下，CC-MIRROR 会安装最新的 Claude Code 版本。你可以指定跟踪稳定版或锁定特定版本：\n\n```bash\n# 跟踪上游稳定版通道\nnpx cc-mirror update mclaude --claude-version stable\n\n# 锁定到具体版本号 (例如 2.1.37)\nnpx cc-mirror update mclaude --claude-version 2.1.37\n```\n\n### 3. 常用管理命令\n\n```bash\n# 列出所有已创建的变体\nnpx cc-mirror list\n\n# 更新所有变体到最新版本\nnpx cc-mirror update\n\n# 删除指定的变体\nnpx cc-mirror remove \u003Cname>\n\n# 健康检查\nnpx cc-mirror doctor\n\n# 重新应用主题定制 (不重装)\nnpx cc-mirror apply \u003Cname>\n```\n\n### 4. 切换不同模型提供商\n\nCC-MIRROR 支持多种主流模型提供商，只需在创建时指定不同的 `--provider` 和 `--api-key` 即可：\n\n| 提供商 | 命令示例 | 适用场景 |\n| :--- | :--- | :--- |\n| **Kimi** | `npx cc-mirror quick --provider kimi --api-key \"$KEY\"` | 长上下文代码任务 |\n| **MiniMax** | `npx cc-mirror quick --provider minimax --api-key \"$KEY\"` | 统一模型体验 |\n| **Z.ai** | `npx cc-mirror quick --provider zai --api-key \"$KEY\"` | GLM 系列模型推理 |\n| **Ollama** | `npx cc-mirror quick --provider ollama --api-key \"ollama\"` | 本地大模型优先 |\n\n所有变体均相互隔离，你可以同时拥有多个不同配置的 Claude Code 实例，随时切换使用。","某全栈开发团队需要在同一台机器上并行测试 Claude Code 原生版、国内 Z.ai 模型以及 MiniMax 模型，以评估不同大模型在代码生成任务上的表现差异。\n\n### 没有 cc-mirror 时\n- **环境配置繁琐**：每次切换模型都需要手动修改全局环境变量和 API Key，极易因配置遗漏导致运行报错。\n- **会话数据冲突**：不同模型的对话历史、MCP 服务器配置和凭证混在一起，难以区分哪些上下文属于哪个模型。\n- **版本管理困难**：无法同时保留稳定版和最新版的 Claude Code，升级测试往往需要覆盖原有安装，风险较高。\n- **隔离性差**：尝试为不同模型创建独立配置时，容易误改主程序文件，导致原本正常的开发流程中断。\n\n### 使用 cc-mirror 后\n- **一键生成实例**：通过 `npx cc-mirror quick` 命令即可瞬间创建名为 `zai` 或 `minimax` 的独立变体，自动完成所有端点和密钥配置。\n- **完全物理隔离**：每个变体拥有独立的配置文件、会话记录和 MCP 服务目录，彻底杜绝了上下文混淆问题。\n- **灵活版本控制**：支持将某个变体锁定在特定版本（如 2.1.37），同时让另一个变体追踪最新渠道，满足灰度测试需求。\n- **命令即开即用**：直接在终端输入 `zai` 或 `mclaude` 即可启动对应环境的专属实例，无需任何前置切换操作。\n\ncc-mirror 通过“克隆即隔离”的机制，让开发者能在零干扰的前提下，自由组合并并行运行多个定制化的 AI 编程助手实例。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fnumman-ali_cc-mirror_c4fbfe72.png","numman-ali","Numman Ali","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fnumman-ali_df3cf2a5.png","Applied AI, Enterprise Agentic Coding & Product Strategy | Creator of OpenSkills and more | CTO @ https:\u002F\u002Fwww.retailbook.com (UK FinTech)","RetailBook","UK (Remote)","numman.ali@gmail.com","nummanali",null,"https:\u002F\u002Fgithub.com\u002Fnumman-ali",[86,90],{"name":87,"color":88,"percentage":89},"TypeScript","#3178c6",94.4,{"name":91,"color":92,"percentage":93},"JavaScript","#f1e05a",5.6,2171,289,"2026-04-05T05:04:02","MIT","Linux, macOS, Windows","未说明",{"notes":101,"python":102,"dependencies":103},"该工具是 Claude Code 的包装器和配置管理工具，并非本地运行的 AI 模型，因此不需要 GPU 或大量内存。主要依赖 Node.js 环境（通过 npx 运行）。在 Windows 上需要将 `%USERPROFILE%\\.cc-mirror\\bin` 添加到 PATH 环境变量，或使用提供的 .cmd 包装器直接运行。支持多种 API 提供商（如 Kimi, MiniMax, Z.ai, OpenRouter 等），需自行获取对应的 API Key。","未说明 (基于 Node.js 运行)",[104,105],"Node.js","npm\u002Fnpx",[15,36],"2026-03-27T02:49:30.150509","2026-04-06T07:11:52.067059",[110,115,120,125,130,135],{"id":111,"question_zh":112,"answer_zh":113,"source_url":114},17730,"在 Windows 上安装或运行 cc-mirror 失败怎么办？","此问题通常由版本不匹配或 Windows  shell 兼容性引起。请尝试以下解决方案：\n1. **更新版本**：确保使用最新版本（v1.6.6+），该版本修复了 Windows 包装器和 npm shell 问题。运行 `npx cc-mirror update \u003Cvariant>` 或重新创建变体。\n2. **清理缓存重装**：如果从源码构建仍失败，尝试清除缓存并重装：\n   - 删除缓存目录：`rm -rf ~\u002F.npm\u002F_npx\u002F` (Linux\u002FMac) 或在 Windows 上删除对应文件夹。\n   - 卸载全局包：`npm uninstall -g cc-mirror`。\n   - 重新运行：`npx cc-mirror`。\n3. **检查 Node.js 环境**：确保安装了较新的 Node.js 版本。如果是源码构建，确认 `npm run bundle` 成功，且运行命令时使用 `node dist\u002Fcc-mirror.mjs`。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F7",{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},17731,"按下 Shift+Tab 切换模式时程序崩溃如何解决？","这通常是由于 Claude Code 版本不匹配导致的。解决方法如下：\n1. **移除旧版本并重试**：删除已创建的变体，清除 cc-mirror 缓存（例如运行 `rm -rf ~\u002F.npm\u002F_npx\u002F`），然后重新运行 `npx cc-mirror` 从头开始设置。\n2. **改用二进制安装**：如果通过 npm 安装的版本有问题，可以尝试卸载 npm 版的 Claude Code，改为通过二进制文件（Binary）安装和使用。\n3. **更新软件**：确保 cc-mirror 和底层 Claude Binary 都是最新版本。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F25",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},17732,"更新镜像变体后找不到任务管理器（Task Manager）或只显示编排（Orchestration）怎么办？","这可能是终端会话未刷新导致的。请尝试以下步骤：\n1. **打开新终端**：关闭当前终端窗口，打开一个新的终端会话再次运行。\n2. **强制更新**：在新终端中运行命令 `npx cc-mirror update` 来强制更新变体配置。\n3. **检查启动方式**：如果您之前使用的是 `bunx` 等其他工具，尝试切换回标准的 `npx` 命令看是否恢复正常。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F15",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},17733,"cc-mirror 中的“切换（Switch）”模型是什么意思？可以在会话中直接切换模型吗？","不能在单个活跃会话中直接从一个模型切换到另一个模型。文档中使用的“切换”一词可能会引起误解。\n准确的理解是：**启动一个新的会话实例**。每个变体（Variant）都是隔离的实例。如果您想使用不同的模型（如从 zai 切换到 minimax），需要启动一个新的对应变体的会话，而不是在当前对话中更改。建议将其理解为“快速启动不同模型的新会话”。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F1",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},17734,"如何在生成过程中中断模型输出（如果 Esc 键失效）？","默认情况下，按 `Esc` 键可以中断生成流而不退出应用。如果您的 `Esc` 键失效：\n1. **Ctrl+C 的行为**：目前直接按 `Ctrl+C` 可能会直接杀死应用程序进程，而不仅仅是停止流。\n2. **临时方案**：建议修复键盘映射或使用终端软件的虚拟键盘功能发送 Esc 信号。\n3. **未来改进**：社区已提出补丁建议，希望未来版本能支持将 `Ctrl+C` 配置为中断信号（生成时中断流，空闲时双击退出），但在该功能正式合并前，请优先依赖 `Esc` 键。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F13",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},17735,"在项目文件夹中定义的 Agents 无法被 `\u002Fagents` 命令识别怎么办？","如果在 `.claude\u002Fagents` 文件夹下定义了 Agent 但 `\u002Fagents` 命令无法列出：\n1. **检查路径结构**：确认 Agent 文件确实位于项目根目录下的 `.claude\u002Fagents\u002F` 文件夹内。\n2. **重启会话**：有时新建的文件需要重新启动该变体的会话才能被加载。\n3. **对比原生环境**：如果在原生 Claude 中可以识别但在 cc-mirror 变体中不行，请检查该变体是否正确挂载了项目目录。\n注意：许多用户反馈这是配置路径错误或未刷新导致的问题，重新检查文件位置通常能解决。","https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fissues\u002F40",[141,146,151,156,161,166,171,176,181,186,191],{"id":142,"version":143,"summary_zh":144,"released_at":145},108026,"v2.1.0","v2.1.0\n\n亮点\n- 在较新版本的 Claude Code 二进制文件无法进行原生提取时，新增从固定版本的 tweakcc 自动回退到 tweakcc@latest 的功能\n- 在更新成功完成之前，保留可用的原生二进制文件和封装脚本\n- 将固定版本的 tweakcc 基线升级至 4.0.11，并优化提取错误提示信息\n- 记录回退行为，并更新 tweakcc 使用指南中的示例\n\n验证\n- 完整的预提交发布检查均已通过：代码格式化、类型检查、代码 lint 检查及测试覆盖率\n- npm pack --dry-run 对 cc-mirror@2.1.0 成功执行\n- 修复了本地环境中的损坏变体，并确认 cc-mirror doctor 工具显示一切正常","2026-03-06T13:26:23",{"id":147,"version":148,"summary_zh":149,"released_at":150},108027,"v2.0.1","## 修复\n- Windows：通过 `cmd.exe` + `npx.cmd` 调用 `tweakcc`，以便在 `npx` 无法直接执行时，变体的创建和更新能够可靠地工作。\n- Windows：尽力更新 PATH，以包含变体的 bin 目录（CI 中跳过；可通过设置 `CC_MIRROR_DISABLE_PATH_UPDATE=1` 禁用）。\n- Windows：改进了波浪号展开（`~\\\\`），并且 `list` 命令现在会在读取变体之前先展开波浪号。\n- 文档：修正了 Windows 的 PATH 示例（避免使用双反斜杠转义）。\n\n## CI \u002F 开发\n- CI：在每个 PR 上运行 Windows 全链路冒烟测试（打包 + 快速创建 + list\u002Fdoctor + 包装器）。\n- 测试：增加了对 Windows 下 `tweakcc` 执行和波浪号展开的回归测试覆盖。\n- 代码检查：修复了 `scripts\u002Fpreview-splash-grid.mjs` 中的一个未使用的变量（macOS CI）。","2026-02-15T11:36:19",{"id":152,"version":153,"summary_zh":154,"released_at":155},108028,"v2.0.0","## 重大变更\n\n- **仅原生安装** — 完全移除了基于 npm 的 Claude Code 安装方式。所有版本现在都使用原生二进制文件。现有的 `npm\u002F` 目录将被忽略；请运行 `cc-mirror update` 进行迁移。\n- **团队模式移除** — 为降低复杂性，团队模式功能已被移除。\n- **提示包模式** — 现仅支持 `minimal` 模式。`maximal` 模式已弃用。\n\n## 新增提供商\n\n- **Kimi Code** — Moonshot AI 的长上下文编码助手（kimi-for-coding \u002F K2.5）\n- **Ollama** — 具有 Anthropic 兼容 API 的本地模型运行工具\n- **GatewayZ** — 多提供商 AI 网关\n- **Vercel AI Gateway** — Vercel 的多提供商网关\n- **NanoGPT** — 按调用次数计费的 Claude Code 端点\n- **CC Router** — 将 Claude Code 路由至任意大语言模型（Ollama、DeepSeek 等）\n\n## 功能特性\n\n- **每个提供商的独特品牌主题** — 每个提供商都有自己的配色方案、ASCII 欢迎画面和自定义思考动词。\n- **自适应差异对比配色** — 差异对比颜色现在与各品牌的配色方案一致，以提高可读性。\n- **TUI 中的模型覆盖设置** — 通过交互式向导为所有提供商配置 Sonnet\u002FOpus\u002FHaiku 模型映射。\n- **`--claude-version` 支持** — 可固定或更新原生 Claude Code 版本（`stable`、`latest` 或特定版本）。\n- **默认使用最新通道** — 新版本默认跟踪 `latest` Claude Code 发布版本。\n- **`--model` 便捷标志** — 可从命令行一次性设置所有模型层级。\n- **社交媒体网格预览** — `scripts\u002Fpreview-splash-grid.mjs` 渲染一个包含所有提供商欢迎横幅的 3x3 网格。\n\n## 改进\n\n- **OpenRouter Chrome 主题** — 从海军蓝升级为精致的银色\u002F铬色外观。\n- **CC Router 更名** — “Claude Code Router” 在整个 UI 中简称为“CC Router”。\n- **Mirror 提供商隐藏** — 现标记为实验性功能（仅供开发参考）。\n- **通过 settings.json 禁用工具** — 提供商工具限制现已从 tweakcc 工具集移至 `settings.json` 的 `permissions.deny` 部分，以提高可靠性。\n- **简化欢迎画面** — OpenRouter、Vercel、CCRouter 和 GatewayZ 的 ASCII 欢迎画面更加简洁、紧凑。\n- **修复长 API 密钥粘贴问题** — TUI 的密码输入框现在可在多次粘贴时保留完整的密钥。\n- **提供商列表视口** — 限制滚动范围，使 TUI 导航更加整洁。\n\n## 内部改动\n\n- 为现有版本迁移旧版 tweakcc 工具集。\n- 强制启用暗色主题，以兼容 Rust 原生模块。\n- 规范化版本元数据架构。","2026-02-14T23:59:59",{"id":157,"version":158,"summary_zh":159,"released_at":160},108029,"v1.6.6","## 1.6.6\\n\\n### 变更\\n- 默认的 Claude Code npm 版本已更新至 2.1.12。\\n- 当前版本中已禁用团队模式；旧版标志将被忽略。\\n\\n### 新增\\n- 在检测到旧版元数据时，更新过程中会清理团队模式相关设置。\\n\\n### 文档\\n- README 和文档现将团队模式标记为旧版（仅适用于 cc-mirror 1.6.3）。\\n\\n## 1.6.5\\n\\n### 变更\\n- 默认的 Claude Code npm 版本已更新至 2.1.5。\\n\\n## 1.6.4\\n\\n### 变更\\n- cc-mirror 更新现在会在重新安装之前重置 npm\u002F 和 tweakcc\u002F 目录，从而保留配置、任务和技能，实现干净的重建。\\n- 更新命令默认静默输出 tweakcc 的信息；使用 --verbose 可显示完整日志。\\n\\n### 新增\\n- 增加了更新重建步骤的测试覆盖率，并新增了一个受控的实时端到端更新冒烟测试，用于无界面 CLI 运行。\\n\\n### 修复\\n- 更新不再复用可能在升级后导致 CLI 损坏的过时 tweakcc 提示数据。","2026-01-18T00:12:06",{"id":162,"version":163,"summary_zh":164,"released_at":165},108030,"v1.5.0","# Claude Code，无拘无束\n\n全面重构消息传递系统，将 CC-MIRROR 定位为具有鲜明立场的 Claude Code 发行版，以多智能体编排为核心功能。\n\n## 亮点\n\n- **全新标语**：“Claude Code，无拘无束”——预配置变体，内置多智能体编排、自定义提供商及久经考验的增强功能\n- **Mirror Claude 现已成为推荐提供商**——通往多智能体 Claude Code 的最快路径\n- **团队模式是旗舰功能**——解锁 TaskCreate、TaskGet、TaskUpdate、TaskList 工具，以及经过实战检验的编排技能\n\n## 快速入门\n\n```bash\n# 通往多智能体 Claude Code 的最快路径\nnpx cc-mirror quick --provider mirror --name mclaude\n\n# 运行它\nmclaude\n```\n\n## 变更内容\n\n### README 重写\n- 新增英雄区：“The Unlock”解释了 CC-MIRROR 能带来什么\n- 增加前后对比的 ASCII 流程图，展示转变过程\n- 将 Mirror Claude 快速入门置于首位\n- 新增“什么是 CC-MIRROR？”章节，阐述这一有观点的发行版模式\n\n### CLI 和 TUI 更新\n- CLI 帮助：新增页眉、“THE UNLOCK”专区、提供商列表\n- TUI 标志：显示“Claude Code，无拘无束”+“多智能体编排。一条命令即可。”\n- 提供商选择界面：突出显示 Mirror 为最快路径\n- 所有提供商均将多智能体编排列为特色功能\n\n### 提供商变更\n- Mirror 现在位于所有提供商列表的第一位\n- 更新后的描述更加突出多智能体能力\n- 所有提供商默认启用团队模式\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.4.2...v1.5.0","2026-01-06T23:06:37",{"id":167,"version":168,"summary_zh":169,"released_at":170},108031,"v1.4.2","## 编排技能中的模型选择\n\n编排技能中的每个 `Task()` 调用现在都包含一个显式的 `model=` 参数，并提供了清晰的指导，说明在什么情况下使用每一层级的模型。\n\n### 模型层级框架\n\n| 模型     | 最适合的场景                     |\n|----------|----------------------------------|\n| **haiku** | 探索、搜索、获取上下文、数据发现——可以大量启动 |\n| **sonnet** | 实现、测试生成、文档编写、结构化工作 |\n| **opus**  | 代码审查、安全分析、架构设计、冲突解决 |\n\n### 心智模型\n\n- **Haiku** = “跑腿小弟” — 可以随意启动，收集信息，不作判断\n- **Sonnet** = “初级到中级工程师” — 需要结构化的任务和明确的方向\n- **Opus** = “批判性思考者” — 信任其判断，处理模糊问题和架构设计\n\n### 所有命令现可通过 `npx` 使用\n\n整个代码库中的所有命令示例现在都使用 `npx cc-mirror` 而不是 `cc-mirror`，以实现最大的可移植性——无需全局安装！\n\n更新后的指南涵盖：\n- 任务管理器技能\n- README.md\n- 团队模式文档\n- CLI 帮助文本\n- AGENTS.md\n- 架构文档\n- 问题模板\n\n### 变更内容\n\n- 在 `SKILL.md` 中新增“模型选择”章节，包含各层级的描述\n- 更新了 12 个技能参考文件，添加了显式的 `model=` 参数\n- 将所有 CLI 命令示例更新为使用 `npx cc-mirror`\n- 共更新了 22 个文件以保持一致性\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.4.0...v1.4.2","2026-01-05T20:07:23",{"id":172,"version":173,"summary_zh":174,"released_at":175},108032,"v1.4.1","## 编排技能中的模型选择\n\n编排技能中的每个 `Task()` 调用现在都包含一个显式的 `model=` 参数，并提供了清晰的指导，说明在何时使用各个层级的模型。\n\n### 模型层级框架\n\n| 模型 | 最适合的场景 |\n|-------|----------|\n| **haiku** | 探索、搜索、获取上下文、数据发现——可以大量实例化 |\n| **sonnet** | 实现、测试生成、文档编写、结构化工作 |\n| **opus** | 代码审查、安全分析、架构设计、冲突解决 |\n\n### 思维模型\n\n- **Haiku** = “跑腿小弟” — 可以随意创建实例，收集信息，无需判断\n- **Sonnet** = “初级到中级工程师” — 需要结构化的任务和明确的方向\n- **Opus** = “批判性思考者” — 信任其判断，处理模糊问题和架构设计\n\n### 所有命令现可通过 `npx` 运行\n\n代码库中所有的命令示例现在都使用 `npx cc-mirror` 而不是 `cc-mirror`，以实现最大的可移植性——无需全局安装！\n\n更新后的指南涵盖：\n- 任务管理器技能\n- README.md\n- 团队模式文档\n- CLI 帮助文本\n- AGENTS.md\n- 架构文档\n- 问题模板\n\n### 更改内容\n\n- 在 `SKILL.md` 中新增“模型选择”章节，包含各层级的描述\n- 更新了 12 个技能参考文件，添加了显式的 `model=` 参数\n- 将所有 CLI 命令示例更新为使用 `npx cc-mirror`\n- 共更新了 22 个文件以保持一致性\n\n---\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.4.0...v1.4.1","2026-01-05T20:06:36",{"id":177,"version":178,"summary_zh":179,"released_at":180},108033,"v1.4.0","## 团队模式任务 CLI 管理工具\n\n用于在 Claude Code 外部管理团队任务的全面命令行界面。\n\n### 新增命令\n\n```bash\ncc-mirror tasks               # 列出未完成的任务\ncc-mirror tasks show \u003Cid>     # 显示任务详情\ncc-mirror tasks create        # 创建新任务\ncc-mirror tasks update \u003Cid>   # 更新任务状态或评论\ncc-mirror tasks delete \u003Cid>   # 永久删除任务\ncc-mirror tasks archive \u003Cid>  # 归档任务（保留历史记录）\ncc-mirror tasks clean         # 批量清理已完成或过期的任务\ncc-mirror tasks graph         # 可视化任务依赖关系\n```\n\n### 功能特性\n\n- **智能自动检测**：根据 `CLAUDE_CONFIG_DIR` 环境变量自动识别变体和团队\n- **归档支持**：将任务移动到 `archive\u002F` 文件夹，而非直接永久删除\n- **依赖关系图**：以 ASCII 图形展示任务间的阻塞关系\n- **批量清理**：提供 `--resolved`、`--older-than \u003Cdays>` 和 `--dry-run` 等选项\n- **跨团队视图**：使用 `--all` 标志可查看所有团队的任务\n- **JSON 输出**：提供 `--json` 标志以便脚本化操作\n\n### 新技能\n\n启用团队模式时，会自动安装 `task-manager` 技能。该技能将教会代理如何使用 CLI 进行清理和可视化任务。\n\n### 错误修复\n\n- 修复了布尔标志的参数解析器会错误地消耗下一个参数的问题（例如 `--dry-run --variant mc` 现在可以正确运行）\n\n### 完整变更日志\n\nhttps:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.3.0...v1.4.0","2026-01-05T16:43:47",{"id":182,"version":183,"summary_zh":184,"released_at":185},108034,"v1.0.4","## 变更\n\n- 移除了完成界面中损坏的 ASCII 艺术成功横幅\n- 精简了 Z.ai 提示词包（移除了冗长的设置和高级选项部分）\n- 简化了 MiniMax 提示词包（移除了冗余的认证部分）\n\n## 安装\n\n```bash\nnpx cc-mirror\n```\n\n**完整更新日志**：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.0.3...v1.0.4","2026-01-04T00:38:40",{"id":187,"version":188,"summary_zh":189,"released_at":190},108035,"v1.0.3","## 变更\n\n- **移除5个未使用的依赖**：`gradient-string`、`ink-big-text`、`ink-box`、`ink-gradient`、`ink-spinner`\n- **生产环境依赖从10个减少到5个**\n- **包的 tarball 大小**：88.5 kB\n\n## 修复\n\n- 修复了 bin 路径，使用相对路径（`.\u002Fdist\u002Fcc-mirror.mjs`）\n- 添加了缺失的 `@eslint\u002Fjs` 开发依赖\n\n## 安装\n\n```bash\nnpx cc-mirror\n# 或者\nnpm install -g cc-mirror\n```\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fnumman-ali\u002Fcc-mirror\u002Fcompare\u002Fv1.0.0...v1.0.3","2026-01-03T22:50:22",{"id":192,"version":193,"summary_zh":194,"released_at":195},108036,"v1.0.0","# CC-MIRROR v1.0.0 — First Public Release 🎉\n\nCreate multiple isolated Claude Code variants with custom providers.\n\n![CC-MIRROR Providers](https:\u002F\u002Fraw.githubusercontent.com\u002Fnumman-ali\u002Fcc-mirror\u002Fmain\u002Fassets\u002Fcc-mirror-providers.png)\n\n## Highlights\n\n- **Interactive TUI** — Just run `cc-mirror` (no flags needed!)\n- **4 Providers** — Z.ai, MiniMax, OpenRouter, Claude Code Router\n- **Brand Themes** — Custom color schemes per provider\n- **Prompt Packs** — Enhanced system prompts for Z.ai and MiniMax\n- **One-Command Updates** — Update all variants when Claude Code releases\n\n## Installation\n\n```bash\nnpm install -g cc-mirror\ncc-mirror\n```\n\n## What's New\n\n### Added\n- First public release\n- Claude Code Router support (route to local LLMs via CCRouter)\n- RouterUrlScreen for simplified CCRouter configuration\n- Provider intro screens with setup guidance and feature highlights\n- Feedback screen with GitHub repository links\n- Beautiful README with screenshots\n\n### Changed\n- TUI opens by default (no `--tui` flag required)\n- Removed LiteLLM provider (replaced by Claude Code Router)\n- CCRouter no longer requires model mapping\n- Simplified provider selection flow\n\n### Fixed\n- All linting errors resolved\n- React hook dependency warnings fixed\n- Settings-only updates preserve binary patches\n\n---\n\n🤖 Built with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code)\n\n**Created by [Numman Ali](https:\u002F\u002Fgithub.com\u002Fnumman-ali)** • [@nummanali](https:\u002F\u002Ftwitter.com\u002Fnummanali)","2026-01-03T22:26:17"]