Cara Menggunakan Kunci API Claude: Panduan Lengkap 2025

\n\n## Pengenalan

Claude ialah pembantu AI berkuasa yang dibangunkan oleh Anthropic, mampu melaksanakan pelbagai tugas, daripada menjana kandungan kreatif hingga memberikan penjelasan terperinci. Untuk mengakses keupayaan Claude secara pemrograman, anda memerlukan kunci API. Panduan ini akan membimbing anda melalui proses mendapatkan dan menggunakan kunci API Claude anda, memberikan langkah-langkah yang jelas dan boleh diambil tindakan.

Panduan ini mengandaikan anda mempunyai pemahaman asas tentang konsep pengaturcaraan dan biasa menggunakan API. Tiada pengalaman terdahulu dengan Claude diperlukan. Menjelang akhir tutorial ini, anda akan dapat mengesahkan dengan API Claude dan membuat panggilan API pertama anda.

Prasyarat

Sebelum anda memulakan, pastikan anda mempunyai perkara berikut:

• Akaun Anthropic: Anda memerlukan akaun dengan Anthropic untuk mengakses API mereka. Pergi ke laman web Anthropic dan daftar untuk akaun.
• Kunci API: Anda perlu mendapatkan kunci API daripada Anthropic. Kunci ini penting untuk mengesahkan permintaan anda ke API Claude.
• Persekitaran Pengaturcaraan: Pilih bahasa pengaturcaraan (contohnya, Python, Node.js) dan sediakan persekitaran pembangunan anda. Panduan ini terutamanya akan menggunakan Python untuk contoh.
• Pengurus Pakej: Pastikan anda mempunyai pengurus pakej yang dipasang (contohnya, pip untuk Python, npm untuk Node.js).
• Pengetahuan Asas Pengaturcaraan: Pemahaman asas tentang konsep pengaturcaraan, seperti pemboleh ubah, fungsi dan membuat permintaan HTTP, adalah penting.

Langkah 1: Daftar untuk Akaun Anthropic

Jika anda belum mempunyai akaun Anthropic, anda perlu membuatnya.

1. Lawati Laman Web Anthropic: Pergi ke laman web rasmi Anthropic (anthropic.com).
2. Daftar: Cari butang "Daftar" atau "Mulakan". Perkataan yang tepat mungkin berbeza-beza.
3. Berikan Maklumat: Isi maklumat yang diperlukan, seperti nama, alamat e-mel dan kata laluan anda.
4. Sahkan E-mel Anda: Semak peti masuk e-mel anda untuk e-mel pengesahan daripada Anthropic. Klik pautan pengesahan untuk mengesahkan akaun anda.
5. Lengkapkan Profil (Jika Diperlukan): Sesetengah platform mungkin memerlukan anda untuk melengkapkan maklumat profil anda selepas mengesahkan e-mel anda.

Langkah 2: Dapatkan Kunci API Claude Anda

Sebaik sahaja anda mempunyai akaun Anthropic, anda boleh mendapatkan kunci API anda.

1. Log Masuk: Log masuk ke akaun Anthropic anda di laman web mereka.
2. Navigasi ke Tetapan API: Cari bahagian yang berkaitan dengan "Kunci API," "Pembangun," atau "Tetapan Akaun." Lokasi mungkin berbeza-beza bergantung pada reka letak laman web Anthropic.
3. Jana Kunci API: Klik pada pilihan untuk menjana kunci API baharu. Anda mungkin perlu memberikan nama atau penerangan untuk kunci tersebut.
4. Salin dan Simpan dengan Selamat: Sebaik sahaja kunci dijana, salinnya ke tempat yang selamat. Ini adalah penting kerana anda tidak akan dapat melihat kunci itu lagi selepas anda menutup halaman. Simpannya dengan selamat, seperti dalam pengurus kata laluan, dan elakkan daripada melakukan (commit) ke sistem kawalan versi seperti Git.

Langkah 3: Sediakan Persekitaran Pengaturcaraan Anda

Sekarang, sediakan persekitaran pengaturcaraan anda untuk menggunakan API Claude. Kita akan menggunakan Python dalam contoh ini.

1. Pasang Python: Jika anda belum memasang Python, muat turun dan pasang versi terkini daripada laman web rasmi Python (python.org).

2. Pasang Pustaka Python Anthropic: Buka terminal atau command prompt anda dan gunakan pip untuk memasang pustaka Python Anthropic:

   pip install anthropic
   

   Perintah ini memuat turun dan memasang pustaka Python yang diperlukan untuk berinteraksi dengan API Claude.

3. Sahkan Pemasangan: Untuk mengesahkan bahawa pustaka dipasang dengan betul, jalankan perintah berikut dalam terminal anda:

   pip show anthropic
   

   Ini akan memaparkan maklumat tentang pustaka Anthropic yang dipasang, termasuk versi dan lokasinya.

Langkah 4: Sahkan dengan API Claude

Sebelum anda boleh menggunakan API Claude, anda perlu mengesahkan permintaan anda menggunakan kunci API anda.

1. Import Pustaka Anthropic: Dalam skrip Python anda, import pustaka Anthropic:

   import anthropic
   

2. Tetapkan Kunci API: Tetapkan pemboleh ubah persekitaran ANTHROPIC_API_KEY atau teruskan kunci API secara langsung apabila membuat klien.

   Pilihan 1: Menggunakan Pemboleh Ubah Persekitaran (Disyorkan):

   Tetapkan pemboleh ubah persekitaran ANTHROPIC_API_KEY dalam sistem pengendalian anda. Ini menghalang anda daripada mengekodkan kunci dalam skrip anda secara tegar.

   • Linux/macOS:

     export ANTHROPIC_API_KEY="KUNCI_API_ANDA"
     

   • Windows:

     set ANTHROPIC_API_KEY=KUNCI_API_ANDA
     

   Gantikan KUNCI_API_ANDA dengan kunci API sebenar yang anda peroleh daripada Anthropic.

   Pilihan 2: Terus Menghantar Kunci API (Kurang Selamat):

   Anda boleh terus menghantar kunci API apabila membuat klien Anthropic, tetapi ini kurang selamat dan tidak disyorkan untuk persekitaran pengeluaran.

   client = anthropic.Anthropic(api_key="KUNCI_API_ANDA")
   

   Gantikan KUNCI_API_ANDA dengan kunci API sebenar anda.

3. Buat Klien Anthropic: Buat contoh kelas Anthropic untuk berinteraksi dengan API:

   client = anthropic.Anthropic() # Mengandaikan ANTHROPIC_API_KEY telah ditetapkan
   

   Jika anda menggunakan kaedah pemboleh ubah persekitaran, klien akan secara automatik mengambil kunci API daripada persekitaran.

Langkah 5: Buat Panggilan API Pertama Anda

Setelah anda disahkan, anda boleh membuat panggilan API pertama anda ke API Claude. Kita akan menggunakan titik akhir messages.create untuk menghantar mesej kepada Claude dan menerima respons.

1. Sediakan Prompt Anda: Buat prompt untuk dihantar kepada Claude. Prompt harus jelas dan ringkas, memberitahu Claude perkara yang anda mahu ia lakukan.

   prompt = "Tulis puisi pendek tentang lautan."
   

2. Panggil Titik Akhir messages.create: Gunakan kaedah messages.create untuk menghantar prompt anda kepada Claude dan menerima respons.

   message = client.messages.create(
       model="claude-3-opus-20240229", # Gantikan dengan model yang anda inginkan
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model: Menentukan model Claude yang ingin anda gunakan. Semak dokumentasi Anthropic untuk model terkini yang tersedia.
   • max_tokens: Menentukan bilangan token maksimum dalam respons yang dijana.
   • messages: Senarai mesej yang mewakili sejarah perbualan. Setiap mesej mempunyai role (sama ada "user" atau "assistant") dan content.

3. Cetak Respons: Cetak kandungan respons untuk melihat apa yang dijana oleh Claude.

   print(message.content[0].text)
   

   Ini akan mencetak puisi yang dijana oleh Claude.

Langkah 6: Contoh Kod Lengkap

Berikut ialah kod Python lengkap untuk membuat panggilan API ke API Claude: