Panduan Quickstart
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:
- Akun dengan akses API (lihat panduan kami di sini tentang mendapatkan akses ke Claude)
- Kunci API (tersedia melalui Pengaturan Akun Anda)
- Python 3.7.1 atau yang lebih baru terinstal di komputer Anda
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:
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:
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:
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:
- Buka terminal Anda dan ketik:
nano ~/.bash_profile
(ataunano ~/.zshrc
jika Anda menggunakan versi macOS yang lebih baru) - Tambahkan baris ini ke file, ganti
your-api-key-here
dengan kunci API Anda yang sebenarnya:export ANTHROPIC_API_KEY='your-api-key-here'
- Simpan file dan keluar dari editor (tekan
Ctrl+O
, laluEnter
, laluCtrl+X
) - Muat profil yang diperbarui dengan menjalankan:
source ~/.bash_profile
(atausource ~/.zshrc
)
- Buka terminal Anda dan ketik:
- Di Windows:
- Buka command prompt dan ketik:
setx ANTHROPIC_API_KEY "your-api-key-here"
, gantiyour-api-key-here
dengan kunci API Anda yang sebenarnya - 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
- Buka command prompt dan ketik:
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:
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!