Anthropic API Key 现在必须在创建时设置有效期：操作团队需在 Key 开始失效前完成审计

你的团队为 Claude API 创建的每一个 API key，现在都必须在创建时做出有效期决策。Anthropic 在 7 月 8 日的平台更新中修改了 Claude Console 的 key 创建流程——操作者必须在 key 签发前选择一个有效期：预设选项（3 小时、1 天、7 天或 30 天）、自定义时长，或明确选择永不过期。Admin API 现在在每个 key 上都会返回 expires_at 字段。此次更改前创建的 key 不受影响，但默认安全姿态的转变意味着你的凭证治理基准线已经改变。

这不是一次倒计时式的弃用公告，而是 Anthropic 对团队思考 API 凭证生命周期方式的结构性调整——直接影响你在大规模路由、轮换和监控 Claude API 访问时的工程决策。

7 月 8 日发生了什么

7 月 8 日之前，Claude Console 在创建 API key 时并不强制要求设置有效期。团队可以创建 key 后完全依靠内部流程来决定何时轮换——或者干脆忽略这个问题。自 7 月 8 日起，Console 在 key 签发时强制要求做出决策。

可选选项如下：

关键点：有效期在创建时设定，之后无法更改。如果你的组织将来设定了最大有效期策略，现有 key 不受影响，但新建 key 将受该上限约束。

同样的有效期选项现在也适用于在 Console 中创建 Admin API key——不只是普通 API key。

Admin API 信号：expires_at

更具运营意义的变更是：Admin API 的 List API Keys 和 Get API Key 端点现在会在每条 key 记录上返回 expires_at 字段。对于没有设置有效期的 key，该字段为 null。

这为你的监控层提供了构建到期预警所需的数据：

{
  "id": "apikey_01AbCdEfGhIjKlMn",
  "name": "prod-gateway-key",
  "status": "active",
  "expires_at": "2026-08-15T14:23:00Z",
  "created_at": "2026-07-16T14:23:00Z"
}

Anthropic 还增加了服务端邮件通知：对于有效期至少 14 天的 key，创建者会在到期前 7 天收到警告邮件；对于有效期至少 7 天的 key，提前 1 天通知。有效期短于 7 天的 key 到期时不会发送邮件。

key 过期后，使用该 key 发出的请求会返回 401 authentication_error。没有宽限期，过期的 key 无法重新激活。

为什么这对 AI 路由团队很重要

对于通过 AI gateway 或多 provider 路由层转发 Claude API 请求的团队而言，key 有效期引入了一类新的生产故障场景：静默 401 级联。

如果一个生产 key 到期，而你的路由层将 401 authentication_error 当作 provider 故障而非凭证问题处理，可能会触发 fallback 逻辑——将流量切换到备用 provider——而不暴露根本原因。路由层表面上看还在正常工作（请求通过 fallback 成功），但你的 Claude 容量已悄然不可用，成本也转移到了 fallback provider 上。

使用 API key 进行 gateway 鉴权的团队需要：

1. 通过 Admin API 盘点当前所有 key 及其 expires_at 值，在下一个 key 到期前完成审计。
2. 构建到期预警监控：每周轮询 Admin API，当任意 key 的 expires_at 距今不足 14 天时发出告警。
3. 在路由逻辑中区分 401 authentication_error 与 provider 不可用错误。Claude API 上的 401 应触发凭证轮换告警，而不是 provider fallback。
4. 为 gateway key 制定"永不过期"vs. 有限期的策略：如果你的路由 gateway 使用单一的长期 Claude API key，选择"永不过期"可以维持现有行为，但会放弃有效期所提供的泄露损失控制能力。

路由与运营视角分析

为主 gateway key 选择永不过期还是有限期有效期，是轮换摩擦与凭证卫生之间的权衡：

永不过期（配合 secrets manager 轮换）：适用于拥有成熟 secrets 管理流水线（AWS Secrets Manager、HashiCorp Vault、GCP Secret Manager）并配有自动化轮换和撤销机制的团队。key 在 Anthropic 侧永不过期，但你的内部流水线按自己的节奏轮换它。这符合 Anthropic 对 secrets manager 用户的推荐姿态。

30 天或自定义有限期：适用于希望对泄露凭证的有效时间设定硬上限的场景——即使 secrets manager 故障或轮换任务静默报错。缺点是路由基础设施必须将 key 轮换作为在线操作处理——在不中断请求的情况下更新 gateway 配置中的 key。

短期 key（小时/天级）用于自动化任务：适用于 CI 流水线、批处理任务，或任何非交互式工作负载（key 在任务开始时注入，任务结束时丢弃）。这类 key 与 Workload Identity Federation 互补——后者可彻底消除已有平台 OIDC 身份的工作负载对静态 key 的依赖。

TheRouter 用户应该关注什么

如果你通过 TheRouter 路由 Claude API 请求，你的 key 轮换策略决定了泄露的 gateway 凭证的最长可用时间。Admin API 的 expires_at 字段为你提供了构建自动化到期预警检查所需的数据：

• 使用 Admin API 确认你当前活跃 Claude key 的 expires_at 值。
• 如果你使用永不过期的 key，配合 secrets manager 轮换计划以及针对疑似泄露的硬性撤销流程。
• 对于需要配置更新才能完成 key 轮换的 gateway 部署，在生产 key 首次到期前测试零停机换 key 方案——尤其是当你运行有效期短于 30 天的 key 时。

5 月 26 日关于 OpenAI 侧的 keyless 鉴权与 Admin API 治理报道也涉及了类似主题。Anthropic 7 月 8 日的变更现在通过 Admin API 为 Claude 操作者提供了对等的凭证生命周期信号。