Claude API Switcher — AI skill for Claude Code

Claude API Switcher V4.5.0

一个面向 Windows 的 Claude Code API 管理器。它能切换第三方 API、启动 Claude Code、管理本地 AI Gateway，也能在没有 Claude Code 环境时完成检测、安装和 PATH 修复。

最终用户直接运行 `Claude API Switcher V4.5.0.exe`，不需要 Python。

能做什么

• 管理 LongCat、Anthropic、OpenAI、DeepSeek、OpenRouter 和自定义 Provider。
• 测试 API 后再启用，减少错误配置直接进入工作会话的情况。
• 只为软件新启动的 Claude Code 进程注入 API 环境，不覆盖 ~/.claude/settings.json。
• 自动寻找 Claude Code 和最近使用的项目目录。
• 一键安装或更新 Claude Code，修复 PATH，并运行 claude doctor。
• 支持跟随 Windows、浅色、深色三种主题。
• 提供 OpenAI 兼容的本地 AI Gateway、模型管理、Token 统计和请求日志。
• 集成 gcli2api：个人用户使用 Antigravity，企业许可证用户可切换 Gemini CLI；支持可视化安装、启动、凭证 JSON 导入、逐模型额度、动态模型发现，并可一键加入 Claude Code 或本地网关。
• Antigravity 接入 Claude 时可走本软件 /v1/messages 网关：真实调用返回 429 后，优先在同系列文本模型中自动切换，最多尝试 3 个不同模型；配额快照与实测冲突时以真实 429 为准。
• 提供真实口径的额度监控：汇总 Claude Code 本机 Token、按供应商统计网关调用，并严格区分官方余额与不支持自动查询。
• 提供按本地时间统计的近 7 天 Token 热力图，按星期和小时显示活跃度。
• 使用原创蓝紫双向 API 路径图标，并同时应用到窗口、任务栏和 EXE。
• 单实例运行：重复双击只会激活现有窗口，避免配置、数据库和本地端口互相争抢。
• gcli2api 启停、额度读取和自动切换均有整体时间预算、并发保护、进程日志脱敏与部分成功提示。

界面分类

顶部只保留 5 个按任务划分的主入口：

入口	用途
API 切换	管理 Claude 直连供应商、测试并切换 API、选择项目并启动 Claude
Gemini 反代	安装、启动、登录和接入 gcli2api
本地网关	启停网关；通过“概览与模型 / 网关供应商 / 请求日志”管理网关功能
用量监控	查看本机 Claude Token、7 天热力图、网关分 API 用量和官方余额
环境设置	检测或安装 Claude Code，并切换跟随系统、浅色、深色主题

一键配置 Claude Code

打开“环境设置”页面后，软件会显示 Claude Code 的版本、路径、安装方式和健康状态。

如果未安装，点击“一键安装 / 更新”：

1. 优先使用 WinGet 安装 Anthropic.ClaudeCode。
2. WinGet 失败后，尝试 Anthropic 官方 Windows 安装器。
3. 安装完成后重新检测版本和 PATH。
4. 失败时显示网络、代理、权限、超时、文件占用或 PATH 未刷新等具体原因。

安装流程不会修改你的 Provider API Key。Claude Code 官方安装说明见：[Claude Code setup](https://code.claude.com/docs/en/setup)。

快速开始

使用已打包的 EXE

1. 从 GitHub Releases 下载 Claude API Switcher V4.5.0.exe。
2. 双击运行。
3. 在“API 切换”页添加或编辑供应商。
4. 填写 API 地址、模型、API Key 和认证方式。
5. 点击“测试并使用”。
6. 选择项目目录，然后点击“快速启动 Claude”。

运行数据保存在：

%LOCALAPPDATA%\ClaudeAPISwitcher

Gemini 反代（gcli2api）

打开独立的“Gemini 反代”页：

1. 点击“一键安装”。缺少 Git 或 uv 时，软件会通过 WinGet 安装固定的软件包，然后从官方仓库克隆并运行 `uv sync