Claude 开发文档汉化：Claude API 快速开始指南（2026）

更新时间：2026年3月
官方原文：Get started with Claude

如果你准备把 Claude 集成到自己的网站、应用或工具中，这篇文档可以帮你快速完成第一步。

本文基于 Anthropic 官方的 Get started with Claude 页面整理，目标是用中文带你完成一次完整的 Claude API 入门：

• 创建 Anthropic 开发者账号
• 获取 API Key
• 发起第一条 Claude API 请求
• 使用 cURL、Python、TypeScript、Java 四种方式接入
• 了解下一步应该继续阅读哪些官方文档

一、开始前需要准备什么？

在调用 Claude API 之前，你至少需要准备以下两项：

1. Anthropic Console 账号：访问 Claude Console 注册或登录。
2. API Key：在 API Keys 页面 创建密钥。

⚠️ 注意：API Key 只应该保存在服务端或本地环境变量中，不要直接暴露到前端页面或公开仓库。

二、第一次调用 Claude API

Claude 官方快速开始页使用的是 Messages API。如果你只是想先跑通一个最小示例，可以直接使用下面的 cURL 命令。

1）设置 API Key

macOS / Linux 终端中执行：

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

设置完成后，当前 shell 会话中的 SDK 或命令行示例就可以直接读取这个环境变量。

2）使用 cURL 发起第一条请求

下面这个示例会调用 Claude，并让它给出“如何搜索可再生能源最新进展”的建议。

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-4-6",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "如果我想跟进可再生能源的最新进展，应该搜索哪些关键词？"
      }
    ]
  }'

3）示例返回结果

返回结果通常会包含消息 ID、模型名称、停止原因以及 token 使用量。下面是一个简化后的示例：

{
  "id": "msg_01HCDu5LRGeP2o7s2xGmxyx8",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你可以尝试搜索 renewable energy news 2026、battery storage innovation、green hydrogen developments 等关键词。"
    }
  ],
  "model": "claude-opus-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 21,
    "output_tokens": 305
  }
}

三、Python SDK 快速开始

如果你使用 Python，官方推荐先安装 Anthropic SDK。

1）安装 SDK

pip install anthropic

2）创建 quickstart.py

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "如果我想跟进可再生能源的最新进展，应该搜索哪些关键词？",
        }
    ],
)

print(message.content)

3）运行代码

python quickstart.py

4）Python 版本说明

• anthropic.Anthropic() 会默认从环境变量中读取 ANTHROPIC_API_KEY
• 这个示例适合用来验证 API 是否已成功打通
• 真正接入业务时，建议补充异常处理、日志和重试机制

四、TypeScript SDK 快速开始

如果你的项目是 Node.js / TypeScript，可以使用官方的 TypeScript SDK。

1）安装 SDK

npm install @anthropic-ai/sdk

2）创建 quickstart.ts

import Anthropic from "@anthropic-ai/sdk";

async function main() {
  const anthropic = new Anthropic();

  const msg = await anthropic.messages.create({
    model: "claude-opus-4-6",
    max_tokens: 1000,
    messages: [
      {
        role: "user",
        content: "如果我想跟进可再生能源的最新进展，应该搜索哪些关键词？"
      }
    ]
  });

  console.log(msg);
}

main().catch(console.error);

3）运行代码

npx tsx quickstart.ts

4）TypeScript 版本说明

• new Anthropic() 默认也会读取 ANTHROPIC_API_KEY
• 如果你在 Next.js、Nuxt 或其他全栈框架中使用，请确保请求在服务端发起
• 输出对象中会包含 content、usage、stop_reason 等字段

五、Java SDK 快速开始

Claude 官方文档同样提供了 Java 接入示例。Java 项目通常先通过 Gradle 或 Maven 引入 SDK。

1）添加依赖

官方示例中使用的是 2.18.0，实际开发时请优先以 Maven Central 上的最新版本为准。

Gradle：

implementation("com.anthropic:anthropic-java:2.18.0")

Maven：

<dependency>
  <groupId>com.anthropic</groupId>
  <artifactId>anthropic-java</artifactId>
  <version>2.18.0</version>
</dependency>

2）创建 QuickStart.java

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;

public class QuickStart {

  public static void main(String[] args) {
    AnthropicClient client = AnthropicOkHttpClient.fromEnv();

    MessageCreateParams params = MessageCreateParams.builder()
      .model("claude-opus-4-6")
      .maxTokens(1000)
      .addUserMessage(
        "如果我想跟进可再生能源的最新进展，应该搜索哪些关键词？"
      )
      .build();

    Message message = client.messages().create(params);
    System.out.println(message.content());
  }
}

3）运行代码

javac QuickStart.java
java QuickStart

六、你需要理解的 5 个核心字段

只要你已经运行过上面的任意一个示例，就应该顺便理解这几个最基础的 API 参数和返回字段：

1）model

用于指定调用的 Claude 模型，例如：

• claude-opus-4-6

在真实项目中，你可以根据任务类型切换为不同的 Claude 模型。

2）max_tokens

用于控制模型最多输出多少 token。数值越大，生成内容可能越长，但成本也会随之增加。

3）messages

这是 Claude Messages API 的核心输入结构。你需要把对话内容按消息数组传入，例如：

[
  {
    "role": "user",
    "content": "请帮我解释一下向量数据库的工作原理。"
  }
]

后续做多轮对话时，你会继续追加更多的 user / assistant 消息。

4）anthropic-version

这是 HTTP 请求头中的版本号。官方示例使用：

anthropic-version: 2023-06-01

如果你直接使用官方 SDK，很多底层细节已经被封装；如果你手写 HTTP 请求，这个头一定要带上。

5）usage 和 stop_reason

• usage：记录本次请求的 token 消耗
• stop_reason：说明模型为什么停止输出，例如 end_turn

这两个字段在做成本统计、日志分析和异常排查时非常有用。

七、接入 Claude 时的实用建议

为了让你的第一个 Claude 项目更稳定，建议顺手遵循下面这些规则：

1. 永远不要把 API Key 写死在前端代码中
2. 优先在服务端调用 Claude API
3. 先用最小示例跑通，再接入业务逻辑
4. 保留原始响应中的 usage 字段，便于做成本监控
5. 先学会单轮调用，再继续学习多轮消息管理

如果你准备把 Claude 接到生产环境，后续还应该继续补充：

• 超时控制
• 重试机制
• 限流策略
• 错误处理
• 日志与监控

八、下一步应该读什么？

完成第一条 API 调用后，官方建议你继续阅读以下内容：

1. Working with the Messages API
   学习多轮对话、system prompt、停止原因等 Claude 开发中的核心模式。

2. Models overview
   对比不同 Claude 模型的能力、成本和适用场景。

3. Features overview
   了解 Claude 支持的工具调用、上下文管理、结构化输出等能力。

4. Client SDKs
   查看 Python、TypeScript、Java 等官方 SDK 的完整说明。

九、总结

如果你只是想快速入门 Claude 开发，最短路径就是：

1. 注册 Claude Console
2. 创建 API Key
3. 用 cURL 或 SDK 调用一次 Messages API
4. 确认响应结构、token 使用量和停止原因
5. 继续学习多轮对话与更完整的模型能力

这样，你就已经完成了 Claude 官方开发文档中最核心的“第一步”。

---

如果你后续还想继续补充 Claude 的 Messages API、系统提示词、结构化输出或多轮对话文档，可以在这篇基础上继续扩展成完整的中文版 Claude 开发手册。