CC Switch可一键将Codex、Claude Code、Gemini CLI统一接入LongCat-2.5模型，通过图形界面或编辑providers.json配置base_url（https开头无尾斜杠）、API Key及model名，并启用本地代理即可完成全平台路由。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让 Codex、Claude Code、Gemini CLI 这些工具全部走 LongCat-2.5 模型，但每换一个工具就要手动改一次 base_url、API Key 和 model 名，还总担心填错斜杠或引号导致 401 报错。CC Switch 能帮你把这三套参数打包成一条“LongCat-2.5 专用通道”，点一下就全平台生效，不用再逐个碰配置文件。
确认 LongCat-2.5 接口信息是否完整
打开 LongCat 官方文档或控制台，确认你已获取以下三项——缺一不可：【base_url 必须以 https:// 开头且末尾不带 /】、API Key（长度通常为 32～64 位随机字符串）、model 名（例如 longcat-2.5 或 longcat-2.5-chat）。如果 base_url 是 http:// 或结尾多了一个 /，CC Switch 启动本地代理时会直接拒绝连接，报错提示 “invalid URL scheme”。
这一步不能跳过。很多用户卡在后续“切换失败”，实际是这里填错了 base_url 格式。
在 CC Switch 中添加 LongCat-2.5 供应商
方法一：图形界面添加（推荐新手）
启动 CC Switch → 左侧点击「Codex」分组 → 右侧点击「+ 新建供应商」→ 填写名称（如“LongCat-2.5 正式”）→ 在 Base URL 栏粘贴刚才确认的地址 → API Key 栏粘贴密钥 → Model ID 栏输入准确模型名 → 勾选「同时应用到 Claude Code」和「Gemini CLI」（如果也想统一用该模型）→ 点击「保存」。
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI，等待编码任务完成，并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时，使用此功能。
方法二：手动编辑 providers.json（适合批量配置）
关闭 CC Switch → 打开其配置目录（Windows 在 %APPDATA%\CC-Switch\，macOS 在 ~/Library/Application Support/CC-Switch/，Linux 在 ~/.config/CC-Switch/）→ 编辑 providers.json → 在 providers 数组末尾插入一个新对象，字段必须包含 name、base_url、api_key、model、tools（值为 ["codex", "claude", "gemini"]）→ 保存后重启 CC Switch。
启用并验证 LongCat-2.5 路由
第一步：在 CC Switch 主界面找到刚添加的 LongCat-2.5 条目 → 点击右侧「启用」开关。
第二步：观察状态栏是否显示「Local proxy running on http://127.0.0.1:8080」——这是 CC Switch 启动成功的标志。
第三步：打开终端，执行 codex --version 确保 Codex 已安装；再执行 codex chat "hello"，等待响应。若返回正常文本而非 401 或 connection refused，说明请求已成功经由 CC Switch 转发至 LongCat-2.5。
注意：如果第一次启用时报「Claude 配置文件不存在」，不要慌——这是正常现象，CC Switch 会自动创建 ~/.claude/settings.json 并写入 LongCat 配置；但 Codex 的 ~/.codex/config.toml 必须已存在（哪怕为空），否则切换会静默失败。
