title: 添加和管理 API Key description: ARAI API Key 创建、CC Switch 配置导出、保存和泄露处理步骤。 keywords:
- ARAI API Key
- API Key 安全
- AI 中转站配置
添加和管理 API Key
API Key 是工具调用平台服务时使用的密钥。它可以让 Codex、Claude Code 或其他客户端通过 ARAI 中转站发起请求,所以必须像账户钥匙一样保管。
API Key 用途
API Key 通常用于这几件事:
- 让客户端知道请求要发到哪个平台。
- 让平台知道这次调用属于哪个账户。
- 让平台扣除对应订阅或额度。
- 让你区分不同工具或不同用途的调用来源。
添加或创建 API Key
登录控制台后,按页面实际显示进入 API Key、密钥、令牌或接入信息相关功能。具体按钮名可能变化,但流程通常是:
- 进入控制台。
- 找到 API Key 或接入信息相关页面。
- 点击新增、创建、生成或添加密钥。
- 给密钥起一个容易识别的名称,例如
codex-macbook或claude-code-work。 - 保存生成结果。
- 只把它填到你信任的客户端配置里。


导出 CC Switch 配置
ARAI 的 API Key 页面支持一键导出 CC Switch 配置。这样你不需要手动抄 API 地址、Key 和模型名,可以先从 ARAI 导出配置,再到 CC Switch 里导入并应用到 Codex 或 Claude Code。
推荐流程:
- 进入 ARAI 控制台的 API Key 页面。
- 找到要给 Codex 或 Claude Code 使用的 API Key。
- 使用页面上的“一键导出 CC Switch 配置”能力。
- 按页面提示下载配置文件,或复制导出的配置内容。
- 打开 CC Switch 基础用法,按“从 ARAI 一键导入配置”继续操作。
导出的配置可能包含敏感 Key。不要把它发到群聊、截图给别人、提交到公开仓库,或放进不可信的同步目录。

Key 命名规则
不要把所有工具都共用一个 Key。按用途命名:
| 用途 | 推荐名称 |
|---|---|
| Codex 本机使用 | codex-local |
| Claude Code 本机使用 | claude-code-local |
| 测试脚本 | test-script |
| 临时排错 | debug-temp |
这样当某个工具出问题或 Key 泄露时,可以更快定位和删除。
保存方式
- 优先保存在密码管理器里。
- 不要放进公开仓库。
- 不要截图发给别人。
- 不要写在文档正文里。
- 不要把 Key 当成普通配置随手复制到聊天窗口。
泄露后怎么处理
如果你怀疑 API Key 泄露:
- 立刻进入控制台。
- 找到对应 Key。
- 删除、禁用或重新生成。
- 检查最近调用记录和额度变化。
- 给相关客户端换上新的 Key。
验证结果
配置完成后,用一个低风险请求测试:
- 客户端能正常发起请求。
- 平台用量或调用记录能看到对应变化。
- 请求失败时,错误信息不是“Key 无效”或“未授权”。

常见问题
可以多人共用一个 Key 吗
不要多人共用一个 Key。多人共用会导致用量难追踪,也会让泄露后很难判断来源。
Key 复制后找不到了怎么办
如果平台不再显示完整 Key,就重新生成一个,并把旧 Key 禁用或删除。