API 密钥管理

API 密钥是工具调用 ACode 的凭证。为不同用途单独创建，管理与排错都会更清楚。

创建密钥

在 API 密钥页面点击 创建密钥，按表单填写名称、分组及其他需要的限制。

建议用用途命名，例如 codex-laptop、my-app-dev，便于从列表中识别。选择分组前，先确认该分组支持目标模型与接口。

查看密钥状态

密钥列表会显示名称、分组、用量、过期时间和状态等信息。请求失败时，先确认密钥处于活跃状态，并且没有过期。

复制密钥时使用对应行的复制按钮。列表中的缩略显示不是完整密钥，不能直接拿来调用。

使用密钥与导入 CCS

• 使用密钥： 查看控制台提供的工具配置与接入说明。
• 导入到 CCS： 通过已安装的 CC Switch 导入配置。导入后核对工具类型、地址和分组，再启用。
• 分组： 按当前页面提供的操作查看或更换分组。分组变化可能影响可用模型与计费规则。

管理有效期与停用

不再使用的密钥可以停用。怀疑密钥泄露时，应立即禁用受影响的密钥，再为需要的工具换用新密钥。

对于已有密钥，编辑前先确认哪些程序正在使用它，避免修改后工具突然无法连接。

在代码中使用

把密钥存放在环境变量或服务端的凭据管理中，示例使用 ACODE_API_KEY：

macOS / Linux

export ACODE_API_KEY="sk-your-api-key"

Windows PowerShell

$env:ACODE_API_KEY="sk-your-api-key"

以上设置只对当前终端及它启动的程序生效。关闭终端后，需要重新设置或使用你自己的凭据管理方式。

只在自己的设备上填写真实密钥

不要把密钥写入公开仓库、截图或浏览器前端代码。示例环境变量中的值也不要原样发给客服。