Claude 快速入门

前提条件

• 一个 Claude Console 账户
• 一个 API 密钥

调用 API

cURL

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。下一步中的 cURL 命令会从 $ANTHROPIC_API_KEY 读取它。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 发起您的第一次 API 调用

   向 Messages API 发送 POST 请求：

   cURL

   curl https://api.anthropic.com/v1/messages \
     -H "content-type: application/json" \
     -H "x-api-key: $ANTHROPIC_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "model": "claude-opus-5-5",
       "max_tokens": 1000,
       "messages": [
         {
           "role": "user",
           "content": "What should I search for to find the latest developments in renewable energy?"
         }
       ]
     }'

   Claude 会返回一个包含助手消息的 JSON 响应：

   Output

   {
     "model": "claude-opus-5-5",
     "id": "msg_013mHbppMPd2PrVJzGMZPt2D",
     "type": "message",
     "role": "assistant",
     "content": [
       {
         "type": "text",
         "text": "Here are some effective search strategies to find the latest developments in renewable energy:\n\n## General Search Terms\n- \"Renewable energy news 2025\"\n- ..."
       }
     ],
     "stop_reason": "end_turn",
     "stop_sequence": null,
     "stop_details": null,
     "usage": {
       "input_tokens": 21,
       "output_tokens": 305
     }
   }

CLI

1. 安装 CLI

   使用 Homebrew 安装 Anthropic CLI：

   brew install anthropics/tap/ant

   有关其他安装方法，请参阅 CLI 快速入门中的安装。

2. 身份验证

   使用您的 Anthropic 账户登录：

   ant auth login

   这会打开一个基于浏览器的 OAuth 流程。授权后，使用以下命令确认您的凭据：

   ant auth status

   在没有浏览器的远程主机上，传入 --no-browser 以获取一个可以在其他设备上打开的 URL，然后将返回的代码粘贴回终端。对于 CI 等非交互式环境，请参阅 CLI 身份验证选项。

3. 发起您的第一次 API 调用

   在终端中运行 ant messages create：

   CLI

   ant messages create \
     --model claude-opus-5-5 \
     --max-tokens 1000 \
     --message '{
       role: user,
       content: "What should I search for to find the latest developments in renewable energy?"
     }'

   CLI 会打印 JSON 响应：

   Output

   {
     "model": "claude-opus-5-5",
     "id": "msg_01N1ycuCkM5Mzd7WhTU4fwST",
     "type": "message",
     "role": "assistant",
     "content": [
       {
         "type": "text",
         "text": "Here are some effective search strategies to find the latest developments in renewable energy:\n\n## General Search Terms\n- \"Renewable energy news 2025\"\n- ..."
       }
     ],
     "stop_reason": "end_turn",
     "stop_sequence": null,
     "stop_details": null,
     "usage": { "input_tokens": 21, "output_tokens": 305 }
   }

Python

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   mkdir claude-quickstart && cd claude-quickstart
   python3 -m venv .venv && source .venv/bin/activate
   pip install anthropic

3. 编写代码

   创建一个名为 quickstart.py 的文件：

   Python

   import anthropic
   
   client = anthropic.Anthropic()
   
   message = client.messages.create(
       model="claude-opus-5-5",
       max_tokens=1000,
       messages=[
           {
               "role": "user",
               "content": "What should I search for to find the latest developments in renewable energy?",
           }
       ],
   )
   
   for block in message.content:
       if block.type == "text":
           print(block.text)

4. 运行代码

   python quickstart.py

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

TypeScript

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   mkdir claude-quickstart && cd claude-quickstart
   npm init -y
   npm pkg set type=module
   npm install @anthropic-ai/sdk

3. 编写代码

   创建一个名为 quickstart.ts 的文件：

   TypeScript

   import Anthropic from "@anthropic-ai/sdk";
   
   const client = new Anthropic();
   
   const message = await client.messages.create({
     model: "claude-opus-5-5",
     max_tokens: 1000,
     messages: [
       {
         role: "user",
         content: "What should I search for to find the latest developments in renewable energy?"
       }
     ]
   });
   
   for (const block of message.content) {
     if (block.type === "text") {
       console.log(block.text);
     }
   }

4. 运行代码

   npx tsx quickstart.ts

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

C#

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   创建一个新的控制台项目并添加 Anthropic 包：

   dotnet new console -n ClaudeQuickstart
   cd ClaudeQuickstart
   dotnet add package Anthropic

3. 编写代码

   替换 Program.cs 的内容：

   C#

   using Anthropic;
   using Anthropic.Models.Messages;
   
   var client = new AnthropicClient();
   
   var message = await client.Messages.Create(new MessageCreateParams
   {
       Model = Model.ClaudeOpus5_5,
       MaxTokens = 1000,
       Messages =
       [
           new UserMessageParam
           {
               Content = "What should I search for to find the latest developments in renewable energy?",
           },
       ],
   });
   
   foreach (var block in message.Content)
   {
       if (block.TryPickText(out var textBlock))
       {
           Console.WriteLine(textBlock.Text);
       }
   }

4. 运行代码

   dotnet run

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

Go

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   创建一个新模块并添加 Anthropic SDK：

   mkdir claude-quickstart && cd claude-quickstart
   go mod init claude-quickstart
   go get github.com/anthropics/anthropic-sdk-go/v2

3. 编写代码

   创建一个名为 main.go 的文件：

   Go

   package main
   
   import (
   	"context"
   	"fmt"
   	"log"
   
   	"github.com/anthropics/anthropic-sdk-go/v2"
   )
   
   func main() {
   	client := anthropic.NewClient()
   
   	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
   		Model:     anthropic.ModelClaudeOpus5_5,
   		MaxTokens: 1000,
   		Messages: []anthropic.MessageParam{
   			anthropic.NewUserMessage(anthropic.NewTextBlock("What should I search for to find the latest developments in renewable energy?")),
   		},
   	})
   	if err != nil {
   		log.Fatal(err)
   	}
   
   	for _, block := range message.Content {
   		if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok {
   			fmt.Println(textBlock.Text)
   		}
   	}
   }

4. 运行代码

   go run .

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

Java

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 设置您的项目

   您的 PATH 中需要有 JDK（25 或更高版本）以及 Gradle 或 Maven 之一。为您的项目创建一个目录，并在其中创建 Java 源代码目录：

   mkdir -p claude-quickstart/src/main/java && cd claude-quickstart

   然后添加一个构建文件。在 Maven Central 上查找当前的 SDK 版本。

   Gradle

   将以下内容保存为 build.gradle.kts：

   plugins {
       application
   }
   
   repositories {
       mavenCentral()
   }
   
   java {
       toolchain {
           languageVersion = JavaLanguageVersion.of(25)
       }
   }
   
   dependencies {
       implementation("com.anthropic:anthropic-java:3.3.0")
   }
   
   application {
       mainClass = "QuickStart"
   }

   Maven

   将以下内容保存为 pom.xml：

   <project xmlns="http://maven.apache.org/POM/4.0.0">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.example</groupId>
     <artifactId>quickstart</artifactId>
     <version>1.0-SNAPSHOT</version>
     <properties>
       <maven.compiler.release>25</maven.compiler.release>
       <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
     <dependencies>
       <dependency>
         <groupId>com.anthropic</groupId>
         <artifactId>anthropic-java</artifactId>
         <version>3.3.0</version>
       </dependency>
     </dependencies>
   </project>

3. 编写代码

   将以下内容保存为项目 Java 源代码目录（通常为 src/main/java/）中的 QuickStart.java：

   Java

   import com.anthropic.client.okhttp.AnthropicOkHttpClient;
   import com.anthropic.models.messages.Message;
   import com.anthropic.models.messages.MessageCreateParams;
   import com.anthropic.models.messages.Model;
   
   static void main() {
       var client = AnthropicOkHttpClient.fromEnv();
   
       var params = MessageCreateParams.builder()
           .model(Model.CLAUDE_OPUS_5_5)
           .maxTokens(1000)
           .addUserMessage(
               "What should I search for to find the latest developments in renewable energy?"
           )
           .build();
   
       Message message = client.messages().create(params);
       for (var block : message.content()) {
           block.text().ifPresent(textBlock -> IO.println(textBlock.text()));
       }
   }

4. 运行代码

   Gradle

   gradle run

   Maven

   mvn compile exec:java -Dexec.mainClass=QuickStart

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

PHP

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   mkdir claude-quickstart && cd claude-quickstart
   composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7"

3. 编写代码

   创建一个名为 quickstart.php 的文件：

   PHP

   <?php
   require 'vendor/autoload.php';
   
   use Anthropic\Client;
   use Anthropic\Messages\Model;
   use Anthropic\Messages\TextBlock;
   
   $client = new Client();
   
   $message = $client->messages->create(
       model: Model::CLAUDE_OPUS_5_5,
       maxTokens: 1000,
       messages: [
           [
               'role' => 'user',
               'content' => 'What should I search for to find the latest developments in renewable energy?',
           ],
       ],
   );
   
   foreach ($message->content as $block) {
       if ($block instanceof TextBlock) {
           echo $block->text . PHP_EOL;
       }
   }

4. 运行代码

   php quickstart.php

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

Ruby

1. 设置您的 API 密钥

   将您的 API 密钥导出为环境变量。SDK 会自动读取 ANTHROPIC_API_KEY。

   export ANTHROPIC_API_KEY="your-api-key-here"

2. 创建项目并安装 SDK

   mkdir claude-quickstart && cd claude-quickstart
   bundle init
   bundle add anthropic

3. 编写代码

   创建一个名为 quickstart.rb 的文件：

   Ruby

   require "anthropic"
   
   client = Anthropic::Client.new
   
   message = client.messages.create(
     model: Anthropic::Model::CLAUDE_OPUS_5_5,
     max_tokens: 1000,
     messages: [
       {
         role: "user",
         content: "What should I search for to find the latest developments in renewable energy?"
       }
     ]
   )
   
   message.content.each do |block|
     puts block.text if block.type == :text
   end

4. 运行代码

   bundle exec ruby quickstart.rb

   Output

   Here are some effective search strategies to find the latest developments in renewable energy:
   
   ## General Search Terms
   - "Renewable energy news 2025"
   - ...

后续步骤

您已经完成了第一次 API 调用。接下来，学习您将在每个 Claude 集成中使用的 Messages API 模式。

• 使用 Messages API：学习多轮对话、系统提示、停止原因以及其他核心模式。

熟悉基础知识后，可进一步探索：

• 模型概览：按能力和成本比较 Claude 模型。

• 功能概览：浏览 Claude 的所有功能：工具、上下文管理、结构化输出等。

• 客户端 SDK：Python、TypeScript、C# 及其他客户端库的参考文档。

• 身份验证：比较 API 密钥与工作负载身份联合（Workload Identity Federation），并设置密钥过期时间。