Cara mula guna Claude Code dengan kunci API MaCloud AI

Apa yang perlu disediakan?

• Claude Code sudah dipasang di komputer anda. Ikut panduan pemasangan rasmi daripada Anthropic.
• Akaun MaCloud AI dengan baki. Daftar dengan e-mel, kemudian tambah nilai dari RM 12 di Tambah nilai.
• Kunci API dari menu API Key. Lebih baik cipta kunci khas bernama claude-code, supaya penggunaannya mudah dikenal pasti.
• Nama model Claude yang disalin dari halaman model.

Langkah-langkah tetapan

1. Cipta kunci API baharu di konsol: menu API Key → Cipta key → salin kunci sk-....
2. Tetapkan ANTHROPIC_BASE_URL kepada https://api.macloudai.com (tanpa /v1).
3. Tetapkan ANTHROPIC_AUTH_TOKEN kepada kunci yang anda salin.
4. Tetapkan ANTHROPIC_MODEL kepada nama model dari halaman model.
5. Buka terminal di folder projek dan jalankan claude.
6. Hantar mesej pendek, kemudian semak panggilan itu di Penggunaan.

Kesilapan paling biasa: menulis https://api.macloudai.com/v1 untuk Claude Code. Claude Code guna format Anthropic, jadi base URL mesti https://api.macloudai.com sahaja. /v1 hanya untuk alat yang guna format OpenAI seperti Cursor.

Tetapan di macOS, Linux dan Windows

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude

$env:ANTHROPIC_BASE_URL="https://api.macloudai.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-..."
$env:ANTHROPIC_MODEL="hk-5-5"
claude

Di macOS dan Linux, tetapan export hanya kekal untuk tetingkap terminal itu. Supaya kekal, tambah tiga baris export ke dalam ~/.zshrc (macOS) atau ~/.bashrc (Linux), kemudian buka terminal baharu.

Tetapan kekal di Windows

Tetapan $env: di atas hanya untuk sesi PowerShell yang sedang dibuka. Untuk simpan secara kekal, guna setx, kemudian tutup dan buka semula PowerShell:

setx ANTHROPIC_BASE_URL "https://api.macloudai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
setx ANTHROPIC_MODEL "hk-5-5"

Atau simpan dalam settings.json

Claude Code juga membaca tetapan dari fail ~/.claude/settings.json. Letakkan pemboleh ubah tadi di bawah "env". Cara ini sesuai kalau anda tidak mahu mengusik fail shell, dan ia berfungsi sama di macOS, Linux dan Windows:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.macloudai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "hk-5-5"
  }
}

Kalau fail itu sudah ada tetapan lain, tambah bahagian "env" sahaja dan pastikan JSON masih sah (koma di tempat yang betul). Di Windows, fail ini berada dalam folder .claude di bawah folder pengguna anda.

Bagaimana nak semak ia sudah berjalan?

• Jalankan claude dan tulis "hai". Kalau dijawab, sambungan berfungsi.
• Buka Penggunaan: panggilan tadi muncul dengan nama model, token input, token output dan kos.
• Ralat 401: kunci salah atau sudah dipadam. Ralat 403: baki habis atau kunci tidak boleh guna model itu. Ralat 404: nama model salah, salin semula dari halaman model.
• Kalau Claude Code masih minta log masuk akaun Anthropic, pemboleh ubah belum dibaca. Buka terminal baharu, atau semak ejaan ANTHROPIC_AUTH_TOKEN.

Guna Claude Code dalam pasukan kecil

Kalau anda bekerja bersama dua atau tiga pembangun, contohnya studio kecil di Petaling Jaya, cipta satu kunci API untuk setiap orang dengan nama masing-masing, seperti cc-aisyah dan cc-wei-jie. Semua kunci menolak baki akaun yang sama, tetapi di menu Penggunaan anda boleh lihat siapa yang guna berapa banyak.

• Jangan kongsi satu kunci dalam kumpulan WhatsApp atau fail bersama. Kalau seseorang keluar dari pasukan, padam kuncinya sahaja.
• Jangan masukkan settings.json yang mengandungi kunci ke dalam repo projek. Simpan di folder pengguna masing-masing.
• Tetapkan model yang sama untuk semua ahli supaya hasil dan kos lebih mudah dibandingkan.

Tukar model tanpa ubah apa-apa lagi

Untuk mencuba model Claude lain, tukar nilai ANTHROPIC_MODEL sahaja dan buka semula Claude Code. Base URL dan kunci kekal sama. Ramai pengguna guna model yang lebih kuat untuk kerja reka bentuk dan pembaikan pepijat yang sukar, dan model yang lebih ringan untuk tugas rutin seperti menulis ujian atau mengemas kod.

Tip jimat token dalam Claude Code

Claude Code menghantar banyak konteks pada setiap langkah: isi fail, output arahan dan sejarah perbualan. Semuanya dikira sebagai token input, jadi sesi yang panjang menjadi semakin mahal bagi setiap langkah.

• Guna /clear bila beralih ke tugas baharu, supaya sejarah lama tidak dihantar semula.
• Guna /compact bila sesi sudah panjang tetapi anda mahu teruskan; ia meringkaskan sejarah menjadi lebih pendek.
• Beri arahan yang jelas dan sebut fail yang berkaitan, contohnya "betulkan fungsi kira_cukai dalam fail invois.py", daripada "periksa seluruh projek".
• Simpan maklumat tetap projek (cara jalankan ujian, gaya kod) dalam fail CLAUDE.md supaya anda tidak perlu menerangkan semula setiap kali.
• Untuk tugas ringan, cuba model yang lebih murah dengan menukar ANTHROPIC_MODEL. Bandingkan harga di bawah:

Harga sebenar sekarang

Anggaran daripada harga di halaman model: 2,000 token input dan 500 token output bagi setiap chat. Caj sebenar dipaparkan dalam konsol.

Semak Penggunaan selepas sehari dua kerja untuk tahu purata kos anda. Penerangan lanjut ada dalam cara kos API dikira ikut token dan di dokumentasi.

Soalan lazim

Panduan lain

• API Claude dan ChatGPT dengan satu kunci, bayar ikut penggunaan
• Bina bot WhatsApp yang dijawab AI: panduan langkah demi langkah
• Pilih Claude, GPT, Gemini atau DeepSeek: model mana untuk anda?
• Bagaimana kos API AI dikira ikut token (dengan contoh)
• Bayar ikut penggunaan vs langganan AI bulanan: mana lebih jimat?