AI帮助文档 main arai/api-key.md

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、密钥、令牌或接入信息相关功能。具体按钮名可能变化,但流程通常是:

  1. 进入控制台。
  2. 找到 API Key 或接入信息相关页面。
  3. 点击新增、创建、生成或添加密钥。
  4. 给密钥起一个容易识别的名称,例如 codex-macbookclaude-code-work
  5. 保存生成结果。
  6. 只把它填到你信任的客户端配置里。

ARAI API Key 管理页面

ARAI 创建 API Key 表单

导出 CC Switch 配置

ARAI 的 API Key 页面支持一键导出 CC Switch 配置。这样你不需要手动抄 API 地址、Key 和模型名,可以先从 ARAI 导出配置,再到 CC Switch 里导入并应用到 Codex 或 Claude Code。

推荐流程:

  1. 进入 ARAI 控制台的 API Key 页面。
  2. 找到要给 Codex 或 Claude Code 使用的 API Key。
  3. 使用页面上的“一键导出 CC Switch 配置”能力。
  4. 按页面提示下载配置文件,或复制导出的配置内容。
  5. 打开 CC Switch 基础用法,按“从 ARAI 一键导入配置”继续操作。

导出的配置可能包含敏感 Key。不要把它发到群聊、截图给别人、提交到公开仓库,或放进不可信的同步目录。

ARAI 一键导出 CC Switch 配置入口

Key 命名规则

不要把所有工具都共用一个 Key。按用途命名:

用途 推荐名称
Codex 本机使用 codex-local
Claude Code 本机使用 claude-code-local
测试脚本 test-script
临时排错 debug-temp

这样当某个工具出问题或 Key 泄露时,可以更快定位和删除。

保存方式

  • 优先保存在密码管理器里。
  • 不要放进公开仓库。
  • 不要截图发给别人。
  • 不要写在文档正文里。
  • 不要把 Key 当成普通配置随手复制到聊天窗口。

泄露后怎么处理

如果你怀疑 API Key 泄露:

  1. 立刻进入控制台。
  2. 找到对应 Key。
  3. 删除、禁用或重新生成。
  4. 检查最近调用记录和额度变化。
  5. 给相关客户端换上新的 Key。

验证结果

配置完成后,用一个低风险请求测试:

  • 客户端能正常发起请求。
  • 平台用量或调用记录能看到对应变化。
  • 请求失败时,错误信息不是“Key 无效”或“未授权”。

ARAI API Key 调用记录

常见问题

可以多人共用一个 Key 吗

不要多人共用一个 Key。多人共用会导致用量难追踪,也会让泄露后很难判断来源。

Key 复制后找不到了怎么办

如果平台不再显示完整 Key,就重新生成一个,并把旧 Key 禁用或删除。

相关页面