只想与 Claude 聊天?访问 claude.ai

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

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

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


先决条件

在开始之前,请确保您具备以下条件:

  • 具有 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 创造的内容。祝您编码愉快!