Hanya ingin mengobrol dengan Claude? Kunjungi claude.ai!

Ingin langsung memahami API kami? Lompat ke dokumentasi referensi API kami untuk detail lebih lanjut.

Mari kita buat Anda dapat dengan cepat menggunakan Claude! Dalam panduan ini, kami akan memandu Anda melalui proses penyiapan lingkungan, menginstal library yang diperlukan, dan mengirim permintaan API pertama Anda ke Claude. Mari kita mulai!

Perhatikan bahwa meskipun panduan ini menggunakan SDK Python kami, kami juga mempertahankan SDK TypeScript dan mendukung integrasi HTTP langsung. Lihat dokumentasi SDK klien dan referensi API kami untuk detailnya.


Prasyarat

Sebelum memulai, pastikan Anda memiliki hal-hal berikut:

Langkah 1: Siapkan lingkungan Anda

Buat salinan notebook Google Colab quickstart kami untuk memulai segera tanpa menyiapkan lingkungan!

Pertama, pastikan Anda telah menginstal Python. Buka terminal (di macOS) atau command prompt (di Windows) dan ketik:

Shell
python --version

Jika Anda melihat nomor versi seperti “Python 3.12.2”, Anda sudah siap. Jika tidak, kunjungi situs web resmi Python dan unduh versi terbaru.

(Opsional) Buat lingkungan virtual

Meskipun tidak wajib, membuat lingkungan virtual untuk proyek Claude Anda direkomendasikan. Ini membantu menjaga dependensi Anda terorganisir dan mencegah konflik dengan proyek lain. Untuk membuat lingkungan virtual, jalankan:

Shell
python -m venv claude-env

Kemudian, aktifkan:

  • Di macOS atau Linux: source claude-env/bin/activate
  • Di Windows: claude-env\Scripts\activate

Langkah 2: Instal Anthropic Python SDK

Dengan lingkungan yang sudah siap, saatnya menginstal library Python Claude. Cukup jalankan:

Shell
pip install anthropic

Perintah ini akan menginstal versi terbaru dari library, bersama dengan dependensi yang diperlukan.

Langkah 3: (Opsional) Siapkan kunci API Anda

Untuk menggunakan Claude, Anda perlu memberikan kunci API Anda. Anda dapat membuat kunci API Anda tersedia untuk semua proyek Claude Anda dengan mengatur variabel lingkungan. Berikut caranya:

  • Di macOS atau Linux:
    1. Buka terminal Anda dan ketik: nano ~/.bash_profile (atau nano ~/.zshrc jika Anda menggunakan versi macOS yang lebih baru)
    2. Tambahkan baris ini ke file, ganti your-api-key-here dengan kunci API Anda yang sebenarnya: export ANTHROPIC_API_KEY='your-api-key-here'
    3. Simpan file dan keluar dari editor (tekan Ctrl+O, lalu Enter, lalu Ctrl+X)
    4. Muat profil yang diperbarui dengan menjalankan: source ~/.bash_profile (atau source ~/.zshrc)
  • Di Windows:
    1. Buka command prompt dan ketik: setx ANTHROPIC_API_KEY "your-api-key-here", ganti your-api-key-here dengan kunci API Anda yang sebenarnya
    2. Untuk membuat perubahan ini permanen, ikuti langkah-langkah berikut:
      • Klik kanan pada ‘This PC’ atau ‘My Computer’ dan pilih ‘Properties’
      • Klik ‘Advanced system settings’
      • Klik tombol ‘Environment Variables’
      • Di bagian ‘System variables’, klik ‘New…’ dan masukkan ANTHROPIC_API_KEY sebagai nama variabel dan kunci API Anda sebagai nilai variabel

Langkah 4: Kirim permintaan API pertama Anda

Anda hampir sampai! Mari kita kirim permintaan API pertama Anda ke Claude. Buat file Python baru (misalnya, claude_test.py) dan tambahkan kode berikut:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="Respond only in Yoda-speak.",
    messages=[
        {"role": "user", "content": "How are you today?"}
    ]
)

print(message.content)

Mari kita uraikan apa yang terjadi di sini:

  • Kami mengimpor library anthropic, yang menyediakan cara yang nyaman untuk berinteraksi dengan API Claude.
  • Kami membuat instance klien Anthropic, memasukkan kunci API kami (jika Anda mengatur variabel lingkungan, Anda dapat menghilangkan ini).
  • Kami memanggil metode messages.create() untuk mengirim pesan ke Claude. Kami menentukan model yang ingin kami gunakan (claude-3-opus-20240229), jumlah maksimum token dalam respons (max_tokens=1000), suhu (yang mengontrol keacakan output, temperature=0.0 berarti keacakan minimal), dan pesan sistem (yang mengatur konteks untuk percakapan).
  • Terakhir, kami mencetak respons dari Claude.

Untuk menjalankan kode, cukup ketik python claude_test.py di terminal atau command prompt Anda. Anda akan melihat respons seperti pepatah dari Claude!

Kunjungi Contoh Messages API untuk lebih banyak contoh struktur panggilan API. Untuk informasi lebih lanjut tentang parameter API, lihat referensi Messages API.


Langkah selanjutnya

Selamat, Anda telah berhasil mengirim permintaan API pertama Anda ke Claude! Berikut adalah beberapa langkah selanjutnya untuk melanjutkan perjalanan Anda.

Sumber daya API

Masuk ke dokumentasi API kami untuk detail lebih lanjut tentang endpoint dan parameter yang tersedia.

Lihat SDK klien kami untuk seperangkat alat yang memudahkan Anda membangun dan mengintegrasikan Claude ke dalam aplikasi Anda.

Anthropic Cookbook

Anthropic Cookbook menyimpan sekumpulan resep dalam bentuk notebook Jupyter. Notebook ini menampilkan kode yang dapat disalin yang menunjukkan cara menggunakan Claude dengan cara yang rapi dan efektif dalam skenario yang lebih canggih, seperti mengunggah PDF, penggunaan alat dan pemanggilan fungsi, embedding, dan banyak lagi.

Sumber daya lainnya

  • Kunjungi panduan migrasi kami untuk mempelajari cara memindahkan kasus penggunaan Anda ke Claude.
  • Jelajahi daftar istilah untuk membiasakan diri dengan terminologi yang digunakan dalam AI, LLM, dan ekosistem Claude.
  • Bergabunglah dengan server Discord pengembang kami untuk terhubung dengan pengembang lain, mengajukan pertanyaan, dan berbagi proyek Anda.
  • Kunjungi perpustakaan prompt untuk inspirasi dan prompt siap pakai untuk berbagai tugas, atau celupkan kaki Anda ke dalam rekayasa prompt dengan memeriksa pengantar prompting.

Kami menantikan untuk melihat apa yang Anda buat dengan Claude. Selamat mengoding!