[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-SaladDay--cc-switch-cli":3,"tool-SaladDay--cc-switch-cli":64},[4,16,31,40,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":15},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,2,"2026-04-06T19:52:38",[13,14],"插件","开发框架","ready",{"id":17,"name":18,"github_repo":19,"description_zh":20,"stars":21,"difficulty_score":10,"last_commit_at":22,"category_tags":23,"status":15},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85013,"2026-04-06T11:09:19",[24,25,26,13,27,28,29,14,30],"图像","数据工具","视频","Agent","其他","语言模型","音频",{"id":32,"name":33,"github_repo":34,"description_zh":35,"stars":36,"difficulty_score":37,"last_commit_at":38,"category_tags":39,"status":15},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70686,3,"2026-04-06T23:17:08",[29,27,14,13],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":10,"last_commit_at":46,"category_tags":47,"status":15},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[13,29,27],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":15},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",65434,"2026-04-06T23:09:04",[27,13],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":15},193,"meilisearch","meilisearch\u002Fmeilisearch","Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。\n\nMeilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。",56985,"2026-04-06T22:39:54",[24,27,25,14,13,28],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":81,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":97,"forks":98,"last_commit_at":99,"license":100,"difficulty_score":10,"env_os":101,"env_gpu":102,"env_ram":102,"env_deps":103,"category_tags":107,"github_topics":81,"view_count":10,"oss_zip_url":81,"oss_zip_packed_at":81,"status":15,"created_at":108,"updated_at":109,"faqs":110,"releases":149},4851,"SaladDay\u002Fcc-switch-cli","cc-switch-cli","⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini CLI.","cc-switch-cli 是一款专为命令行爱好者打造的全能助手，旨在统一管理 Claude Code、Codex、Gemini、OpenCode 及 OpenClaw 等多种 AI 编程工具的提供商配置。它有效解决了开发者在切换不同 AI 模型服务时面临的繁琐配置问题，让用户无需手动修改环境变量或配置文件，即可在不同服务商之间快速无缝切换。\n\n这款工具特别适合经常使用多种 AI 编码助手的软件开发者和技术研究人员。无论是需要对比不同模型的表现，还是因项目需求需临时更换 API 服务，cc-switch-cli 都能让工作流更加顺畅。其基于 Rust 构建，确保了跨平台（Windows、macOS、Linux）下的高性能与稳定性。\n\n技术亮点方面，cc-switch-cli 不仅支持 WebDAV 同步配置，还在最新版本中引入了多窗口独立运行功能，允许用户同时开启多个终端窗口连接不同的服务商而互不干扰。此外，它还提供了增强的图形化界面（TUI）来编辑 MCP 环境变量，具备防重复键保护和清晰的字段摘要，极大提升了配置管理的效率与安全性。对于追求高效开发体验的用户而言，这是一个不可或缺的","cc-switch-cli 是一款专为命令行爱好者打造的全能助手，旨在统一管理 Claude Code、Codex、Gemini、OpenCode 及 OpenClaw 等多种 AI 编程工具的提供商配置。它有效解决了开发者在切换不同 AI 模型服务时面临的繁琐配置问题，让用户无需手动修改环境变量或配置文件，即可在不同服务商之间快速无缝切换。\n\n这款工具特别适合经常使用多种 AI 编码助手的软件开发者和技术研究人员。无论是需要对比不同模型的表现，还是因项目需求需临时更换 API 服务，cc-switch-cli 都能让工作流更加顺畅。其基于 Rust 构建，确保了跨平台（Windows、macOS、Linux）下的高性能与稳定性。\n\n技术亮点方面，cc-switch-cli 不仅支持 WebDAV 同步配置，还在最新版本中引入了多窗口独立运行功能，允许用户同时开启多个终端窗口连接不同的服务商而互不干扰。此外，它还提供了增强的图形化界面（TUI）来编辑 MCP 环境变量，具备防重复键保护和清晰的字段摘要，极大提升了配置管理的效率与安全性。对于追求高效开发体验的用户而言，这是一个不可或缺的实用工具。","\u003Cdiv align=\"center\">\n\n# CC-Switch CLI\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-5.3.0-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases)\n[![Built with Rust](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbuilt%20with-Rust-orange.svg)](https:\u002F\u002Fwww.rust-lang.org\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F22544\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_0b0cf02be0f5.png\" alt=\"SaladDay%2Fcc-switch-cli | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n**Command-Line Management Tool for Claude Code, Codex, Gemini, OpenCode & OpenClaw**\n\nUnified management for Claude Code, Codex, Gemini, OpenCode, and OpenClaw provider configurations, plus app-specific support for MCP servers, skills, prompts, local proxy routes, and environment checks.\n\nEnglish | [中文](README_ZH.md)\n\n\u003C\u002Fdiv>\n\n---\n\n## 📖 About\n\nThis project is a **CLI fork** of [CC-Switch](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch). \n\n🔄 The WebDAV sync feature is fully compatible with the upstream project.\n\n\n**Credits:** Original architecture and core functionality from [farion1231\u002Fcc-switch](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch)\n\n---\n\n## 🆕 What's New in 5.3.0\n\n\u003Cdiv align=\"center\">\n \u003Ch3>\u003Cstrong>🧭 Multi-window provider launch, deeper MCP env editing, and runtime polish\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003C\u002Fdiv>\n\n- Run different Claude\u002FCodex windows against different providers without disturbing your current global setup.\n- Add richer TUI support for MCP env editing with overlay-based editing, duplicate-key protection, and clearer field summaries.\n- Improve runtime and TUI alignment across temporary launch routing, provider safety flows, and platform-aware affordances.\n- Continue polishing OpenClaw flows, sponsor presets, config routes, and release docs for the current CLI release line.\n\n---\n\n## ❤️ Sponsor\n\n\u003Ctable>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch-cli\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n Thanks to \u003Cb>PackyCode\u003C\u002Fb> for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. \u003Cbr\u002F>\n PackyCode provides special discounts for our software users: register via \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch-cli\">this link\u003C\u002Fa> and use promo code \u003Ccode>cc-switch-cli\u003C\u002Fcode> when recharging to get \u003Cb>10% off\u003C\u002Fb>.\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=77V9EA\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_10d62653c84f.png\" alt=\"AICodeMirror\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n Thanks to \u003Cb>AICodeMirror\u003C\u002Fb> for sponsoring this project! \u003Cb>AICodeMirror\u003C\u002Fb> provides official high-stability relay services for Claude Code \u002F Codex \u002F Gemini CLI, with enterprise-grade concurrency, fast invoicing, and 24\u002F7 dedicated technical support. Claude Code \u002F Codex \u002F Gemini official channels at \u003Cb>38% \u002F 2% \u002F 9%\u003C\u002Fb> of original price, with extra discounts on top-ups! \u003Cb>AICodeMirror\u003C\u002Fb> offers special benefits for cc-switch-cli users: register via \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=77V9EA\">this link\u003C\u002Fa> to enjoy \u003Cb>20% off\u003C\u002Fb> your first top-up, and enterprise customers can get up to \u003Cb>25% off\u003C\u002Fb>!\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=ccswitch-cli\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_cd017fc8c081.jpg\" alt=\"RightCode\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n Thanks to \u003Cb>RightCode\u003C\u002Fb> for sponsoring this project! RightCode reliably provides routing services for models such as Claude Code, Codex, and Gemini. It features a highly cost-effective Codex monthly subscription plan and \u003Cb>supports quota rollovers—unused quota from one day can be carried over and used the next day.\u003C\u002Fb> \u003Cbr\u002F>\n RightCode offers a special deal for CC-Switch CLI users: register via \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=ccswitch-cli\">this link\u003C\u002Fa> and get \u003Cb>25% bonus pay-as-you-go credits\u003C\u002Fb> on every top-up!\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 📸 Screenshots\n\n\u003Cdiv align=\"center\">\n \u003Ch3>Home\u003C\u002Fh3>\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_50ab9e61ec06.png\" alt=\"Home\" width=\"70%\"\u002F>\n\u003C\u002Fdiv>\n\n\u003Cbr\u002F>\n\n\u003Ctable>\n \u003Ctr>\n \u003Cth>Switch\u003C\u002Fth>\n \u003Cth>Settings\u003C\u002Fth>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_13127c77c901.png\" alt=\"Switch\" width=\"100%\"\u002F>\u003C\u002Ftd>\n \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_0e70d44f1e0c.png\" alt=\"Settings\" width=\"100%\"\u002F>\u003C\u002Ftd>\n \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 🚀 Quick Start\n\n**Interactive Mode (Recommended)**\n```bash\ncc-switch\n```\n🤩 Follow on-screen menus to explore features.\n\n**Command-Line Mode**\n```bash\ncc-switch provider list # List providers\ncc-switch provider switch \u003Cid> # Switch provider\ncc-switch provider stream-check \u003Cid> # Check provider stream health\ncc-switch config webdav show # Inspect WebDAV sync settings\ncc-switch env tools # Check local CLI tools\ncc-switch mcp sync # Sync MCP servers\ncc-switch proxy show # Inspect proxy routes and status\n\n# Use the global `--app` flag to target specific applications:\ncc-switch --app claude provider list # Manage Claude providers\ncc-switch --app codex mcp sync # Sync Codex MCP servers\ncc-switch --app gemini prompts list # List Gemini prompts\ncc-switch --app openclaw provider list # Manage OpenClaw providers\n\n# Supported apps: `claude` (default), `codex`, `gemini`, `opencode`, `openclaw`\n```\n\nSee the \"Features\" section for full command list.\n\n---\n\n## 📥 Installation\n\n### Method 1: Quick Install (macOS \u002F Linux)\n\n> Windows users: see Manual Installation below.\n\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\nThis installs `cc-switch` to `~\u002F.local\u002Fbin`. Set `CC_SWITCH_INSTALL_DIR` to change the target directory.\n\n- If the target already exists, the installer prompts in TTY and refuses to overwrite in non-interactive shells unless `CC_SWITCH_FORCE=1` is set.\n- On Linux, set `CC_SWITCH_LINUX_LIBC=glibc` if you need the glibc build.\n\n\u003Cdetails>\n\u003Csummary>Manual Installation\u003C\u002Fsummary>\n\n#### macOS\n\n```bash\n# Download Universal Binary (recommended, supports Apple Silicon + Intel)\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-darwin-universal.tar.gz\n\n# Extract\ntar -xzf cc-switch-cli-darwin-universal.tar.gz\n\n# Add execute permission\nchmod +x cc-switch\n\n# Move to PATH\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n\n# If you encounter \"cannot be verified\" warning\nxattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch\n```\n\n#### Linux (x64)\n\n```bash\n# Download\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-x64-musl.tar.gz\n\n# Extract\ntar -xzf cc-switch-cli-linux-x64-musl.tar.gz\n\n# Add execute permission\nchmod +x cc-switch\n\n# Move to PATH\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n#### Linux (ARM64)\n\n```bash\n# For Raspberry Pi or ARM servers\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-arm64-musl.tar.gz\ntar -xzf cc-switch-cli-linux-arm64-musl.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n#### Windows\n\n```powershell\n# Download the zip file\n# https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-windows-x64.zip\n\n# After extracting, move cc-switch.exe to a PATH directory, e.g.:\nmove cc-switch.exe C:\\Windows\\System32\\\n\n# Or run directly\n.\\cc-switch.exe\n```\n\n\u003C\u002Fdetails>\n\n### Method 2: Build from Source\n\n**Prerequisites:**\n- Rust 1.85+ ([install via rustup](https:\u002F\u002Frustup.rs\u002F))\n\n**Build:**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli.git\ncd cc-switch-cli\u002Fsrc-tauri\ncargo build --release\n\n# Binary location: .\u002Ftarget\u002Frelease\u002Fcc-switch\n```\n\n**Install to System:**\n```bash\n# macOS\u002FLinux\nsudo cp target\u002Frelease\u002Fcc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n\n# Windows\ncopy target\\release\\cc-switch.exe C:\\Windows\\System32\\\n```\n\n---\n\n## ✨ Features\n\n### 🔌 Provider Management\n\nManage API configurations for **Claude Code**, **Codex**, **Gemini**, **OpenCode**, and **OpenClaw**.\n\n**Features:** One-click switching, multi-endpoint support, API key management, remote model discovery, and per-app diagnostics such as speed testing or stream health checks where supported.\n\n```bash\ncc-switch provider list # List all providers\ncc-switch provider current # Show current provider\ncc-switch provider switch \u003Cid> # Switch provider\ncc-switch provider add # Add new provider\ncc-switch provider edit \u003Cid> # Edit existing provider\ncc-switch provider duplicate \u003Cid> # Duplicate a provider\ncc-switch provider delete \u003Cid> # Delete provider\ncc-switch provider speedtest \u003Cid> # Test API latency\ncc-switch provider stream-check \u003Cid> # Run stream health check\ncc-switch provider fetch-models \u003Cid> # Fetch remote model list\n```\n\n### 🛠️ MCP Server Management\n\nManage Model Context Protocol servers across Claude, Codex, Gemini, and OpenCode.\n\n**Features:** Unified management, multi-app support, three transport types (stdio\u002Fhttp\u002Fsse), automatic sync, and live-config adapters for TOML and JSON targets.\n\n```bash\ncc-switch mcp list # List all MCP servers\ncc-switch mcp add # Add new MCP server (interactive)\ncc-switch mcp edit \u003Cid> # Edit MCP server\ncc-switch mcp delete \u003Cid> # Delete MCP server\ncc-switch mcp enable \u003Cid> --app claude # Enable for specific app\ncc-switch mcp disable \u003Cid> --app claude # Disable for specific app\ncc-switch mcp validate \u003Ccommand> # Validate command in PATH\ncc-switch mcp sync # Sync to live files\ncc-switch mcp import --app claude # Import from live config\n```\n\n### 💬 Prompts Management\n\nManage system prompt presets for AI coding assistants.\n\n**Cross-app support:** Claude (`CLAUDE.md`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`), OpenClaw (`AGENTS.md`).\n\n```bash\ncc-switch prompts list # List prompt presets\ncc-switch prompts current # Show current active prompt\ncc-switch prompts activate \u003Cid> # Activate prompt\ncc-switch prompts deactivate # Deactivate current active prompt\ncc-switch prompts create # Create new prompt preset\ncc-switch prompts edit \u003Cid> # Edit prompt preset\ncc-switch prompts show \u003Cid> # Display full content\ncc-switch prompts delete \u003Cid> # Delete prompt\n```\n\n### 🎯 Skills Management\n\nManage and extend Claude Code\u002FCodex\u002FGemini\u002FOpenCode capabilities with community skills.\n\n**Features:** SSOT-based skills store, multi-app enable\u002Fdisable, sync to app directories, unmanaged scan\u002Fimport, repo discovery.\n\n```bash\ncc-switch skills list # List installed skills\ncc-switch skills discover \u003Cquery> # Discover available skills (alias: search)\ncc-switch skills install \u003Cname> # Install a skill\ncc-switch skills uninstall \u003Cname> # Uninstall a skill\ncc-switch skills enable \u003Cname> # Enable for current app (--app)\ncc-switch skills disable \u003Cname> # Disable for current app (--app)\ncc-switch skills info \u003Cname> # Show skill information\ncc-switch skills sync # Sync enabled skills to app dirs\ncc-switch skills sync-method [m] # Show\u002Fset sync method (auto|symlink|copy)\ncc-switch skills scan-unmanaged # Scan unmanaged skills in app dirs\ncc-switch skills import-from-apps # Import unmanaged skills into SSOT\ncc-switch skills repos list # List skill repositories\ncc-switch skills repos add \u003Crepo> # Add repo (owner\u002Fname[@branch] or GitHub URL)\ncc-switch skills repos remove \u003Crepo> # Remove repo (owner\u002Fname or GitHub URL)\ncc-switch skills repos enable \u003Crepo> # Enable repo without changing branch\ncc-switch skills repos disable \u003Crepo> # Disable repo without changing branch\n```\n\n### ⚙️ Configuration Management\n\nManage configuration backups, imports, and exports.\n\n**Features:** Custom backup naming, interactive backup selection, automatic rotation (keep 10), import\u002Fexport, common snippets, WebDAV sync.\n\n```bash\ncc-switch config show # Display configuration\ncc-switch config path # Show config file paths\ncc-switch config validate # Validate config file\n\n# Common snippet (shared settings across providers)\n# Tries to refresh live config when applicable (`--apply` is kept only as a compatibility flag)\ncc-switch --app claude config common show\ncc-switch --app claude config common set --snippet '{\"env\":{\"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC\":1},\"includeCoAuthoredBy\":false}'\ncc-switch --app claude config common clear\n\n# Backup\ncc-switch config backup # Create backup (auto-named)\ncc-switch config backup --name my-backup # Create backup with custom name\n\n# Restore\ncc-switch config restore # Interactive: select from backup list\ncc-switch config restore --backup \u003Cid> # Restore specific backup by ID\ncc-switch config restore --file \u003Cpath> # Restore from external file\n\n# Import\u002FExport\ncc-switch config export \u003Cpath> # Export to external file\ncc-switch config import \u003Cpath> # Import from external file\n\n# WebDAV sync\ncc-switch config webdav show\ncc-switch config webdav set --base-url \u003Curl> --username \u003Cuser> --password \u003Cpassword> --enable\ncc-switch config webdav jianguoyun --username \u003Cuser> --password \u003Cpassword>\ncc-switch config webdav check-connection\ncc-switch config webdav upload\ncc-switch config webdav download\ncc-switch config webdav migrate-v1-to-v2\n\ncc-switch config reset # Reset to default configuration\n```\n\n### 🌉 Proxy Management\n\nInspect and control the local multi-app proxy used by supported apps.\n\n**Features:** Persisted enable\u002Fdisable switch, current route inspection, dashboard telemetry, and foreground serve mode for debugging.\n\n```bash\ncc-switch proxy show # Show proxy configuration and routes\ncc-switch proxy enable # Enable the persisted proxy switch\ncc-switch proxy disable # Disable the persisted proxy switch\ncc-switch proxy serve # Run the proxy in foreground\n```\n\n### 🧪 Environment & Local Tools\n\nInspect environment conflicts and whether required local CLIs are installed.\n\n```bash\ncc-switch env check # Check environment conflicts\ncc-switch env list # List relevant environment variables\ncc-switch env tools # Check Claude\u002FCodex\u002FGemini\u002FOpenCode CLIs\n```\n\n### 🌐 Multi-language Support\n\nInteractive mode supports English and Chinese, language settings are automatically saved.\n\n- Default language: English\n- Go to `⚙️ Settings` menu to switch language\n\n### 🔧 Utilities\n\nShell completions, environment management, and other utilities.\n\n```bash\n# Shell completions\ncc-switch completions \u003Cshell> # Generate shell completions (bash\u002Fzsh\u002Ffish\u002Fpowershell)\n\n# Environment management\ncc-switch env check # Check for environment conflicts\ncc-switch env list # List environment variables\n\n# Self-update\ncc-switch update # Update to latest release\ncc-switch update --version vX.Y.Z # Update to a specific version\n```\n\n---\n\n## 🏗️ Architecture\n\n### Core Design\n\n- **SQLite-backed state**: Core data lives in `~\u002F.cc-switch\u002Fcc-switch.db`; legacy `~\u002F.cc-switch\u002Fconfig.json` is kept only for older import and migration paths\n- **Skills SSOT**: Skill source files live in `~\u002F.cc-switch\u002Fskills\u002F`, while install state and app enablement stay in the database\n- **Safe Live Sync (Default)**: Skip writing live files for apps that haven't been initialized yet (prevents creating `~\u002F.claude`, `~\u002F.codex`, `~\u002F.gemini`, `~\u002F.config\u002Fopencode`, or `~\u002F.openclaw` unexpectedly)\n- **Atomic Writes**: Temp file + rename pattern prevents corruption\n- **Service Layer Reuse**: 100% reused from original GUI version\n- **Concurrency Safe**: RwLock with scoped guards\n\n### Configuration Files\n\n**CC-Switch Storage:**\n- `~\u002F.cc-switch\u002Fcc-switch.db` - Main database for providers, MCP, prompts, and app state\n- `~\u002F.cc-switch\u002Fsettings.json` - Settings\n- `~\u002F.cc-switch\u002Fskills\u002F` - Installed skill sources (SSOT)\n- `~\u002F.cc-switch\u002Fbackups\u002F` - Auto-rotation (keep 10)\n- `~\u002F.cc-switch\u002Fconfig.json` - Legacy JSON kept for compatibility and import flows\n\n**Live Configs:**\n- Claude: `~\u002F.claude\u002Fsettings.json` (provider\u002Fcommon config), `~\u002F.claude.json` (MCP), `~\u002F.claude\u002FCLAUDE.md` (prompts)\n- Codex: `~\u002F.codex\u002Fauth.json` (auth state), `~\u002F.codex\u002Fconfig.toml` (provider\u002Fcommon config + MCP), `~\u002F.codex\u002FAGENTS.md` (prompts)\n- Gemini: `~\u002F.gemini\u002F.env` (provider env), `~\u002F.gemini\u002Fsettings.json` (settings + MCP), `~\u002F.gemini\u002FGEMINI.md` (prompts)\n- OpenCode: `~\u002F.config\u002Fopencode\u002Fopencode.json` (providers + MCP + runtime config), `~\u002F.config\u002Fopencode\u002FAGENTS.md` (prompts)\n- OpenClaw: `~\u002F.openclaw\u002Fopenclaw.json` (providers + env\u002Ftools\u002Fagents defaults), `~\u002F.openclaw\u002FAGENTS.md` (prompts)\n\n---\n\n## ❓ FAQ (Frequently Asked Questions)\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Why doesn't my configuration take effect after switching providers?\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\nFirst, make sure the target CLI has been initialized at least once (i.e. its config directory exists). CC-Switch may skip live sync for uninitialized apps; you will see a warning. Run the target CLI once (e.g. `claude --help`, `codex --help`, `gemini --help`, `opencode --help`, `openclaw --help`), then switch again.\n\nThis is usually caused by **environment variable conflicts**. If you have API keys set in system environment variables (like `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`), they will override CC-Switch's configuration.\n\n**Solution:**\n\n1. Check for conflicts:\n ```bash\n cc-switch env check --app claude\n ```\n\n2. List all related environment variables:\n ```bash\n cc-switch env list --app claude\n ```\n\n3. If conflicts are found, manually remove them:\n - **macOS\u002FLinux**: Edit your shell config file (`~\u002F.bashrc`, `~\u002F.zshrc`, etc.)\n ```bash\n # Find and delete the line with the environment variable\n nano ~\u002F.zshrc\n # Or use your preferred text editor: vim, code, etc.\n ```\n - **Windows**: Open System Properties → Environment Variables and delete the conflicting variables\n\n4. Restart your terminal for changes to take effect.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Which apps are supported?\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\nCC-Switch currently supports five AI coding assistants:\n- **Claude Code** (`--app claude`, default)\n- **Codex** (`--app codex`)\n- **Gemini** (`--app gemini`)\n- **OpenCode** (`--app opencode`)\n- **OpenClaw** (`--app openclaw`)\n\nUse the global `--app` flag to specify which app to manage:\n```bash\ncc-switch --app codex provider list\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>How do I report bugs or request features?\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\nPlease open an issue on our [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Fissues) page with:\n- Detailed description of the problem or feature request\n- Steps to reproduce (for bugs)\n- Your system information (OS, version)\n- Relevant logs or error messages\n\n\u003C\u002Fdetails>\n\n---\n\n## 🛠️ Development\n\n### Requirements\n\n- **Rust**: 1.85+ ([rustup](https:\u002F\u002Frustup.rs\u002F))\n- **Cargo**: Bundled with Rust\n\n### Commands\n\n```bash\ncd src-tauri\n\ncargo run # Development mode\ncargo run -- provider list # Run specific command\ncargo build --release # Build release\n\ncargo fmt # Format code\ncargo clippy # Lint code\ncargo test # Run tests\n```\n\n### Code Structure\n\n```\nsrc-tauri\u002Fsrc\u002F\n├── cli\u002F\n│ ├── commands\u002F # CLI subcommands (provider, mcp, prompts, skills, proxy, env, ...)\n│ ├── tui\u002F # Interactive TUI mode (ratatui)\n│ ├── interactive\u002F # Interactive entrypoint \u002F TTY gate\n│ └── ui\u002F # UI utilities (tables, colors)\n├── services\u002F # Business logic (provider, mcp, prompt, webdav, ...)\n├── database\u002F # SQLite storage, migrations, backup\n├── main.rs # CLI entry point\n└── ... # App-specific configs, proxy, error handling\n```\n\n\n## 🤝 Contributing\n\nContributions welcome! This fork focuses on CLI functionality.\n\n**Before submitting PRs:**\n- ✅ Pass format check: `cargo fmt --check`\n- ✅ Pass linter: `cargo clippy`\n- ✅ Pass tests: `cargo test`\n- 💡 Open an issue for discussion first\n\n---\n\n## 📜 License\n\n- MIT © Original Author: Jason Young\n- CLI Fork Maintainer: saladday\n","\u003Cdiv align=\"center\">\n\n# CC-Switch CLI\n\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-5.3.0-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases)\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases)\n[![基于 Rust 构建](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbuilt%20with-Rust-orange.svg)](https:\u002F\u002Fwww.rust-lang.org\u002F)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F22544\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_0b0cf02be0f5.png\" alt=\"SaladDay%2Fcc-switch-cli | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n**用于 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 的命令行管理工具**\n\n统一管理 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 提供商配置，并为 MCP 服务器、技能、提示词、本地代理路由及环境检查提供特定于应用的支持。\n\nEnglish | [中文](README_ZH.md)\n\n\u003C\u002Fdiv>\n\n---\n\n## 📖 关于\n\n本项目是 [CC-Switch](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch) 的 **CLI 分支**。\n\n🔄 WebDAV 同步功能与上游项目完全兼容。\n\n\n**致谢：** 原始架构和核心功能来自 [farion1231\u002Fcc-switch](https:\u002F\u002Fgithub.com\u002Ffarion1231\u002Fcc-switch)\n\n---\n\n## 🆕 5.3.0 新增内容\n\n\u003Cdiv align=\"center\">\n \u003Ch3>\u003Cstrong>🧭 多窗口提供商启动、更深入的 MCP 环境编辑以及运行时优化\u003C\u002Fstrong>\u003C\u002Fh3>\n\u003C\u002Fdiv>\n\n- 可以在不同的窗口中针对不同提供商运行 Claude\u002FCodex，而不会影响当前的全局设置。\n- 为 MCP 环境编辑增加了更丰富的 TUI 支持，包括基于覆盖的编辑、重复键保护以及更清晰的字段摘要。\n- 改进了临时启动路由、提供商安全流程以及平台感知功能之间的运行时和 TUI 对齐。\n- 继续优化 OpenClaw 流程、赞助者预设、配置路由以及当前 CLI 版本的发布文档。\n\n---\n\n## ❤️ 赞助商\n\n\u003Ctable>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch-cli\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n 感谢 \u003Cb>PackyCode\u003C\u002Fb> 对本项目的赞助！PackyCode 是一家可靠高效的 API 中继服务提供商，为 Claude Code、Codex、Gemini 等提供中继服务。\u003Cbr\u002F>\n PackyCode 为我们的软件用户提供特别折扣：通过 \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=cc-switch-cli\">此链接\u003C\u002Fa> 注册，并在充值时使用优惠码 \u003Ccode>cc-switch-cli\u003C\u002Fcode>，即可享受 \u003Cb>10% 折扣\u003C\u002Fb>。\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=77V9EA\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_10d62653c84f.png\" alt=\"AICodeMirror\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n 感谢 \u003Cb>AICodeMirror\u003C\u002Fb> 对本项目的赞助！\u003Cb>AICodeMirror\u003C\u002Fb> 为 Claude Code \u002F Codex \u002F Gemini CLI 提供官方高稳定性中继服务，具备企业级并发处理能力、快速开票以及全天候专属技术支持。Claude Code \u002F Codex \u002F Gemini 官方渠道价格分别仅为原价的 \u003Cb>38% \u002F 2% \u002F 9%\u003C\u002Fb>,且充值还可享受额外折扣！\u003Cb>AICodeMirror\u003C\u002Fb> 为 cc-switch-cli 用户提供特别福利：通过 \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=77V9EA\">此链接\u003C\u002Fa> 注册，首次充值可享受 \u003Cb>20% 折扣\u003C\u002Fb>,企业客户最高可享 \u003Cb>25% 折扣\u003C\u002Fb>！\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd width=\"180\">\n \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=ccswitch-cli\">\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_cd017fc8c081.jpg\" alt=\"RightCode\" width=\"150\">\n \u003C\u002Fa>\n \u003C\u002Ftd>\n \u003Ctd>\n 感谢 \u003Cb>RightCode\u003C\u002Fb> 对本项目的赞助！RightCode 可靠地为 Claude Code、Codex 和 Gemini 等模型提供路由服务。它拥有极具性价比的 Codex 月度订阅计划，并且\u003Cb>支持配额结转——当天未使用的配额可结转至次日继续使用。\u003C\u002Fb>\u003Cbr\u002F>\n RightCode 为 CC-Switch CLI 用户提供特别优惠：通过 \u003Ca href=\"https:\u002F\u002Fwww.right.codes\u002Fregister?aff=ccswitch-cli\">此链接\u003C\u002Fa> 注册，每次充值即可获得 \u003Cb>25% 的按量付费积分奖励\u003C\u002Fb>！\n \u003C\u002Ftd>\n \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n## 📸 截图\n\n\u003Cdiv align=\"center\">\n \u003Ch3>首页\u003C\u002Fh3>\n \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_50ab9e61ec06.png\" alt=\"首页\" width=\"70%\"\u002F>\n\u003C\u002Fdiv>\n\n\u003Cbr\u002F>\n\n\u003Ctable>\n \u003Ctr>\n \u003Cth>切换\u003C\u002Fth>\n \u003Cth>设置\u003C\u002Fth>\n \u003C\u002Ftr>\n \u003Ctr>\n \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_13127c77c901.png\" alt=\"切换\" width=\"100%\"\u002F>\u003C\u002Ftd>\n \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_readme_0e70d44f1e0c.png\" alt=\"设置\" width=\"100%\"\u002F>\u003C\u002Ftd>\n \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 🚀 快速入门\n\n**交互模式（推荐）**\n```bash\ncc-switch\n```\n🤩 按照屏幕上的菜单探索各项功能。\n\n**命令行模式**\n```bash\ncc-switch provider list # 列出提供商\ncc-switch provider switch \u003Cid> # 切换提供商\ncc-switch provider stream-check \u003Cid> # 检查提供商流媒体健康状况\ncc-switch config webdav show # 查看 WebDAV 同步设置\ncc-switch env tools # 检查本地 CLI 工具\ncc-switch mcp sync # 同步 MCP 服务器\ncc-switch proxy show # 查看代理路由及状态\n\n# 使用全局 `--app` 标志来指定特定应用：\ncc-switch --app claude provider list # 管理 Claude 提供商\ncc-switch --app codex mcp sync # 同步 Codex MCP 服务器\ncc-switch --app gemini prompts list # 列出 Gemini 提示词\ncc-switch --app openclaw provider list # 管理 OpenClaw 提供商\n\n# 支持的应用：`claude`（默认）、`codex`、`gemini`、`opencode`、`openclaw`\n```\n\n完整命令列表请参阅“功能”部分。\n\n---\n\n## 📥 安装\n\n### 方法 1：快速安装（macOS \u002F Linux）\n\n> Windows 用户：请参阅下方的手动安装步骤。\n\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n这会将 `cc-switch` 安装到 `~\u002F.local\u002Fbin`。可通过设置 `CC_SWITCH_INSTALL_DIR` 来更改目标目录。\n\n- 如果目标目录已存在，安装程序会在 TTY 中提示，并且在非交互式 shell 中拒绝覆盖，除非设置了 `CC_SWITCH_FORCE=1`。\n- 在 Linux 上，如果需要 glibc 版本，请设置 `CC_SWITCH_LINUX_LIBC=glibc`。\n\n\u003Cdetails>\n\u003Csummary>手动安装\u003C\u002Fsummary>\n\n#### macOS\n\n```bash\n# 下载通用二进制文件（推荐，支持 Apple Silicon + Intel）\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-darwin-universal.tar.gz\n\n# 解压\ntar -xzf cc-switch-cli-darwin-universal.tar.gz\n\n# 添加执行权限\nchmod +x cc-switch\n\n# 移动到 PATH\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n\n# 如果遇到“无法验证”的警告\nxattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch\n```\n\n#### Linux (x64)\n\n```bash\n\n# 下载\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-x64-musl.tar.gz\n\n# 解压\ntar -xzf cc-switch-cli-linux-x64-musl.tar.gz\n\n# 添加执行权限\nchmod +x cc-switch\n\n# 移动到 PATH\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n#### Linux (ARM64)\n\n```bash\n# 适用于树莓派或 ARM 服务器\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-arm64-musl.tar.gz\ntar -xzf cc-switch-cli-linux-arm64-musl.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n#### Windows\n\n```powershell\n# 下载压缩包\n# https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-windows-x64.zip\n\n# 解压后，将 cc-switch.exe 移动到 PATH 目录，例如：\nmove cc-switch.exe C:\\Windows\\System32\\\n\n# 或直接运行\n.\\cc-switch.exe\n```\n\n\u003C\u002Fdetails>\n\n### 方法 2：从源码构建\n\n**前提条件：**\n- Rust 1.85+（可通过 [rustup](https:\u002F\u002Frustup.rs\u002F) 安装）\n\n**构建：**\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli.git\ncd cc-switch-cli\u002Fsrc-tauri\ncargo build --release\n\n# 二进制文件位置：.\u002Ftarget\u002Frelease\u002Fcc-switch\n```\n\n**安装到系统：**\n```bash\n# macOS\u002FLinux\nsudo cp target\u002Frelease\u002Fcc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n\n# Windows\ncopy target\\release\\cc-switch.exe C:\\Windows\\System32\\\n```\n\n---\n\n## ✨ 功能特性\n\n### 🔌 提供者管理\n\n管理 **Claude Code**、**Codex**、**Gemini**、**OpenCode** 和 **OpenClaw** 的 API 配置。\n\n**功能：** 一键切换、多端点支持、API 密钥管理、远程模型发现，以及在支持的情况下提供速度测试或流健康检查等应用级诊断功能。\n\n```bash\ncc-switch provider list # 列出所有提供者\ncc-switch provider current # 显示当前提供者\ncc-switch provider switch \u003Cid> # 切换提供者\ncc-switch provider add # 添加新提供者\ncc-switch provider edit \u003Cid> # 编辑现有提供者\ncc-switch provider duplicate \u003Cid> # 复制提供者\ncc-switch provider delete \u003Cid> # 删除提供者\ncc-switch provider speedtest \u003Cid> # 测试 API 延迟\ncc-switch provider stream-check \u003Cid> # 运行流健康检查\ncc-switch provider fetch-models \u003Cid> # 获取远程模型列表\n```\n\n### 🛠️ MCP 服务器管理\n\n管理 Claude、Codex、Gemini 和 OpenCode 中的模型上下文协议服务器。\n\n**功能：** 统一管理、多应用支持、三种传输方式（stdio\u002Fhttp\u002Fsse）、自动同步，以及针对 TOML 和 JSON 目标的实时配置适配器。\n\n```bash\ncc-switch mcp list # 列出所有 MCP 服务器\ncc-switch mcp add # 添加新 MCP 服务器（交互式）\ncc-switch mcp edit \u003Cid> # 编辑 MCP 服务器\ncc-switch mcp delete \u003Cid> # 删除 MCP 服务器\ncc-switch mcp enable \u003Cid> --app claude # 为特定应用启用\ncc-switch mcp disable \u003Cid> --app claude # 为特定应用禁用\ncc-switch mcp validate \u003Ccommand> # 验证 PATH 中的命令\ncc-switch mcp sync # 同步到实时配置文件\ncc-switch mcp import --app claude # 从实时配置导入\n```\n\n### 💬 提示词管理\n\n管理 AI 编程助手的系统提示词预设。\n\n**跨应用支持：** Claude (`CLAUDE.md`)、Codex (`AGENTS.md`)、Gemini (`GEMINI.md`)、OpenCode (`AGENTS.md`)、OpenClaw (`AGENTS.md`)。\n\n```bash\ncc-switch prompts list # 列出提示词预设\ncc-switch prompts current # 显示当前激活的提示词\ncc-switch prompts activate \u003Cid> # 激活提示词\ncc-switch prompts deactivate # 取消激活当前提示词\ncc-switch prompts create # 创建新的提示词预设\ncc-switch prompts edit \u003Cid> # 编辑提示词预设\ncc-switch prompts show \u003Cid> # 显示完整内容\ncc-switch prompts delete \u003Cid> # 删除提示词\n```\n\n### 🎯 技能管理\n\n管理和扩展 Claude Code\u002FCodex\u002FGemini\u002FOpenCode 的能力，使用社区提供的技能。\n\n**功能：** 基于 SSOT 的技能库、多应用启用\u002F禁用、同步到应用目录、未管理扫描\u002F导入、仓库发现。\n\n```bash\ncc-switch skills list # 列出已安装的技能\ncc-switch skills discover \u003Cquery> # 发现可用技能（别名：search）\ncc-switch skills install \u003Cname> # 安装技能\ncc-switch skills uninstall \u003Cname> # 卸载技能\ncc-switch skills enable \u003Cname> # 为当前应用启用（--app）\ncc-switch skills disable \u003Cname> # 为当前应用禁用（--app）\ncc-switch skills info \u003Cname> # 显示技能信息\ncc-switch skills sync # 将启用的技能同步到应用目录\ncc-switch skills sync-method [m] # 显示\u002F设置同步方法（auto|symlink|copy）\ncc-switch skills scan-unmanaged # 扫描应用目录中的未管理技能\ncc-switch skills import-from-apps # 将未管理技能导入 SSOT\ncc-switch skills repos list # 列出技能仓库\ncc-switch skills repos add \u003Crepo> # 添加仓库（owner\u002Fname[@branch] 或 GitHub URL）\ncc-switch skills repos remove \u003Crepo> # 移除仓库（owner\u002Fname 或 GitHub URL）\ncc-switch skills repos enable \u003Crepo> # 启用仓库而不更改分支\ncc-switch skills repos disable \u003Crepo> # 禁用仓库而不更改分支\n```\n\n### ⚙️ 配置管理\n\n管理配置的备份、导入和导出。\n\n**功能：** 自定义备份命名、交互式备份选择、自动轮转（保留 10 个）、导入\u002F导出、常用片段、WebDAV 同步。\n\n```bash\ncc-switch config show # 显示配置\ncc-switch config path # 显示配置文件路径\ncc-switch config validate # 验证配置文件\n\n# 常用片段（跨提供者的共享设置）\n# 在适用时尝试刷新实时配置（--apply 仅作为兼容性标志保留）\ncc-switch --app claude config common show\ncc-switch --app claude config common set --snippet '{\"env\":{\"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC\":1},\"includeCoAuthoredBy\":false}'\ncc-switch --app claude config common clear\n\n# 备份\ncc-switch config backup # 创建备份（自动命名）\ncc-switch config backup --name my-backup # 创建自定义名称的备份\n\n# 恢复\ncc-switch config restore # 交互式：从备份列表中选择\ncc-switch config restore --backup \u003Cid> # 根据 ID 恢复特定备份\ncc-switch config restore --file \u003Cpath> # 从外部文件恢复\n\n# 导入\u002F导出\ncc-switch config export \u003Cpath> # 导出到外部文件\ncc-switch config import \u003Cpath> # 从外部文件导入\n\n# WebDAV 同步\ncc-switch config webdav show\ncc-switch config webdav set --base-url \u003Curl> --username \u003Cuser> --password \u003Cpassword> --enable\ncc-switch config webdav jianguoyun --username \u003Cuser> --password \u003Cpassword>\ncc-switch config webdav check-connection\ncc-switch config webdav upload\ncc-switch config webdav download\ncc-switch config webdav migrate-v1-to-v2\n\ncc-switch config reset # 重置为默认配置\n```\n\n### 🌉 代理管理\n\n检查并控制受支持的应用程序使用的本地多应用代理。\n\n**功能：** 持久化的启用\u002F禁用开关、当前路由检查、仪表板遥测，以及用于调试的前台服务模式。\n\n```bash\ncc-switch proxy show # 显示代理配置和路由\ncc-switch proxy enable # 启用持久化的代理开关\ncc-switch proxy disable # 禁用持久化的代理开关\ncc-switch proxy serve # 在前台运行代理\n```\n\n### 🧪 环境与本地工具\n\n检查环境冲突以及是否已安装所需的本地 CLI 工具。\n\n```bash\ncc-switch env check # 检查环境冲突\ncc-switch env list # 列出相关环境变量\ncc-switch env tools # 检查 Claude\u002FCodex\u002FGemini\u002FOpenCode 的 CLI 工具\n```\n\n### 🌐 多语言支持\n\n交互模式支持英语和中文，语言设置会自动保存。\n\n- 默认语言：英语\n- 前往 `⚙️ 设置` 菜单切换语言\n\n### 🔧 实用工具\n\nShell 补全、环境管理及其他实用工具。\n\n```bash\n# Shell 补全\ncc-switch completions \u003Cshell> # 生成 shell 补全（bash\u002Fzsh\u002Ffish\u002Fpowershell）\n\n# 环境管理\ncc-switch env check # 检查环境冲突\ncc-switch env list # 列出环境变量\n\n# 自我更新\ncc-switch update # 更新到最新版本\ncc-switch update --version vX.Y.Z # 更新到指定版本\n```\n\n---\n\n## 🏗️ 架构\n\n### 核心设计\n\n- **SQLite 支持的状态存储**：核心数据存储在 `~\u002F.cc-switch\u002Fcc-switch.db` 中；旧版的 `~\u002F.cc-switch\u002Fconfig.json` 仅保留用于旧版本的导入和迁移路径。\n- **技能的唯一事实来源 (SSOT)**：技能源文件存储在 `~\u002F.cc-switch\u002Fskills\u002F` 目录中，而安装状态和应用启用信息则保存在数据库中。\n- **安全的实时同步（默认）**：对于尚未初始化的应用，跳过写入实时配置文件的操作，以防止意外创建 `~\u002F.claude`、`~\u002F.codex`、`~\u002F.gemini`、`~\u002F.config\u002Fopencode` 或 `~\u002F.openclaw` 目录。\n- **原子写入**：通过临时文件加重命名的方式避免数据损坏。\n- **服务层复用**：100% 复用自原始 GUI 版本。\n- **并发安全**：使用带有作用域保护的读写锁。\n\n### 配置文件\n\n**CC-Switch 存储：**\n- `~\u002F.cc-switch\u002Fcc-switch.db` - 主数据库，用于存储提供商、MCP、提示词和应用状态。\n- `~\u002F.cc-switch\u002Fsettings.json` - 设置文件。\n- `~\u002F.cc-switch\u002Fskills\u002F` - 已安装技能的源文件（SSOT）。\n- `~\u002F.cc-switch\u002Fbackups\u002F` - 自动轮转备份（保留 10 个）。\n- `~\u002F.cc-switch\u002Fconfig.json` - 旧版 JSON 文件，为兼容性和导入流程保留。\n\n**实时配置：**\n- Claude：`~\u002F.claude\u002Fsettings.json`（提供商\u002F通用配置）、`~\u002F.claude.json`（MCP）、`~\u002F.claude\u002FCLAUDE.md`（提示词）。\n- Codex：`~\u002F.codex\u002Fauth.json`（认证状态）、`~\u002F.codex\u002Fconfig.toml`（提供商\u002F通用配置 + MCP）、`~\u002F.codex\u002FAGENTS.md`（提示词）。\n- Gemini：`~\u002F.gemini\u002F.env`（提供商环境变量）、`~\u002F.gemini\u002Fsettings.json`（设置 + MCP）、`~\u002F.gemini\u002FGEMINI.md`（提示词）。\n- OpenCode：`~\u002F.config\u002Fopencode\u002Fopencode.json`（提供商 + MCP + 运行时配置）、`~\u002F.config\u002Fopencode\u002FAGENTS.md`（提示词）。\n- OpenClaw：`~\u002F.openclaw\u002Fopenclaw.json`（提供商 + 环境\u002F工具\u002F代理人默认值）、`~\u002F.openclaw\u002FAGENTS.md`（提示词）。\n\n---\n\n## ❓ 常见问题解答 (FAQ)\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>为什么切换提供商后我的配置没有生效？\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n首先，请确保目标 CLI 至少已被初始化一次（即其配置目录已存在）。CC-Switch 可能会跳过未初始化的应用的实时同步操作，并显示警告。请先运行一次目标 CLI（例如 `claude --help`、`codex --help`、`gemini --help`、`opencode --help`、`openclaw --help`），然后再尝试切换。\n\n这通常是由 **环境变量冲突** 引起的。如果您在系统环境变量中设置了 API 密钥（如 `ANTHROPIC_API_KEY`、`OPENAI_API_KEY`），它们将覆盖 CC-Switch 的配置。\n\n**解决方案：**\n\n1. 检查冲突：\n ```bash\n cc-switch env check --app claude\n ```\n\n2. 列出所有相关环境变量：\n ```bash\n cc-switch env list --app claude\n ```\n\n3. 如果发现冲突，请手动移除这些变量：\n - **macOS\u002FLinux**：编辑您的 shell 配置文件（`~\u002F.bashrc`、`~\u002F.zshrc` 等）。\n ```bash\n # 找到并删除包含该环境变量的行\n nano ~\u002F.zshrc\n # 或使用您喜欢的文本编辑器：vim、code 等\n ```\n - **Windows**：打开系统属性 → 环境变量，删除冲突的变量。\n\n4. 重启终端使更改生效。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>支持哪些应用程序？\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\nCC-Switch 目前支持五款 AI 编程助手：\n- **Claude Code** (`--app claude`, 默认)\n- **Codex** (`--app codex`)\n- **Gemini** (`--app gemini`)\n- **OpenCode** (`--app opencode`)\n- **OpenClaw** (`--app openclaw`)\n\n使用全局 `--app` 标志来指定要管理的应用程序：\n```bash\ncc-switch --app codex provider list\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>如何报告 bug 或请求功能？\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n请在我们的 [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Fissues) 页面上提交一个问题，内容包括：\n- 对问题或功能请求的详细描述\n- 复现步骤（针对 bug）\n- 您的系统信息（操作系统、版本）\n- 相关日志或错误信息\n\n\u003C\u002Fdetails>\n\n---\n\n## 🛠️ 开发\n\n### 要求\n\n- **Rust**：1.85+（[rustup](https:\u002F\u002Frustup.rs\u002F)）\n- **Cargo**：随 Rust 一起提供\n\n### 命令\n\n```bash\ncd src-tauri\n\ncargo run # 开发模式\ncargo run -- provider list # 运行特定命令\ncargo build --release # 构建发布版本\n\ncargo fmt # 格式化代码\ncargo clippy # 代码 lint 检查\ncargo test # 运行测试\n```\n\n### 代码结构\n\n```\nsrc-tauri\u002Fsrc\u002F\n├── cli\u002F\n│ ├── commands\u002F # CLI 子命令（provider、mcp、prompts、skills、proxy、env 等）\n│ ├── tui\u002F # 交互式 TUI 模式（ratatui）\n│ ├── interactive\u002F # 交互式入口 \u002F TTY 门控\n│ └── ui\u002F # UI 工具（表格、颜色）\n├── services\u002F # 业务逻辑（provider、mcp、prompt、webdav 等）\n├── database\u002F # SQLite 存储、迁移、备份\n├── main.rs # CLI 入口点\n└── ... # 应用特定配置、代理、错误处理等\n```\n\n\n## 🤝 贡献\n\n欢迎贡献！此分支专注于 CLI 功能。\n\n**提交 PR 之前：**\n- ✅ 通过格式检查：`cargo fmt --check`\n- ✅ 通过 linter 检查：`cargo clippy`\n- ✅ 通过测试：`cargo test`\n- 💡 请先开一个议题进行讨论\n\n---\n\n## 📜 许可证\n\n- MIT © 原作者：Jason Young\n- CLI 分支维护者：saladday","# cc-switch-cli 快速上手指南\n\n`cc-switch-cli` 是一款基于 Rust 开发的命令行工具，用于统一管理 **Claude Code**、**Codex**、**Gemini**、**OpenCode** 和 **OpenClaw** 的配置。它支持一键切换 API 提供商、管理 MCP 服务器、同步技能（Skills）、管理系统提示词（Prompts）以及配置本地代理。\n\n## 🛠️ 环境准备\n\n### 系统要求\n- **操作系统**：Windows、macOS (Intel\u002FApple Silicon)、Linux (x64\u002FARM64)\n- **架构支持**：通用二进制或特定架构包（见安装步骤）\n\n### 前置依赖\n- **运行模式**：直接下载预编译二进制文件无需额外依赖。\n- **源码编译模式**：需安装 Rust 1.85+ (`rustup`)。\n- **网络环境**：访问 GitHub Releases 下载资源；若连接不畅，建议配置终端代理或使用国内镜像加速。\n\n---\n\n## 📥 安装步骤\n\n### 方法一：一键安装脚本（推荐 macOS \u002F Linux）\n\n在终端执行以下命令，自动下载并安装到 `~\u002F.local\u002Fbin`：\n\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n> **注意**：\n> - 安装完成后，请确保 `~\u002F.local\u002Fbin` 已加入环境变量 `PATH`。\n> - 若需自定义安装目录，可设置环境变量 `CC_SWITCH_INSTALL_DIR`。\n> - Linux 用户如需 glibc 版本，请设置 `CC_SWITCH_LINUX_LIBC=glibc`。\n\n### 方法二：手动安装\n\n#### macOS (Universal Binary)\n支持 Apple Silicon 和 Intel 芯片。\n\n```bash\n# 下载\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-darwin-universal.tar.gz\n\n# 解压\ntar -xzf cc-switch-cli-darwin-universal.tar.gz\n\n# 授权并移动\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n\n# 若遇到“无法验证开发者”警告，执行：\nxattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch\n```\n\n#### Linux (x64 \u002F ARM64)\n\n**x64 版本：**\n```bash\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-x64-musl.tar.gz\ntar -xzf cc-switch-cli-linux-x64-musl.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**ARM64 版本（如树莓派）：**\n```bash\ncurl -LO https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-linux-arm64-musl.tar.gz\ntar -xzf cc-switch-cli-linux-arm64-musl.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n#### Windows\n\n1. 下载 ZIP 包：[cc-switch-cli-windows-x64.zip](https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Fcc-switch-cli-windows-x64.zip)\n2. 解压后，将 `cc-switch.exe` 移动到系统路径（如 `C:\\Windows\\System32\\`）或任意已加入 `PATH` 的目录。\n3. 或在当前目录直接运行：\n ```powershell\n .\\cc-switch.exe\n ```\n\n### 方法三：源码编译\n\n需安装 Rust 1.85+。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fsaladday\u002Fcc-switch-cli.git\ncd cc-switch-cli\u002Fsrc-tauri\ncargo build --release\n\n# 二进制文件位于 .\u002Ftarget\u002Frelease\u002Fcc-switch\n# 将其复制到系统 PATH 即可使用\n```\n\n---\n\n## 🚀 基本使用\n\n### 1. 交互式模式（推荐新手）\n\n直接运行命令进入图形化终端界面（TUI），通过菜单操作所有功能：\n\n```bash\ncc-switch\n```\n\n### 2. 命令行模式\n\n#### 管理 API 提供商 (Provider)\n列出、切换或测试不同模型的 API 配置：\n\n```bash\ncc-switch provider list # 列出所有提供商\ncc-switch provider switch \u003Cid> # 切换到指定 ID 的提供商\ncc-switch provider speedtest \u003Cid> # 测试 API 延迟\ncc-switch provider stream-check \u003Cid> # 检查流式响应健康度\n```\n\n#### 针对特定应用操作\n使用 `--app` 标志指定目标应用（支持 `claude`, `codex`, `gemini`, `opencode`, `openclaw`）：\n\n```bash\n# 管理 Claude 的提供商\ncc-switch --app claude provider list\n\n# 同步 Codex 的 MCP 服务器\ncc-switch --app codex mcp sync\n\n# 列出 Gemini 的提示词预设\ncc-switch --app gemini prompts list\n```\n\n#### 管理 MCP 服务器与技能\n```bash\ncc-switch mcp list # 列出 MCP 服务器\ncc-switch mcp sync # 同步 MCP 配置到应用\ncc-switch skills list # 列出已安装的技能\ncc-switch skills install \u003Cname> # 安装新技能\ncc-switch skills sync # 将启用的技能同步到应用目录\n```\n\n#### 其他常用命令\n```bash\ncc-switch prompts list # 查看提示词预设\ncc-switch proxy show # 查看代理路由状态\ncc-switch env tools # 检查本地 CLI 工具环境\n```\n\n> 💡 **提示**：首次使用时，建议先运行 `cc-switch` 进入交互模式熟悉配置流程，后续可通过命令行脚本实现自动化切换。","某全栈开发者需要在同一台电脑上同时维护多个项目，分别依赖 Claude Code、Codex 和 Gemini 不同的 API 服务商及配置环境。\n\n### 没有 cc-switch-cli 时\n- **配置切换繁琐**：每次切换模型供应商（如从官方源切到中转源），需手动编辑多个配置文件或反复导出导入环境变量，极易出错。\n- **多任务冲突**：无法同时运行不同配置的终端窗口，测试 A 项目的 Claude 配置时，会意外覆盖 B 项目正在使用的 Gemini 全局设置。\n- **MCP 管理混乱**：修改 MCP 服务器环境变量时缺乏可视化界面，容易因键名重复或格式错误导致服务启动失败。\n- **环境排查困难**：缺少统一的状态检查工具，遇到连接问题时需逐个排查网络代理、密钥有效性及本地路由规则。\n\n### 使用 cc-switch-cli 后\n- **一键无缝切换**：通过简单的 CLI 命令即可瞬间切换 Claude、Codex 或 Gemini 的供应商配置，自动处理底层路由与密钥注入。\n- **多窗口隔离运行**：支持启动多个独立终端窗口，每个窗口可绑定不同的供应商配置，互不干扰，完美并行开发多项目。\n- **可视化 MCP 编辑**：内置增强型 TUI 界面，提供覆盖式编辑、重复键保护及字段摘要，让复杂的环境变量修改直观且安全。\n- **智能诊断辅助**：内置环境检查功能，自动验证代理路由、密钥状态及平台兼容性，快速定位并解决运行时异常。\n\ncc-switch-cli 将原本碎片化、高风险的多模型配置管理工作，转化为统一、安全且高效的命令行流，极大提升了跨模型开发的流畅度。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FSaladDay_cc-switch-cli_50ab9e61.png","SaladDay","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FSaladDay_65d0edd2.png","writing bugs\r\n","ZJU","Zhejiang,China",null,"code.saladday.top","https:\u002F\u002Fgithub.com\u002FSaladDay",[85,89,93],{"name":86,"color":87,"percentage":88},"Rust","#dea584",99.7,{"name":90,"color":91,"percentage":92},"Shell","#89e051",0.2,{"name":94,"color":95,"percentage":96},"Python","#3572A5",0.1,1658,88,"2026-04-06T21:41:15","MIT","Linux, macOS, Windows","未说明",{"notes":104,"python":102,"dependencies":105},"该工具是基于 Rust 编写的命令行管理工具，无需 Python 环境或 GPU 支持。主要依赖为 Rust 编译器（版本需 1.85 及以上）。提供预编译的二进制文件，支持 x64 和 ARM64 架构。安装后可直接运行，用于管理 Claude Code、Codex、Gemini 等 AI 工具的提供商配置、MCP 服务器、提示词和技能。",[106],"Rust 1.85+",[13],"2026-03-27T02:49:30.150509","2026-04-07T13:27:27.559364",[111,116,121,126,131,136,141,145],{"id":112,"question_zh":113,"answer_zh":114,"source_url":115},22064,"切换 Codex 配置后 base_url 未生效或出现格式错误怎么办？","这是旧版本配置格式不兼容导致的。在最新版本（main 分支）中已修复：\n1. 应用启动时会自动扫描数据库中所有 Codex provider，将旧的 flat 格式（root 级别的 `base_url + model + wire_api`）一次性迁移为正确的 `model_provider + [model_providers.\u003Ckey>]` 格式。\n2. 不需要手动逐个编辑配置。\n3. 如果仍遇到问题，请删除 `~\u002F.codex` 文件夹，重新添加 provider 并执行 `codex login` 刷新 OAuth token。\n4. 确保从最新 main 分支重新编译或使用包含修复的 release 版本。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F3",{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},22065,"升级后出现 UI 显示异常或颜色错乱如何解决？","这通常是由于终端颜色模式不兼容导致的。解决方法如下：\n1. 尝试强制使用 256 色模式启动：`CC_SWITCH_COLOR_MODE=ansi256 cc-switch`\n2. 检查环境变量设置，确认 TERM 是否为 xterm 或 xterm-256color。\n3. 如果在 tmux\u002Fscreen 中运行，请确保终端支持真彩色。\n4. Xshell 用户需确认会话终端类型设置为 xterm-256color 并开启相关颜色选项。\n5. 最新补丁已修复此问题，建议更新到最新版本。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F60",{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},22066,"如何在不同终端窗口中使用不同的 API 供应商？","cc-switch-cli 支持在不同窗口使用不同供应商：\n1. TUI 模式下按 'o' 键打开新窗口选择供应商。\n2. CLI 模式下使用命令：`cc-switch start claude \u003Cselector>`\n - `\u003Cselector>` 可以是 provider id（精确匹配）或 provider name（模糊匹配）\n3. 可以使用 alias 简化常用命令。\n4. 该功能已在 v5.3.0 版本中正式包含。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F54",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},22067,"配置 Claude Code 后导致 claude.json 中的插件等字段丢失怎么办？","这是配置写入机制的问题，已在 commit c4409be 中修复：\n1. 新版本实现了 Backfill 机制：每次切换供应商时，会先将当前 `settings.json` 的完整内容（包括手动添加的字段如 enabledPlugins）回存到当前供应商的配置快照中。\n2. 然后再写入新供应商的配置，避免字段覆盖。\n3. 如果你之前手动添加了插件配置，切换到其他供应商后再切回来，这些配置会自动恢复。\n4. 建议升级到包含此修复的最新版本。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F56",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},22068,"是否支持将 OpenAI Chat Completions 接口转换为 Anthropic 接口代理？","是的，该功能已在 v5.0.0 中实现：\n1. 配置 provider 时可以选择 API 格式，支持三种类型：anthropic、openai_chat、openai_responses。\n2. 代理会自动完成请求和响应的格式转换。\n3. 如果遇到代理不成功的情况，请检查：\n - 上游是否支持对应的模型 ID\n - Claude Model Config 中是否正确配置了主模型\u002F默认 Sonnet 模型\n - settings.json 中的配置是否正确\n4. 相关问题已在后续版本中进一步优化。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F49",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},22069,"如何配置官方订阅模式而不是使用 API Key？","cc-switch-cli 现已支持官方 Provider 模式：\n1. 在 TUI 的 provider 配置界面可以直接选择'官方模式'（如 Claude Official）。\n2. 不需要填写 API Key 和 Base URL，系统会使用 OAuth 认证。\n3. 首次使用需要执行 `codex login` 或相应命令进行官方账号授权。\n4. 如果遇到 403 错误，请确认是否同时填写了 API Key 和 Base URL（官方模式下应留空），并重新登录刷新凭证。","https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Fissues\u002F7",{"id":142,"question_zh":143,"answer_zh":144,"source_url":120},22070,"数据库版本过新导致无法降级或启动报错如何处理？","当出现'数据库版本过新'错误时：\n1. 这是因为高版本应用更新了数据库结构，低版本无法兼容。\n2. 解决方案：\n - 推荐：升级到最新版本的 cc-switch 以匹配数据库版本\n - 如果必须使用旧版本，需要删除重装：移除 ~\u002F.cc-switch 或相关数据目录后重新安装\n3. 建议在使用 update 命令升级前备份重要配置。\n4. 未来版本将提供更平滑的版本兼容机制。",{"id":146,"question_zh":147,"answer_zh":148,"source_url":115},22071,"Codex CLI 报 OAuth token 权限不足（Missing scopes）怎么办？","这是 Codex CLI 侧的 OAuth token 问题，不是 cc-switch 的 bug：\n1. 错误信息如'insufficient permissions: Missing scopes: api.management.write'表明 token 权限不足。\n2. 解决方法：\n - 删除 auth.json 文件\n - 重新执行 `codex login` 命令刷新 OAuth token\n - 确保登录时授予了所有必要的权限范围\n3. cc-switch 会正确设置 `requires_openai_auth = true` 并清理旧凭证，之后的认证流程由 Codex CLI 接管。\n4. 如果问题持续，检查 Codex CLI 是否为最新版本。",[150,155,160,165,170,175,180,185,190,195,200,205,210,215,220,225,230,235,240,245],{"id":151,"version":152,"summary_zh":153,"released_at":154},135719,"v5.3.0","## CC Switch CLI v5.3.0\n\n适用于 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 的一体化助手\n\n请参阅此标签中的 `CHANGELOG.md` 和 README，以获取最新的发布说明和升级亮点。\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.3.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.3.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.3.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.3.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.3.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.3.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移动到 PATH 目录，或直接运行\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”提示，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-04-03T13:18:01",{"id":156,"version":157,"summary_zh":158,"released_at":159},135720,"v5.2.1","## CC Switch CLI v5.2.1\n\nClaude Code、Codex、Gemini、OpenCode 和 OpenClaw 的一体化助手\n\n请参阅此标签下的 `CHANGELOG.md` 和 README，以获取最新的发行说明和升级亮点。\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.2.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.2.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.2.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.2.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.2.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.2.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移动到 PATH 目录，或直接运行\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”提示，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-24T12:24:44",{"id":161,"version":162,"summary_zh":163,"released_at":164},135721,"v5.2.0","## CC Switch CLI v5.2.0\n\nClaude Code、Codex、Gemini、OpenCode 和 OpenClaw 的一体化助手\n\n请参阅此标签中的 `CHANGELOG.md` 和 README，以获取最新的发布说明和升级亮点。\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v5.2.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.2.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.2.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.2.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.2.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.2.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-23T10:30:13",{"id":166,"version":167,"summary_zh":168,"released_at":169},135722,"v5.1.1","## CC Switch CLI v5.1.1\n\n适用于 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 的一体化助手\n\n请参阅此标签中的 `CHANGELOG.md` 和 README，以获取最新的发行说明和升级亮点。\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.1.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.1.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.1.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.1.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.1.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.1.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”问题，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-20T12:38:51",{"id":171,"version":172,"summary_zh":173,"released_at":174},135723,"v5.1.0","## CC Switch CLI v5.1.0\n\n适用于 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 的一体化助手\n\n此版本新增：支持 OpenClaw、更紧密的上游同步，以及更安全的 WebDAV 和 TUI 行为。\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.1.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.1.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.1.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.1.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.1.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.1.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移至 PATH 目录，或直接运行。\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”提示，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-19T17:19:58",{"id":176,"version":177,"summary_zh":178,"released_at":179},135724,"v5.0.1","## CC Switch CLI v5.0.1\n\nClaude Code、Codex 和 Gemini CLI 的一体化助手\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.0.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.0.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.0.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.0.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.0.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.0.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移动到 PATH 目录，或直接运行\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”提示，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-15T06:30:36",{"id":181,"version":182,"summary_zh":183,"released_at":184},135725,"v5.0.0","## CC Switch CLI v5.0.0\n\nClaude Code、Codex 和 Gemini CLI 的一体化助手\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v5.0.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v5.0.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v5.0.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v5.0.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v5.0.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v5.0.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-03-12T21:25:06",{"id":186,"version":187,"summary_zh":188,"released_at":189},135726,"v4.8.0","## CC Switch CLI v4.8.0\n\n适用于 Claude Code、Codex 和 Gemini 的一体化命令行助手\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v4.8.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.8.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.8.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.8.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.8.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.8.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装 \u002F Quick Install\n\n**macOS \u002F Linux (一行命令):**\n```bash\ncurl -fsSL https:\u002F\u002Fgithub.com\u002FSaladDay\u002Fcc-switch-cli\u002Freleases\u002Flatest\u002Fdownload\u002Finstall.sh | bash\n```\n\n**Windows:**\n```powershell\n# 下载 zip 文件后，将 cc-switch.exe 移动到 PATH 目录中，或直接运行\n```\n\n💡 **macOS 提示**: 如遇“无法验证开发者”提示，请执行：`xattr -cr ~\u002F.local\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-02-28T15:55:25",{"id":191,"version":192,"summary_zh":193,"released_at":194},135727,"v4.7.4","## CC Switch CLI v4.7.4\n\n用于 Claude Code、Codex 和 Gemini 的一体化命令行助手\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v4.7.4-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.7.4-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.7.4-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.7.4-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.7.4-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.7.4-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-02-28T08:31:26",{"id":196,"version":197,"summary_zh":198,"released_at":199},135728,"v4.7.3","## CC Switch CLI v4.7.3\n\nClaude Code、Codex 和 Gemini CLI 的一体化助手\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (通用) | `cc-switch-cli-v4.7.3-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.7.3-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.7.3-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.7.3-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.7.3-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.7.3-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**","2026-02-24T14:13:27",{"id":201,"version":202,"summary_zh":203,"released_at":204},135729,"v4.7.2","## CC Switch CLI v4.7.2\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.7.2-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.7.2-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.7.2-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.7.2-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.7.2-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.7.2-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-08T10:49:39",{"id":206,"version":207,"summary_zh":208,"released_at":209},135730,"v4.7.1","## CC Switch CLI v4.7.1\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.7.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.7.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.7.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.7.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.7.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.7.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-07T17:44:44",{"id":211,"version":212,"summary_zh":213,"released_at":214},135731,"v4.7.0","## CC Switch CLI v4.7.0\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.7.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.7.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.7.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.7.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.7.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.7.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-06T17:07:38",{"id":216,"version":217,"summary_zh":218,"released_at":219},135732,"v4.6.2","## CC Switch CLI v4.6.2\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.6.2-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.6.2-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.6.2-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.6.2-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.6.2-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.6.2-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-05T18:41:32",{"id":221,"version":222,"summary_zh":223,"released_at":224},135733,"v4.6.1","## CC Switch CLI v4.6.1\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.6.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.6.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.6.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.6.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.6.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.6.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-05T17:55:24",{"id":226,"version":227,"summary_zh":228,"released_at":229},135734,"v4.6.0","## CC Switch CLI v4.6.0\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.6.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.6.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.6.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.6.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.6.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.6.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-05T17:22:46",{"id":231,"version":232,"summary_zh":233,"released_at":234},135735,"v4.5.0","## CC Switch CLI v4.5.0\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.5.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.5.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.5.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.5.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.5.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.5.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-02-01T16:09:58",{"id":236,"version":237,"summary_zh":238,"released_at":239},135736,"v4.4.0","## CC Switch CLI v4.4.0\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.4.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.4.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.4.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.4.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.4.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.4.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-01-31T16:10:19",{"id":241,"version":242,"summary_zh":243,"released_at":244},135737,"v4.3.1","## CC Switch CLI v4.3.1\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.3.1-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.3.1-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.3.1-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.3.1-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.3.1-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.3.1-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-01-29T18:05:31",{"id":246,"version":247,"summary_zh":248,"released_at":249},135738,"v4.3.0","## CC Switch CLI v4.3.0\n\nAll-in-One Assistant for Claude Code, Codex & Gemini CLI\n\n### 📦 下载 \u002F Downloads\n\n| 平台 Platform | 文件 File |\n|---------------|-----------|\n| **macOS** (Universal) | `cc-switch-cli-v4.3.0-darwin-universal.tar.gz` |\n| **Windows** (x64) | `cc-switch-cli-v4.3.0-windows-x64.zip` |\n| **Linux** (x64 musl) | `cc-switch-cli-v4.3.0-linux-x64-musl.tar.gz` |\n| **Linux** (x64 glibc) | `cc-switch-cli-v4.3.0-linux-x64.tar.gz` |\n| **Linux** (ARM64 musl) | `cc-switch-cli-v4.3.0-linux-arm64-musl.tar.gz` |\n| **Linux** (ARM64 glibc) | `cc-switch-cli-v4.3.0-linux-arm64.tar.gz` |\n\n### 🚀 快速安装\n\n**macOS \u002F Linux:**\n```bash\ntar -xzf cc-switch-cli-*.tar.gz\nchmod +x cc-switch\nsudo mv cc-switch \u002Fusr\u002Flocal\u002Fbin\u002F\n```\n\n**Windows:**\n```powershell\n# 解压 zip 后将 cc-switch.exe 移动到 PATH 目录或直接运行\n```\n\n💡 **macOS 提示**: 如遇 \"无法验证开发者\"，执行：`xattr -cr \u002Fusr\u002Flocal\u002Fbin\u002Fcc-switch`\n\n💡 **Linux 用户建议优先使用 `-musl` 版本（静态链接，无系统库依赖，兼容所有发行版）**\n","2026-01-17T08:45:50"]