展示了如何重复使用简洁的会话摘要，而不是反复粘贴大量上下文。

6.2 配置 API 密钥与速率限制

与 Claude Code 的每一次交互都通过 Anthropic 的 API 进行。为了安全、有效地使用它,开发者必须配置 API 密钥,并理解速率限制——这些无形的约束决定了你可以多频繁、多快速地发送请求。API 密钥用于验证你的身份;速率限制则确保共享基础设施的稳定性。两者共同决定了你的自动化流水线是顺畅运行,还是在部署中途被限流。在本节中,你将学习如何设置、保护和测试你的 Claude API 密钥,并编写轻量级代码,使其能够自动遵守速率限制,无需人工猜测。

概念阐述

API 密钥是一种安全凭证,在你与 Anthropic 的服务器交互时用于识别你的账户。它与你的组织计费方案、使用配额和模型访问层级相关联。安全地存储它至关重要——一旦泄露,可能被恶意利用来发起未授权请求,从而产生费用或导致账户被封禁。对于本地开发,环境变量提供了一种最安全的方式来存储 API 密钥,无需将其嵌入源代码中。

另一方面,速率限制定义了在特定时间窗口内你可以发送多少请求。Anthropic 按每分钟和按令牌使用量来强制执行这些限制。当超过限制时,你会收到 HTTP429 Too Many Requests 错误。好消息是,Claude 的 API 提供了足够的元数据,使你的客户端能够优雅地恢复。设计良好的代码可以检测到限流、自动退避,并在安全的时间间隔后恢复——使你的集成在轻负载和重负载下都能保持稳定运行。

实际来说,配置过程分为三个步骤:安全地存储你的 API 密钥、在脚本或应用程序中动态加载它,以及为 API 调用包装基本的速率限制处理逻辑。下一个示例将通过可运行的 Python 代码演示这一过程。

动手实践示例

让我们构建一个简单的脚本,使用环境变量进行身份验证来连接 Claude Code,并包含一个用于处理速率限制的重试机制。

本示例使用官方的 anthropic Python 客户端,它与 Claude Code 端点完全兼容。