只想与 Claude 聊天？访问 claude.ai！

想直接深入了解我们的 API？跳转到我们的 API 参考文档以获取更多详细信息。

让我们快速帮助您开始使用 Claude！在本指南中，我们将引导您完成设置环境、安装必要的库以及向 Claude 发送第一个 API 请求的过程。让我们开始吧！

请注意，虽然本指南使用我们的 Python SDK，但我们也维护 TypeScript SDK 并支持直接的 HTTP 集成。有关详细信息，请参阅我们的客户端 SDK 和 API 参考文档。

​
先决条件

在开始之前，请确保您具备以下条件：

  • 具有 API 访问权限的帐户（请参阅我们的获取 Claude 访问权限指南）
  • API 密钥（可通过您的帐户设置获得）
  • 在您的计算机上安装了 Python 3.7.1 或更新版本

​
步骤 1：设置环境

复制我们的 quickstart Google Colab notebook，无需设置环境即可立即开始！

首先，确保您已安装 Python。打开终端（在 macOS 上）或命令提示符（在 Windows 上）并输入：

Shell
python --version

如果您看到类似 “Python 3.12.2” 的版本号，则说明一切就绪。如果没有，请访问 Python 官方网站并下载最新版本。

​
（可选）创建虚拟环境

虽然不是强制性的，但建议为您的 Claude 项目创建虚拟环境。这有助于保持依赖项的组织性，并防止与其他项目发生冲突。要创建虚拟环境，请运行：

Shell
python -m venv claude-env

然后，激活它：

  • 在 macOS 或 Linux 上：source claude-env/bin/activate
  • 在 Windows 上：claude-env\Scripts\activate

​
步骤 2：安装 Anthropic Python SDK

设置好环境后，就可以安装 Claude Python 库了。只需运行：

Shell
pip install anthropic

此命令将安装最新版本的库以及任何必要的依赖项。

​
步骤 3：（可选）设置 API 密钥

要使用 Claude，您需要提供 API 密钥。您可以通过设置环境变量，使 API 密钥可用于所有 Claude 项目。方法如下：

  • 在 macOS 或 Linux 上：
    1. 打开终端并输入：nano ~/.bash_profile（如果您使用较新版本的 macOS，则输入 nano ~/.zshrc）
    2. 将此行添加到文件中，将 your-api-key-here 替换为您的实际 API 密钥：export ANTHROPIC_API_KEY='your-api-key-here'
    3. 保存文件并退出编辑器（按 Ctrl+O，然后按 Enter，再按 Ctrl+X）
    4. 通过运行以下命令加载更新后的配置文件：source ~/.bash_profile（或 source ~/.zshrc）
  • 在 Windows 上：
    1. 打开命令提示符并输入：setx ANTHROPIC_API_KEY "your-api-key-here"，将 your-api-key-here 替换为您的实际 API 密钥
    2. 要使此更改永久生效，请按照以下步骤操作：
      • 右键单击”此电脑”或”我的电脑”，然后选择”属性”
      • 单击”高级系统设置”
      • 单击”环境变量”按钮
      • 在”系统变量”部分中，单击”新建…”并输入 ANTHROPIC_API_KEY 作为变量名，输入您的 API 密钥作为变量值

​
步骤 4：发送第一个 API 请求

您已经快要完成了！让我们向 Claude 发送第一个 API 请求。创建一个新的 Python 文件（例如 claude_test.py）并添加以下代码：

Python
import anthropic

client = anthropic.Anthropic(
    # 默认为 os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="只用尤达语回答。",
    messages=[
        {"role": "user", "content": "你今天好吗？"}
    ]
)

print(message.content)

让我们分析一下这里发生了什么：

  • 我们导入了 anthropic 库，它提供了一种与 Claude API 交互的便捷方式。
  • 我们创建了一个 Anthropic 客户端实例，传入我们的 API 密钥（如果您设置了环境变量，则可以省略此步骤）。
  • 我们调用 messages.create() 方法向 Claude 发送消息。我们指定要使用的模型（claude-3-opus-20240229）、响应中的最大令牌数（max_tokens=1000）、温度（控制输出的随机性，temperature=0.0 表示最小随机性）以及系统消息（设置对话的上下文）。
  • 最后，我们打印 Claude 的响应。

要运行代码，只需在终端或命令提示符中输入 python claude_test.py。您应该会看到 Claude 的一个类似谚语的回复！

访问 Messages API 示例以获取更多 API 调用结构的示例。有关 API 参数的更多信息，请参阅 Messages API 参考。

​
后续步骤

恭喜您成功向 Claude 发送了第一个 API 请求！以下是一些后续步骤，以继续您的旅程。

​
API 资源

深入我们的 API 文档以获取有关可用端点和参数的更多详细信息。

查看我们的客户端 SDK，了解一组工具，使您更容易使用 Claude 构建应用程序并将其集成到您的应用程序中。

​
Anthropic 手册

Anthropic 手册包含一组以 Jupyter 笔记本形式呈现的食谱。这些笔记本包含可复制的代码，演示了如何在更高级的场景中以巧妙有效的方式使用 Claude，例如上传 PDF、工具使用和函数调用、嵌入等。

​
其他资源

  • 访问我们的迁移指南，了解如何将您的用例过渡到 Claude。
  • 探索术语表，熟悉 AI、LLM 和 Claude 生态系统中使用的术语。
  • 加入我们的开发者 Discord 服务器，与其他开发者联系，提出问题并分享您的项目。
  • 访问提示库，获取各种任务的灵感和随时可用的提示，或通过查看提示简介来尝试提示工程。

我们期待看到您使用 Claude 创造的内容。祝您编码愉快！

欢迎使用 Claude获取 Claude 的访问权限