免费 AI API Key 获取与统一管理方案

島主 发布于 阅读:42 建站运维

合并来源:四家获取指南 + 长期免费/定期补量平台清单 + CC Switch 统一管理方案
整理日期:2026-08-19 | 适用工具:Hermes Agent / OpenClaw / Claude Code / Codex 等


一、方案总览

本方案解决两个问题:

  1. 从哪里免费获取 API Key(10 个长期可用平台)
  2. 怎么统一管理这些 Key(CC Switch 桌面控制中心,原生支持 7 个 AI 工具)
┌─────────────────────────────────────────────┐
│              CC Switch(统一管理层)           │
│   Provider 切换 / 故障转移 / 用量监控 / MCP     │
└───┬───────┬───────┬───────┬───────┬─────────┘
    │       │       │       │       │
  Hermes  OpenClaw Claude  Codex  Gemini CLI
  Agent           Code              OpenCode

推荐路径:先拿一个智谱 GLM Key(永久免费)→ 用 CC Switch 统一管理 → 自动写入 Hermes / OpenClaw 等工具配置。


二、统一管理工具:CC Switch

是什么

CC Switch(GitHub,90.4k Stars,MIT 开源)是一款桌面控制中心,把多 Provider 切换、本地路由、故障转移、用量可见性集中到一个应用里。

原生支持 7 个应用

# 应用 支持
1 Claude Code ✅
2 Claude Desktop ✅
3 Codex ✅
4 Gemini CLI ✅
5 OpenCode ✅
6 OpenClaw ✅
7 Hermes Agent ✅

重点:Hermes Agent 和 OpenClaw 都是原生支持,配置会自动写入对应工具的配置文件,无需手动改环境变量。

核心能力

能力 说明
50+ 供应商预设 内置 GLM、DeepSeek、Kimi、MiniMax、SiliconFlow、OpenRouter 等模板,选预设只填 Key
自动故障转移 主 Provider 异常自动切备用(熔断器 + 健康监控 + 故障转移队列)
用量可见 实时追踪请求、Token、成本、缓存命中、订阅额度
本地路由 统一端点转发,热切换、请求日志、协议转换(Responses ↔ Chat Completions)
MCP / Skills / 会话 跨应用同步 MCP、Skills、Prompts、Hermes Memory
安全本地存储 所有 Key 存 SQLite,不外发
云同步 Dropbox / OneDrive / iCloud / WebDAV 备份配置

与手动 .env 的对比

维度 手动改 ~/.hermes/.env CC Switch
多 Provider 切换 改文件 + 重启 一键 GUI 切换
故障转移 自己写 fallback_model 内置熔断 + 自动切换
用量监控 无 实时面板
跨工具统一 每个 CLI 各配各的 7 个应用一套配置
Key 安全 明文 .env SQLite 加密存储

安装(macOS)

brew install --cask cc-switch

或从 GitHub Releases 下载 DMG。系统要求 macOS 10.15+(当前 13.7.8 满足)。

配置流程

  1. 打开 CC Switch → 顶部选 Hermes Agent(或 OpenClaw)标签页
  2. 点「添加供应商」→ 从预设选「智谱 GLM」→ 填入 API Key
  3. 切换为当前供应商 → 配置自动写入 Hermes
  4. (可选)添加 Kimi / DeepSeek 等作为 fallback,设置故障转移规则
  5. (可选)开启本地路由 → 启用用量监控

三、免费 API Key 获取指南(10 个平台)

A. Hermes / OpenClaw 直接支持的 Provider(优先配置)

这四家有 Hermes .env 专属变量,CC Switch 也有原生预设。

1. 智谱 GLM(z.ai)⭐⭐⭐⭐⭐ 首选

项目 详情
注册地址 https://open.bigmodel.cn/
Hermes 变量 GLM_API_KEY
Base URL https://api.z.ai/api/paas/v4
免费规则 GLM-4.7-Flash 永久免费,无 Token 总量上限,仅限并发 30
补量机制 无过期时间,额度不清零,可长期稳定调用
新人福利 注册送 2000 万 Token 体验包(GLM-5 等付费模型可用,3 个月有效)
核心优势 中文对话 + 工具调用能力突出,国内直连无障碍,与 GLM-5.2 环境天然匹配

获取步骤:

  1. 打开 https://open.bigmodel.cn/ → 右上角「注册/登录」(手机号注册)
  2. 登录后进「控制台」→ 左侧「API Keys」
  3. 点「新建 API Key」→ 命名 → 立即复制保存(仅显示一次)
  4. Key 格式形如 xxxxxxxx.xxxxxxxxxxxxxxxx

长期可用结论:GLM-4.7-Flash 永久免费无上限,日常 Agent 任务完全够用,是零成本长期方案。


2. DeepSeek ⭐⭐⭐⭐ 性价比之王

项目 详情
注册地址 https://platform.deepseek.com/
Hermes 变量 DEEPSEEK_API_KEY
Base URL https://api.deepseek.com
免费规则 新用户送约 100 万 Token(30 天有效),无长期免费层
补量机制 一次性,过期清零不可续领
价格 输入 0.002 元/千 token,输出 0.008 元/千 token(极低)
核心优势 OpenAI 完全兼容,代码生成 + 数学推理强,迁移成本为零

获取步骤:

  1. 打开 https://platform.deepseek.com/(邮箱/Google/GitHub 登录)
  2. 左侧「API Keys」→「Create new API Key」
  3. 命名 → 生成 → 立即复制(仅显示一次)

长期可用结论:免费额度用完后需充值,但价格极低,适合作为付费兜底。


3. Kimi / 月之暗面 ⭐⭐⭐⭐ 长上下文专家

项目 详情
注册地址 https://platform.moonshot.cn/
Hermes 变量 KIMI_API_KEY(sk-kimi- 前缀走 api.kimi.com)
免费规则 免费版 3 次/分钟调用,无 Token 总量上限
补量机制 频率限制按分钟自动刷新,长期有效
新人福利 注册送 15 元代金券(永久)
核心优势 256K 超长上下文,长文档处理体验优异

获取步骤:

  1. 打开 https://platform.moonshot.cn/ → 注册登录
  2. 「API Key 管理」→ 添加 → 命名 → 立即复制保存(仅显示一次)

长期可用结论:3 次/分钟免费无上限,适合低频长上下文场景,长期可用。


4. OpenRouter ⭐⭐⭐ 聚合平台(需翻墙)

项目 详情
注册地址 https://openrouter.ai/keys
Hermes 变量 OPENROUTER_API_KEY
免费规则 带 :free 后缀的数百款开源模型长期免费
补量机制 免费调用额度按日重置,无需绑定信用卡
核心优势 一个 Key 调 Claude/GPT/Gemini/GLM 等海量模型,横向对比极方便

获取步骤:

  1. 打开 https://openrouter.ai/keys(Google/GitHub 登录)
  2. 「Create Key」→ 复制

长期可用结论::free 模型每日重置,长期可用,但需翻墙且免费模型能力有限。


B. 其他长期免费平台(CC Switch 自定义端点 / Hermes 间接支持)

以下平台大多提供 OpenAI 兼容端点,在 CC Switch 中以「自定义网关」添加,或通过 Hermes config.yaml 的 base_url + key_env 接入。

5. 硅基流动 SiliconFlow ⭐⭐⭐⭐

项目 详情
注册地址 https://siliconflow.cn/
免费规则 数十款指定开源模型长期免费,单模型 1000 RPM
补量机制 每日自动重置,无截止日期
核心优势 一个 Key 通调 DeepSeek、Qwen3 等多款热门模型,国内低延迟

接入方式:CC Switch 预设含 SiliconFlow;Hermes 中在 fallback_model 配 base_url + key_env。


6. Google Gemini(AI Studio)⭐⭐⭐⭐

项目 详情
注册地址 https://aistudio.google.com/app/apikey
Hermes 变量 GOOGLE_API_KEY(或 GEMINI_API_KEY)
免费规则 Flash 系列长期免费,仅限频率;Pro 每日 100 次
补量机制 每日自动刷新请求次数,无过期
核心优势 多模态长文档处理强,Hermes 有原生支持

7. Groq ⭐⭐⭐ 超低延迟

项目 详情
注册地址 https://console.groq.com/
Hermes 变量 GROQ_API_KEY(Hermes 用于 STT 语音转写)
免费规则 指定开源模型长期免费,基础频率限速
补量机制 按小时自动刷新,无总量限制
核心优势 推理速度极快,延迟 <100ms

注意:Hermes 中 GROQ_API_KEY 主要用于 Whisper 语音转写,非 LLM 对话主路径。


8. 魔搭社区 ModelScope ⭐⭐⭐

项目 详情
注册地址 https://modelscope.cn/
免费规则 每日 2000 次免费调用,覆盖全品类模型
补量机制 每日零点自动重置,无截止日期
核心优势 注册无需实名,上手极低,17 万+ 开源模型

9. 百度千帆 ⭐⭐⭐

项目 详情
注册地址 https://console.bce.baidu.com/qianfan/
免费规则 ERNIE-Lite / Speed-8K 长期免费,300 RPM
补量机制 无过期时间,长期稳定
核心优势 数理逻辑强,适配团队协作

10. LongCat 龙猫 ⭐⭐⭐

项目 详情
免费规则 Flash-Lite 每日 5 亿 Tokens,Chat 每日 500 万 Tokens
补量机制 每日自动刷新,长期有效
核心优势 编程场景深度优化,适配 OpenClaw 等开发工具

四、长期免费对比总表

平台 免费模式 补量频率 总量上限 Hermes 变量 CC Switch 预设 翻墙 推荐场景
智谱 GLM 永久免费 不清零 无(Flash) GLM_API_KEY ✅ ❌ 日常 Agent 首选
Kimi 频率免费 按分钟 无 KIMI_API_KEY ✅ ❌ 长上下文场景
硅基流动 模型免费 每日 无 自定义端点 ✅ ❌ 多模型对比
OpenRouter 模型免费 每日 无 OPENROUTER_API_KEY ✅ ✅ 海外模型聚合
Google Gemini 频率免费 每日 无 GOOGLE_API_KEY ✅ ✅ 多模态长文档
魔搭社区 次数免费 每日 2000次/日 自定义端点 — ❌ 开源模型试玩
百度千帆 永久免费 不清零 无 自定义端点 — ❌ 数理逻辑
LongCat 额度免费 每日 5亿/日 自定义端点 — ❌ 编程场景
Groq 频率免费 每小时 无 GROQ_API_KEY ✅ ✅ 超低延迟/语音
DeepSeek 一次性 不补 ~100万 DEEPSEEK_API_KEY ✅ ❌ 付费兜底

五、配置方案

方案 A:CC Switch 统一管理(推荐)

# 1. 安装
brew install --cask cc-switch

# 2. 打开 CC Switch
open -a "CC Switch"

在 GUI 中操作:

  1. 顶部选 Hermes Agent 标签 → 添加供应商「智谱 GLM」→ 填 Key → 设为当前
  2. (可选)添加 OpenClaw 标签 → 同一 Key 共享
  3. (可选)添加 Kimi / DeepSeek 作为 fallback → 设置故障转移规则
  4. 开启本地路由 → 启用用量监控

优点:零配置文件编辑、自动故障转移、用量可见、7 工具共享配置。

方案 B:手动 .env(最小可用,零成本)

只需一个 Key 即可启动 Hermes:

# ~/.hermes/.env
GLM_API_KEY=你的智谱Key

方案 C:手动多 Provider fallback

# ~/.hermes/.env
GLM_API_KEY=你的智谱Key
KIMI_API_KEY=你的KimiKey
OPENROUTER_API_KEY=你的OpenRouterKey
DEEPSEEK_API_KEY=你的DeepSeekKey
# ~/.hermes/config.yaml
model:
  default: glm-4.7-flash
fallback_model:
  provider: kimi-coding
  model: kimi-k2.5

获取顺序建议

优先级 平台 原因
第一 智谱 GLM 永久免费无限量,国内直连,与 GLM-5.2 环境匹配
第二 Kimi 频率免费长期可用,256K 长上下文互补
第三 DeepSeek 一次性免费额度,用完低价兜底
第四 OpenRouter 需翻墙,聚合海外模型,按需配置

六、执行工作顺序

按以下顺序逐步执行,每步完成再进下一步。分「最小可用」和「完整加固」两个阶段。

阶段一:最小可用(零成本跑通,约 30 分钟)

步骤 操作 命令/动作 验证点
1 安装 CC Switch brew install --cask cc-switch 终端无报错,应用可启动
2 启动 CC Switch open -a "CC Switch" 菜单栏出现 CC Switch 图标
3 注册智谱 GLM 账号 打开 https://open.bigmodel.cn/ 注册 收到验证短信,能进控制台
4 获取 GLM API Key 控制台 → API Keys → 新建 → 复制 Key 形如 xxxxxxxx.xxxx,已保存
5 CC Switch 配置 Hermes 顶部选 Hermes Agent → 添加供应商「智谱 GLM」→ 填 Key → 设为当前 供应商行显示「当前」标记
6 Hermes 基础检查 hermes doctor 全绿,无报错
7 Hermes 状态确认 hermes status Provider=GLM,Model=glm-4.7-flash
8 链路验证 hermes chat -q "你好" 返回正常回复

阶段一完成标志:第 8 步 hermes chat 能正常对话 = Hermes 配置完成,链路通畅,零成本长期可用。

阶段二:完整加固(多 Provider + 故障转移,按需进行)

步骤 操作 验证点
9 OpenClaw 接入 CC Switch 顶部切 OpenClaw 标签 → 添加智谱 GLM → 设为当前 OpenClaw 也能用同一 Key
10 注册 Kimi 账号获取 Key https://platform.moonshot.cn/ 注册 → API Key 管理复制 Key 已保存(sk- 开头)
11 CC Switch 添加 Kimi Hermes 标签 → 添加供应商「Kimi」→ 填 Key Kimi 出现在供应商列表
12 设置故障转移 CC Switch → 故障转移规则:智谱 GLM(主)→ Kimi(备) 规则已保存
13 开启本地路由 CC Switch → 设置 → 路由 → 打开总开关 + Hermes/OpenClaw 接管 端口 127.0.0.1:15721 活跃
14 启用量监控 CC Switch → 用量面板查看请求/Token/成本 面板有数据返回
15 (可选)注册 DeepSeek https://platform.deepseek.com/ 获取 Key → CC Switch 添加为第三 fallback 付费兜底就绪
16 (可选)OpenRouter 需翻墙,获取 Key → 添加为海外模型通道 海外模型可调

工作顺序流程图

阶段一(最小可用)
  ┌─ 1. brew install cc-switch
  ├─ 2. 启动 CC Switch
  ├─ 3. 注册智谱 GLM
  ├─ 4. 获取 GLM Key
  ├─ 5. CC Switch 配 Hermes
  ├─ 6. hermes doctor
  ├─ 7. hermes status
  └─ 8. hermes chat "你好"  ← 阶段一完成,可日常使用
       │
阶段二(完整加固,按需)
  ├─ 9.  OpenClaw 接入
  ├─ 10. 注册 Kimi
  ├─ 11. 添加 Kimi 到 CC Switch
  ├─ 12. 配故障转移 GLM→Kimi
  ├─ 13. 开本地路由
  ├─ 14. 启用量监控
  ├─ 15. (可选) DeepSeek 兜底
  └─ 16. (可选) OpenRouter 海外

环境前置检查(开工前确认)

检查项 命令 要求
macOS 版本 sw_vers ≥ 10.15(当前 13.7.8 ✓)
Homebrew brew --version 已安装
Hermes Agent hermes --version 已安装(当前 v0.20.1 ✓)
Hermes 配置目录 ls ~/.hermes/ 目录存在

七、使用注意事项


八、New API vs CC Switch 方案对比

两者不是竞品,而是不同层的东西:New API 是服务端网关,CC Switch 是客户端切换器,可以组合使用。

基本定位

维度 New API CC Switch
本质 服务端 LLM API 网关/代理 客户端桌面配置切换器
运行位置 服务器(Docker/二进制) 本机(桌面 App)
工作方式 所有工具指向一个端点,网关转发到各厂商 写入每个工具自己的配置文件,工具直连厂商
架构 Go 后端 + React 管理台 + 多适配器中继层 Tauri 2(Rust + TypeScript)桌面应用

项目规模与成熟度

指标 New API CC Switch
GitHub Stars 43.6k 90.4k
代码量 ~1989 文件(571 Go + 1200+ 前端) Tauri 桌面应用
开源协议 AGPL-3.0(传染性,闭源套壳受限) MIT(商用无限制)
维护方 QuantumNous 组织 Jason Young(farion1231)
下载量 Docker 镜像广泛使用 7.0M 下载
维护活跃度 持续发布,非常活跃 v3.16.3,活跃

功能深度对比

能力 New API CC Switch
Provider 数量 40+ 厂商适配器 50+ 预设
格式转换 OpenAI/Claude/Gemini 多格式互转 协议转换(Responses↔Chat)
多模态 Midjourney/Suno/视频/音频/Rerank 仅 LLM 对话
故障转移 渠道加权随机+自动重试+故障渠道禁用 熔断器+健康监控+故障转移队列
负载均衡 多 Key 轮询 无(单用户)
计费/额度 按量/按次/缓存计费+令牌分组 仅用量统计
用户管理 多用户+独立 API Key+配额 单用户
在线支付 易支付/Stripe/兑换码 无
管理界面 Web 管理台+数据看板 桌面 GUI
MCP/Skills 无 跨应用同步
会话管理 无 Session 浏览+恢复
云同步 无 Dropbox/iCloud/WebDAV
支持工具数 对外一个端点(不限工具) 7 个原生支持

成熟度综合评分

维度 New API CC Switch
企业级成熟度 ⭐⭐⭐⭐⭐ ⭐⭐⭐
个人开发友好度 ⭐⭐⭐ ⭐⭐⭐⭐⭐
功能深度 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐
部署门槛 ⭐⭐⭐(需服务器+Docker) ⭐⭐⭐⭐⭐(brew 一行装)
商用安全 ⭐⭐(AGPL 限制) ⭐⭐⭐⭐⭐(MIT)
生态规模 ⭐⭐⭐⭐⭐(企业采用) ⭐⭐⭐⭐⭐(下载量大)

选型建议

场景 选谁
个人开发者本机切换 Hermes/OpenClaw/Claude Code CC Switch
团队/SaaS 多用户共享额度、计费配额 New API
对外提供 API 服务、多 Key 负载均衡 New API
多模态(Midjourney/Suno/图像/音频) New API
跨工具配置同步(MCP/Skills/Session) CC Switch
闭源商用产品 CC Switch(MIT),New API 受 AGPL 限制

最佳组合:两层各司其职

本机工具层         CC Switch(客户端切换器)          服务端网关层
┌────────┐         ┌──────────────┐                 ┌──────────────┐
│ Hermes │──┐      │ Provider 切换 │      ┌────────│ New API 网关  │
│OpenClaw│──┼─────▶│ 故障转移      │─────▶│        │ 多Key负载均衡 │──┐
│Claude  │──┘      │ 用量监控      │      │        │ 计费/配额     │  │
└────────┘         └──────────────┘      │        └──────────────┘  │
                                          │                          ▼
                          CC Switch 指向 New API 端点    GLM / Kimi / DeepSeek / ...

九、同类产品全景

A. CC Switch 同类(客户端配置切换器)

管「本机 AI 编程工具配置」的工具,不做服务端代理。目前 CC Switch 一家独大,无真正对等竞品。

工具 类型 语言/框架 协议 特色 与 CC Switch 差异
CC Switch 桌面 GUI 切换器 Tauri 2 (Rust) MIT 7 应用原生支持、50+ 预设、MCP/Skills 同步、云同步 — 基准
Claude Code Router CLI 路由层 Node.js MIT 把 Claude Code 请求路由到 DeepSeek/Ollama/Gemini/OpenRouter 无 GUI,纯 CLI 路由,只管 Claude Code
Crush (Charm) 终端 Agent Go MIT 多模型切换 + LSP 上下文 + MCP,颜值高 是替代 Claude Code 的 Agent,不是配置管理器
Claude Code UI Web/手机 UI React+Express GPL-3.0 远程管理 Claude Code 会话/项目 是 UI 层,不做 Provider 切换
Claude Code 中文开发套件 中文化套件 Shell — 三层中文文档+指令中文化 只做汉化,无切换能力
HamGuy/ccswitch Mac 菜单栏 Swift — 极简菜单栏切换 只切 Claude Code,功能单一

B. New API 同类(服务端 AI 网关)

赛道成熟,产品多,分三个梯队。

第一梯队:纯网关(OpenAI 兼容,开源)

项目 语言 Stars 协议 定位 活跃度
New API Go ~50k AGPLv3 One API 演进版,国内企业首选 🟢 活跃
One API Go ~25k MIT 国内最早的开源网关 ⏸️ 停滞(建议迁移 New API)
LiteLLM Python ~53.6k MIT Python 生态首选,100+ 供应商 🟢 活跃(每周发布)
Portkey TypeScript ~7k MIT 国际标准,1600+ 模型,有云服务 🟢 活跃
OmniRoute TypeScript ~13k — 个人省钱神器,Token 压缩 15-95%,免费 tier 聚合 🟢 活跃

第二梯队:基础设施级网关(带 AI 原生能力)

项目 语言 协议 特色
AISIX (APISIX 团队) Rust Apache-2.0 28,300 req/s,语义路由+模型合议+MCP 网关
Higress (阿里) Go/Envoy Apache-2.0 云原生,Wasm 插件,自动识别双协议
Bifrost (Maxim AI) Go Apache-2.0 单二进制,~11µs 开销,极致吞吐
Kong AI Gateway Lua/Kong Apache-2.0 适合已有 Kong 架构的团队
LLM Gateway Docker AGPLv3 全平台(UI+路由+缓存+分析),一行 Docker 启动
GoModel Go — 1.1k stars,LiteLLM 的 Go 替代
Otari (Mozilla) Python — 40+ 供应商,虚拟 Key+预算
Busbar Rust — 单 Rust 二进制,真实故障转移

第三梯队:商业/SaaS 网关

产品 公司 特色
OpenRouter OpenRouter SaaS only,透传定价,5.5% 手续费
Cloudflare AI Gateway Cloudflare 全球边缘,核心免费
Amazon Bedrock AWS AWS 原生
Azure AI Gateway Microsoft Azure 生态
Google AI Gateway Google Cloud GCP 集成
Kosmoy Kosmoy 企业级治理,气隙部署

C. 两类赛道对比总结

维度 客户端切换器(CC Switch 类) 服务端网关(New API 类)
同类数量 ~6 个,CC Switch 一家独大 20+ 个,竞争激烈
成熟度 新兴赛道,CC Switch 最全 高度成熟,三梯队分明
核心差异 管配置文件,不起服务 起代理服务,做转发
选型难度 低(直接 CC Switch) 高(需按场景选)
服务端推荐 — 国内多厂商+计费→New API;Python 生态→LiteLLM;极致性能→AISIX/Bifrost;不想运维→OpenRouter/Cloudflare

十、参考资料

文章导出
预览框
生成预览中...

安全 AI 运维 文档

收到1条评论
avatar
实操派 1 个月前
本机配置实操记录

当前机器状态盘点完毕。代理框架已安装到本地目录,配置文件存在但模型和提供商均未设置,接口密钥文件不存在,包管理器未安装,切换工具也未安装。唯一卡点是缺少一个接口密钥。

三步搞定。

第一步 去智谱开放平台注册拿密钥。手机号注册登录进控制台,新建密钥并复制保存。基础模型永久免费无限制,不花一分钱就能跑。

第二步 把密钥交给配置脚本。拿到密钥后直接粘贴过来,脚本自动写入环境变量文件,配置默认模型和提供商,同时启用多提供商兜底链路。

第三步 验证跑通。先跑健康检查命令确认全绿,再跑状态命令确认提供商已就绪,最后跑对话命令实测能正常回复。

关于切换工具。切换工具依赖包管理器,本机暂未安装。两条路可选。第一条先跳过切换工具直接手写配置文件,效果完全一样而且省事。第二条先装包管理器再装切换工具,以后用图形界面管理更直观。建议先手动配通跑起来,后面想要界面再装也不迟。

现在就去第一步,注册智谱拿密钥,拿到了继续往下配。