Claude 快速入门
向 Claude 发起您的第一次 API 调用,并构建一个简单的网页搜索助手。
开始之前
创建 Claude Console 账户
注册 Claude Console 账户,或登录您已有的账户。
选择身份验证方式
对于本地开发,建议使用 CLI 登录。
Follow the steps for one of the following options.
CLI
安装 CLI
Homebrew (macOS)
brew install anthropics/tap/ant
curl (Linux/WSL)
对于 Linux 环境,请直接下载发布版二进制文件。
VERSION=2.9.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin ant
您可以在 GitHub 发布页面上找到所有发布版本。
go install
您也可以使用 go install 从源代码安装 CLI,这需要 Go 1.26.10 或更高版本。
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
go install 会将二进制文件放置在 $(go env GOPATH)/bin 中。如果该目录尚未添加到您的 PATH 中,请将其添加进去:
export PATH="$PATH:$(go env GOPATH)/bin"
登录
ant auth login
登录完成后,SDK 和 CLI 将自动获取您的凭据。
API 密钥
创建 API 密钥
在 Claude Console 中创建 API 密钥。
设置环境变量
SDK 和 CLI 从 ANTHROPIC_API_KEY 读取您的密钥:
export ANTHROPIC_API_KEY="your-api-key-here"
调用 API
cURL
发起您的第一次 API 调用
CLI
向 Messages API 发送 POST 请求,并将您通过 CLI 登录获得的访问令牌作为 bearer 令牌:
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
-H "anthropic-version: 2026-10-21" \
-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?"
}
]
}'
API 密钥
向 Messages API 发送 POST 请求:
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-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 响应:
{
"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
发起您的第一次 API 调用
API 密钥
如果您之前选择了 API 密钥,请先安装 CLI:
Homebrew (macOS)
brew install anthropics/tap/ant
curl (Linux/WSL)
对于 Linux 环境,请直接下载发布版二进制文件。
VERSION=2.9.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin ant
您可以在 GitHub 发布页面上找到所有发布版本。
go install
您也可以使用 go install 从源代码安装 CLI,这需要 Go 1.26.10 或更高版本。
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest
go install 会将二进制文件放置在 $(go env GOPATH)/bin 中。如果该目录尚未添加到您的 PATH 中,请将其添加进去:
export PATH="$PATH:$(go env GOPATH)/bin"
在终端中运行 ant messages create:
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 响应:
{
"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
创建项目并安装 SDK
mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic
编写代码
创建一个名为 quickstart.py 的文件:
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)
运行代码
python quickstart.py
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
TypeScript
创建项目并安装 SDK
mkdir claude-quickstart && cd claude-quickstart
npm init -y
npm pkg set type=module
npm install @anthropic-ai/sdk
编写代码
创建一个名为 quickstart.ts 的文件:
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);
}
}
运行代码
npx tsx quickstart.ts
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
C#
创建项目并安装 SDK
创建一个新的控制台项目并添加 Anthropic 包:
dotnet new console -n ClaudeQuickstart
cd ClaudeQuickstart
dotnet add package Anthropic
编写代码
替换 Program.cs 的内容:
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);
}
}
运行代码
dotnet run
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
Go
创建项目并安装 SDK
创建一个新模块并添加 Anthropic SDK:
mkdir claude-quickstart && cd claude-quickstart
go mod init claude-quickstart
go get github.com/anthropics/anthropic-sdk-go/v2
编写代码
创建一个名为 main.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)
}
}
}
运行代码
go run .
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
Java
设置您的项目
您的 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.8.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.8.0</version>
</dependency>
</dependencies>
</project>
编写代码
将以下内容保存为项目 Java 源代码目录(通常为 src/main/java/)中的 QuickStart.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()));
}
}
运行代码
Gradle
gradle run
Maven
mvn compile exec:java -Dexec.mainClass=QuickStart
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
PHP
创建项目并安装 SDK
mkdir claude-quickstart && cd claude-quickstart
composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7"
编写代码
创建一个名为 quickstart.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;
}
}
运行代码
php quickstart.php
Here are some effective search strategies to find the latest developments in renewable energy:
## General Search Terms
- "Renewable energy news 2025"
- ...
Ruby
创建项目并安装 SDK
mkdir claude-quickstart && cd claude-quickstart
bundle init
bundle add anthropic
编写代码
创建一个名为 quickstart.rb 的文件:
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
运行代码
bundle exec ruby quickstart.rb
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
学习多轮对话、系统提示、停止原因以及其他核心模式。
熟悉基础知识后,可进一步探索: