Claude API là gì? Hướng dẫn bắt đầu cho developer

Bạn đã dùng Claude.ai qua giao diện chat. Nhưng nếu muốn tích hợp Claude vào ứng dụng của mình, hay gọi Claude trực tiếp từ code Python — bạn cần Claude API.

Bài viết này hướng dẫn từng bước: từ lấy API key đến viết code Python và Node.js gọi API lần đầu tiên. Đọc xong bài này, bạn sẽ có code hoạt động ngay trong tay.

Nên đọc bài Claude là gì trước để nắm kiến thức nền.

Claude API là gì?

API và Claude API — Khái niệm cơ bản

API (Application Programming Interface) là "bộ quy tắc để các phần mềm giao tiếp với nhau". Claude API là giao diện chính thức để gọi Claude từ code Python, Node.js hay bất kỳ ngôn ngữ nào khác.

• Endpoint: https://api.anthropic.com/v1/messages
• Xác thực: API key (Bearer token)
• Định dạng: REST API (JSON)

Tại sao nên dùng Claude API?

Cách lấy API Key

Tạo tài khoản Anthropic Console

1. Truy cập console.anthropic.com
2. Nhấn "Sign Up" (email hoặc Google)
3. Xác nhận email
4. Đăng ký thông tin thanh toán (thẻ tín dụng)

Tạo và quản lý API Key

1. Trong dashboard, nhấn "API Keys"
2. Chọn "Create Key"
3. Đặt tên cho key (ví dụ: "vietcode-project")
4. Copy key — chỉ hiển thị một lần duy nhất!

Bảo mật API Key (.env)

# Tạo file .env
ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxxxxxxx

# Thêm vào .gitignore (bắt buộc!)
echo ".env" >> .gitignore

Cài đặt môi trường

Cài đặt Python SDK

# Tạo môi trường ảo
python -m venv venv
source venv/bin/activate   # Linux/Mac

# Cài SDK
pip install anthropic python-dotenv

Cài đặt Node.js SDK

npm init -y
npm install @anthropic-ai/sdk dotenv

Gọi Claude API lần đầu

Ví dụ Python cơ bản

import anthropic
import os
from dotenv import load_dotenv

load_dotenv()

client = anthropic.Anthropic(
    api_key=os.getenv("ANTHROPIC_API_KEY")
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Claude là gì? Giải thích trong 3 câu ngắn gọn bằng tiếng Việt."
        }
    ]
)

print(message.content[0].text)

Ví dụ Node.js cơ bản

import Anthropic from '@anthropic-ai/sdk';
import 'dotenv/config';

const client = new Anthropic({
    apiKey: process.env.ANTHROPIC_API_KEY
});

const message = await client.messages.create({
    model: 'claude-sonnet-4-6',
    max_tokens: 1024,
    messages: [
        {
            role: 'user',
            content: 'Claude là gì? Giải thích trong 3 câu ngắn gọn bằng tiếng Việt.'
        }
    ]
});

console.log(message.content[0].text);

Hiểu cấu trúc request/response

Cấu trúc request: model, max_tokens, messages (mảng role + content).

Cấu trúc response: message.content[0].text (văn bản trả lời), message.usage (số token dùng).

Các tham số quan trọng

model — Chọn phiên bản Claude

Chi tiết các model xem tại các phiên bản Claude:

• "claude-haiku-4-20250514" — Nhanh nhất, rẻ nhất
• "claude-sonnet-4-6-20251220" — Khuyến nghị mặc định
• "claude-opus-4-6-20251220" — Hiệu suất cao nhất

max_tokens — Giới hạn output

• Q&A ngắn: 256–512
• Viết văn bản: 1.024–2.048
• Tạo code dài: 4.096–8.192

system prompt — Hướng dẫn AI

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system="Bạn là trợ lý lập trình thân thiện. Luôn trả lời bằng tiếng Việt và đưa ra ví dụ code đơn giản.",
    messages=[{"role": "user", "content": "Vòng lặp for trong Python là gì?"}]
)

temperature — Điều chỉnh sáng tạo

• 0–0,3: Xác định, trung thực (lập trình, dịch thuật)
• 0,7–1: Sáng tạo (viết sáng tạo, brainstorm)

Giá cả Claude API 2026

Tính toán chi phí theo token

Mẹo tối ưu chi phí

1. Prompt Caching: Tiết kiệm đến 90% với system prompt lặp lại
2. Phân tầng model: Haiku → chất lượng chưa đủ → Sonnet
3. Tối ưu max_tokens: Đo lượng token thực tế cần

Xây dựng ứng dụng đơn giản với Claude API

Chatbot đơn giản (có lưu lịch sử hội thoại)

import anthropic
import os
from dotenv import load_dotenv

load_dotenv()
client = anthropic.Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

def run_chatbot():
    conversation_history = []
    print("Chatbot Claude - Gõ 'quit' để thoát\n")

    while True:
        user_input = input("Bạn: ").strip()

        if user_input.lower() == 'quit':
            print("Tạm biệt!")
            break

        if not user_input:
            continue

        conversation_history.append({
            "role": "user",
            "content": user_input
        })

        response = client.messages.create(
            model="claude-sonnet-4-6",
            max_tokens=1024,
            system="Bạn là trợ lý học lập trình thân thiện. Luôn trả lời bằng tiếng Việt.",
            messages=conversation_history
        )

        assistant_reply = response.content[0].text
        conversation_history.append({
            "role": "assistant",
            "content": assistant_reply
        })

        print(f"Claude: {assistant_reply}\n")

if __name__ == "__main__":
    run_chatbot()

Bước tiếp theo

Sau khi nắm Claude API, bước tiếp theo là xây dựng AI agent. Chi tiết tại Claude Managed Agents là gì và xây dựng AI agent với Claude.

FAQ

API key dùng để làm gì?

Để xác thực tài khoản của bạn với server Anthropic. Mỗi key ghi lại lượng sử dụng và dùng để tính phí.

Có dùng API miễn phí được không?

Anthropic API không có gói miễn phí — khác với gói miễn phí trên claude.ai.

Có dùng được ngôn ngữ khác ngoài Python không?

Có. SDK chính thức có Python và Node.js. Ngôn ngữ nào gửi được HTTP request đều dùng được.

Kết luận

1. Lấy API key: Vài phút tại console.anthropic.com
2. Cài SDK: Chỉ một dòng pip install anthropic
3. Gọi lần đầu: Dùng client.messages.create()

Tổng quan về Claude xem tại Claude là gì. Cách chọn model xem tại các phiên bản Claude.