huong dan claude bat dau tieng viet

Mục lục

• Điều kiện cần chuẩn bị
• Gọi API Claude lần đầu tiên
  • Sử dụng cURL
  • Sử dụng Python
  • Sử dụng TypeScript
  • Sử dụng Java
• Bước tiếp theo

Điều kiện cần chuẩn bị

Trước khi bắt đầu, bạn cần có:

• Một tài khoản trên Anthropic Console
• Một API key (lấy từ mục Settings > Keys trong Console)

Gọi API Claude lần đầu tiên

Dưới đây là hướng dẫn từng bước để gọi API Claude bằng nhiều ngôn ngữ lập trình khác nhau. Ví dụ này sẽ tạo một trợ lý tìm kiếm web đơn giản.

Cách 1: Sử dụng cURL

Bước 1: Thiết lập API key

Lấy API key từ Claude Console và lưu vào biến môi trường:

export ANTHROPIC_API_KEY='api-key-cua-ban'

Bước 2: Thực hiện lời gọi API đầu tiên

Chạy lệnh sau để gửi request tới 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": "Tôi nên tìm kiếm gì để cập nhật những phát triển mới nhất trong năng lượng tái tạo?"
      }
    ]
  }'

Kết quả trả về sẽ có dạng JSON chứa câu trả lời từ Claude, bao gồm các thông tin: id (mã tin nhắn), content (nội dung trả lời), model (model đã sử dụng), usage (số token đã dùng).

Cách 2: Sử dụng Python

Bước 1: Thiết lập API key

export ANTHROPIC_API_KEY='api-key-cua-ban'

Bước 2: Cài đặt SDK

pip install anthropic

Bước 3: Tạo file code

Lưu đoạn code dưới đây vào file quickstart.py:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "Tôi nên tìm kiếm gì để cập nhật những phát triển mới nhất trong năng lượng tái tạo?",
        }
    ],
)
print(message.content)

Bước 4: Chạy code

python quickstart.py

SDK sẽ tự động đọc biến môi trường ANTHROPIC_API_KEY để xác thực. Kết quả trả về là một danh sách các TextBlock chứa câu trả lời của Claude.

Cách 3: Sử dụng TypeScript

Bước 1: Thiết lập API key

export ANTHROPIC_API_KEY='api-key-cua-ban'

Bước 2: Cài đặt SDK

npm install @anthropic-ai/sdk

Bước 3: Tạo file code

Lưu đoạn code dưới đây vào file 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: "Tôi nên tìm kiếm gì để cập nhật những phát triển mới nhất trong năng lượng tái tạo?"
      }
    ]
  });
  console.log(msg);
}

main().catch(console.error);

Bước 4: Chạy code

npx tsx quickstart.ts

Cách 4: Sử dụng Java

Bước 1: Thiết lập API key

export ANTHROPIC_API_KEY='api-key-cua-ban'

Bước 2: Thêm SDK vào project

Tìm phiên bản mới nhất trên Maven Central.

Với Gradle:

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

Với Maven:

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

Bước 3: Tạo file code

Lưu vào file 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(
        "Tôi nên tìm kiếm gì để cập nhật những phát triển mới nhất trong năng lượng tái tạo?"
      )
      .build();

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

Bước 4: Biên dịch và chạy

javac QuickStart.java
java QuickStart

Bước tiếp theo

Chúc mừng bạn đã thực hiện thành công lời gọi API đầu tiên tới Claude! Tiếp theo, hãy tìm hiểu thêm về các pattern quan trọng của Messages API:

• Làm việc với Messages API — Tìm hiểu về hội thoại nhiều lượt (multi-turn), system prompt, stop reason, và các pattern cốt lõi khác.
• Tổng quan các model Claude — So sánh các model Claude theo khả năng và chi phí.
• Tổng quan tính năng — Khám phá tất cả khả năng của Claude: tools, context management, structured outputs, và nhiều hơn nữa.
• Client SDKs — Tài liệu tham khảo cho Python, TypeScript, Java và các thư viện client khác.