Alibaba Cloud Model Studio:Claude Code

Claude Code adalah asisten coding AI berbasis command-line yang dikembangkan oleh Anthropic. Hubungkan ke Alibaba Cloud Model Studio menggunakan Pay-as-you-go, Coding Plan, Token Plan Personal Edition, atau Token Plan Team Edition.

Instal Claude Code

Instal

npm install -g @anthropic-ai/claude-code

claude --version

npm install -g @anthropic-ai/claude-code

Lewati verifikasi login

Edit atau buat file ~/.claude.json (jalur Windows: C:\Users\<username>\.claude.json), lalu atur hasCompletedOnboarding menjadi true untuk melewati verifikasi login resmi Anthropic.

{
  "hasCompletedOnboarding": true
}

Konfigurasikan kredensial akses

Buat file ~/.claude/settings.json (jalur Windows: C:\Users\<username>\.claude\settings.json) dan tambahkan konfigurasi untuk rencana penagihan Anda.

Token Plan Personal Edition

Ganti YOUR_API_KEY dengan API Key khusus Token Plan Personal Edition. Untuk daftar model yang tersedia, lihat model yang didukung untuk Token Plan Personal Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Token Plan Team Edition

Ganti YOUR_API_KEY dengan API Key khusus Token Plan Team Edition. Untuk daftar model yang tersedia, lihat model yang didukung untuk Token Plan Team Edition.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.8-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
    }
}

Coding Plan

Ganti YOUR_API_KEY dengan API Key khusus Coding Plan. Untuk daftar model yang tersedia, lihat model yang didukung untuk Coding Plan.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
    }
}

Pay-as-you-go

Ganti YOUR_API_KEY dengan Alibaba Cloud Model Studio API Key. Untuk daftar model yang tersedia, lihat API kompatibel Anthropic.

Atur ANTHROPIC_BASE_URL berdasarkan wilayah. Kunci API harus sesuai dengan wilayah yang dipilih:

• China North 2 (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
• Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Ganti WorkspaceId dengan ID Ruang Kerja Anda yang sebenarnya.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
    }
}

Setelah menyimpan konfigurasi, buka terminal baru dan jalankan claude "hello". Respons dari model menandakan bahwa pengaturan berhasil. Untuk verifikasi lebih lanjut, jalankan /status di Claude Code dan pastikan ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN mengarah ke alamat Model Studio.

Konfigurasikan Ukuran Jendela Konteks

Claude Code menggunakan jendela konteks 200K secara default. Untuk menangani basis kode besar atau percakapan panjang, Anda dapat memperluas jendela konteks hingga 1M (1.000.000 token), asalkan model mendukung panjang konteks tersebut. Tersedia dua metode konfigurasi:

Tambahkan CLAUDE_CODE_MAX_CONTEXT_TOKENS ke bidang env dalam ~/.claude/settings.json:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}

Tambahkan [1m] ke nama model. Ini berfungsi dengan model Model Studio yang mendukung jendela konteks 1M:

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}

Setelah mengubah konfigurasi, buka jendela terminal baru untuk merestart Claude Code agar perubahan diterapkan. Untuk detail lebih lanjut tentang variabel lingkungan, lihat dokumentasi resmi variabel lingkungan Claude Code.

Mode izin

Claude Code menyediakan enam mode izin yang mengontrol apakah prompt konfirmasi muncul sebelum tool menjalankan operasi. Tabel berikut menjelaskan perilaku setiap mode.

Flag command-line

Gunakan --permission-mode untuk mengatur mode izin default selama sesi:

claude --permission-mode plan
claude --permission-mode acceptEdits

Perintah interaktif

Masukkan /permissions dalam sesi untuk mengelola aturan pra-setujui dan pra-tolak untuk tool secara dinamis. Anda dapat mengonfigurasi aturan persetujuan otomatis untuk tool bash, edit, dan MCP.

Konfigurasi settings.json

Konfigurasikan bidang permissions dalam ~/.claude/settings.json (jalur Windows: C:\Users\<username>\.claude\settings.json), yaitu file konfigurasi yang sama yang menyimpan kredensial akses Anda:

{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

Bidang allow menyetujui panggilan tool yang sesuai secara otomatis, sedangkan bidang deny menolak panggilan tool yang sesuai secara otomatis. Kedua bidang ini mendukung wildcard. Misalnya, Bash(npm:*) cocok dengan semua perintah yang dimulai dengan npm. Bidang defaultMode mengatur mode izin default untuk sesi, dan menerima salah satu mode yang tercantum dalam tabel sebelumnya.

Gunakan CC Switch

CC Switch adalah GUI desktop open-source komunitas untuk mengelola beberapa kunci API atau rencana penagihan. Beralih antar penyedia hanya dengan satu klik, tanpa perlu mengedit settings.json secara manual.

Instal CC Switch

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switch, atau unduh file .dmg dari Releases.
• Windows: unduh installer .msi atau file portabel .zip dari Releases.
• Linux: pada Arch, jalankan paru -S cc-switch-bin; pada distribusi lain, unduh .deb / .rpm / .AppImage dari Releases.

Tambahkan penyedia

1. Pada antarmuka utama CC Switch, pilih Claude Code di bilah ikon atas (ikon bintang oranye), lalu klik + di pojok kanan atas untuk membuka Add New Provider. Isi bidang berdasarkan tabel di bawah ini, lalu klik Add.

   Rencana penagihan	Konfigurasi
   Token Plan Personal Edition	Nama penyedia: Bailian-Token Plan Personal Edition API Key: ambil dari konsol Titik akhir: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Token Plan Team Edition	Nama penyedia: Bailian-Token Plan Team Edition API Key: ambil dari konsol Titik akhir: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	Nama penyedia: Bailian-Coding Plan API Key: ambil dari konsol Titik akhir: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   Pay-as-you-go	Nama penyedia: Bailian-Pay-as-you-go API Key: Kunci API Model Studio Titik akhir: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. Buka Advanced Options untuk mengonfigurasi pemetaan model. Atur model utama serta model default Haiku, Sonnet, dan Opus ke model yang didukung untuk rencana Anda. Contoh pemetaan:

   • Model utama: qwen3.7-max (tidak didukung oleh Coding Plan)
   • Model default Haiku: qwen3.6-flash (tidak didukung oleh Coding Plan)
   • Model default Sonnet: qwen3.7-max (tidak didukung oleh Coding Plan)
   • Model default Opus: qwen3.7-max (tidak didukung oleh Coding Plan)

3. Kembali ke antarmuka utama, klik Enable di samping penyedia, lalu mulai sesi Claude Code baru agar konfigurasi diterapkan.

Hubungkan Claude Code Desktop

Claude Code Desktop (Claude Desktop) dan CLI Claude Code adalah dua titik masuk terpisah, yang ditampilkan di CC Switch sebagai panel Claude Code dan Claude Desktop masing-masing. Aplikasi desktop mengakses Model Studio melalui gerbang lokal CC Switch: CC Switch secara otomatis menulis alamat gerbang dan token autentikasi ke konfigurasi desktop, sehingga Anda tidak memasukkan Kunci API Model Studio Anda di aplikasi desktop. Kunci API Model Studio hanya dimasukkan dalam konfigurasi penyedia CC Switch dan disuntikkan secara otomatis saat router lokal meneruskan permintaan.

1. Instal Claude Code Desktop dari halaman unduhan Claude.
2. Di CC Switch, beralih ke panel Claude Desktop dari pengalih aplikasi di sebelah kiri. Jika entri tidak ditampilkan, buka Settings > General dan pastikan Claude Desktop tidak disembunyikan di bawah visibilitas aplikasi.
3. Tambahkan penyedia Model Studio: jika Anda telah mengonfigurasi penyedia Model Studio di panel Claude Code, klik Import existing providers from Claude Code untuk menggunakannya kembali; jika tidak, klik + di pojok kanan atas untuk menambahkan satu. Karena ID model Model Studio (seperti qwen3.7-max) bukan tiga ID peran yang dikenali Claude Desktop (claude-sonnet-* / claude-opus-* / claude-haiku-*), aktifkan Needs model mapping dan petakan peran Sonnet, Opus, dan Haiku ke model Model Studio yang sebenarnya untuk diminta (misalnya, Sonnet > qwen3.7-max).
4. Aktifkan perutean lokal: buka Settings > Routing > Local Routing dan aktifkan Show Routing Toggle on Main Page; kembali ke panel Claude Desktop dan aktifkan sakelar Claude Desktop local routing. Alamat pendengar default adalah 127.0.0.1:15721.
5. Klik Enable pada kartu penyedia. CC Switch secara otomatis menulis konfigurasi inferensi pihak ketiga ke Claude Code Desktop.
6. Biarkan CC Switch tetap berjalan, lalu keluar sepenuhnya dan restart Claude Code Desktop agar perubahan diterapkan. Pilih model yang dikonfigurasi dari menu model untuk mulai menggunakannya.

Plugin IDE Claude Code

Setelah menyelesaikan konfigurasi CLI di atas, instal plugin Claude Code di IDE Anda. Plugin ini menggunakan ulang konfigurasi dalam settings.json secara langsung.

VS Code

1. Cari Claude Code for VS Code di pasar ekstensi dan instal.
2. Restart VS Code dan klik ikon di pojok kanan atas untuk membuka Claude Code.
3. Ketik / di kotak dialog, pilih General config, lalu atur model di Selected Model.

JetBrains

1. Cari Claude Code di pasar ekstensi dan instal.
2. Restart IDE dan klik ikon di pojok kanan atas untuk mulai menggunakannya.

FAQ

Kode error

Jika Anda mengalami error selama konfigurasi, rujuk dokumentasi FAQ untuk rencana penagihan Anda:

• Pay-as-you-go: API Kompatibel Anthropic - Kode Error
• Coding Plan: FAQ Coding Plan
• Token Plan Personal Edition: FAQ Token Plan
• Token Plan Team Edition: FAQ Token Plan Team Edition

Permintaan mengembalikan 401 invalid_api_key

Jenis kunci API tidak sesuai dengan ANTHROPIC_BASE_URL. Model Studio menyediakan tiga metode akses, dan setiap metode akses menggunakan URL dasar yang berbeda serta kunci API khusus.

Langkah pemecahan masalah:

1. Periksa URL permintaan. Periksa ANTHROPIC_BASE_URL dalam ~/.claude/settings.json.
2. Konfirmasi jenis kunci API. Menggunakan tabel di atas, pastikan jenis kunci API Anda sesuai dengan URL dasar.
3. Perbaiki konfigurasi. Saat menggunakan kunci API Model Studio Pay-as-you-go, atur ANTHROPIC_BASE_URL menjadi https://dashscope.aliyuncs.com/apps/anthropic.

Setelah memulai Claude Code, antarmuka menampilkan "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"

Claude Code terhubung ke layanan Anthropic resmi alih-alih Alibaba Cloud Model Studio. Hal ini biasanya berarti variabel lingkungan tidak ada atau belum diterapkan. Ikuti langkah-langkah berikut:

1. Periksa konfigurasi. Jalankan perintah /status setelah memulai Claude Code. Verifikasi bahwa ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN mengarah ke alamat Model Studio. Jika output kosong atau menunjukkan alamat non-Model Studio, periksa konfigurasi settings.json.
2. Verifikasi hasCompletedOnboarding. Pastikan hasCompletedOnboarding diatur ke true dalam ~/.claude.json. Tanpa ini, Claude Code mencoba terhubung ke layanan Anthropic resmi untuk verifikasi login saat startup.
3. Buka terminal baru. Setelah mengedit file konfigurasi, buka jendela terminal baru dan jalankan claude agar perubahan diterapkan.
4. Perbarui Claude Code. Jika masalah tetap berlanjut setelah semua langkah di atas, versi Claude Code mungkin sudah usang. Jalankan npm install -g @anthropic-ai/claude-code@latest untuk memperbarui ke versi terbaru, lalu coba lagi.

CC Switch melaporkan "No available model list endpoint found. Check the Base URL or confirm that the provider has opened the port" saat menambahkan penyedia

Pesan ini berasal dari pemeriksaan konektivitas yang dijalankan CC Switch saat menyimpan penyedia: ia memeriksa titik akhir daftar model (seperti /v1/models) terhadap URL permintaan yang dikonfigurasi. Titik akhir kompatibel Anthropic Model Studio (berakhiran /apps/anthropic) hanya menyediakan titik akhir pesan /v1/messages dan tidak menyediakan titik akhir daftar model, sehingga probe mengembalikan 404 dan CC Switch melaporkan "No available model list endpoint found".

Pesan ini tidak memengaruhi penggunaan normal Claude Code dan dapat diabaikan. Claude Code mengirim percakapan melalui /v1/messages, dan model yang digunakan ditentukan langsung oleh pemetaan model di Advanced options CC Switch, tanpa bergantung pada penemuan otomatis dari titik akhir daftar model. Saat URL permintaan dan Kunci API dikonfigurasi dengan benar, cukup klik Enable dan mulai sesi Claude Code baru untuk mengobrol secara normal.

Jika Anda masih tidak dapat mengobrol, verifikasi bahwa URL permintaan berakhiran /apps/anthropic tanpa tambahan /v1, dan pastikan Anda telah mengisi model yang didukung rencana Anda dalam pemetaan model di bawah Advanced options.

Pemetaan model di CC Switch mengembalikan AccessDenied

Jika panggilan model gagal di Claude Code dengan error AccessDenied (HTTP 403, kode: access_denied) setelah Anda mengonfigurasi pemetaan model, periksa apakah model tersebut ditandai sebagai Upcoming deprecation di konsol Model Studio > Model Gallery. Model yang ditandai untuk depresiasi mendatang masih muncul dalam daftar, tetapi panggilan API mengembalikan 403 AccessDenied. Ikuti langkah-langkah berikut:

1. Periksa apakah model ditandai untuk didepresiasi. Di Konsol Model Studio > Model Gallery, cari model yang Anda gunakan dan periksa label statusnya.
2. Beralih ke model terbaru yang tersedia. Ganti model lama (seperti qwen-coder-turbo-0919) dalam pemetaan model dengan model terbaru yang tersedia (seperti qwen3-coder-plus).
3. Konfigurasi ulang pemetaan model dan uji. Perbarui pemetaan model di bawah Advanced options di CC Switch, klik Enable, dan mulai sesi Claude Code baru untuk memverifikasi.