Alibaba Cloud Model Studio：Qwen Code

Preparations

• Get an API key: Dapatkan kunci API sebelum memulai.

• Periksa versi Node.js: Qwen Code memerlukan Node.js versi 20 atau lebih baru. Jalankan node -v untuk memeriksa versi. Jika versinya lebih lama dari 20, Anda harus menginstal ulang.

Instal dan konfigurasikan Qwen Code

1. Instal Qwen Code

   Jalankan salah satu perintah berikut di terminal Anda untuk menginstal Qwen Code.

   Instal menggunakan npm (Direkomendasikan)

   npm install -g @qwen-code/qwen-code@latest

   Instal dari source

   git clone https://github.com/QwenLM/qwen-code.git
   cd qwen-code
   npm install
   npm install -g .

2. Jalankan dan konfigurasikan Qwen Code

   1. Mulai Qwen Code

      Masukkan qwen di terminal Anda untuk menjalankan Qwen Code.

   2. Pilih metode autentikasi

      Contoh ini menggunakan autentikasi kompatibel OpenAI yang disediakan oleh Model Studio. Pilih OpenAI lalu tekan Enter.

      

      Masukkan informasi berikut pada halaman tersebut:

      Item	Description
      API Key	Kunci API Model Studio Anda.
      Base URL	Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1 Virginia: https://dashscope-us.aliyuncs.com/compatible-mode/v1 Beijing: https://dashscope.aliyuncs.com/compatible-mode/v1
      Model	Nama model. Qwen Code secara khusus dioptimalkan untuk seri Qwen3-Coder dan kompatibel dengan model yang menyediakan API kompatibel dengan OpenAI, seperti Qwen-Max, Qwen-Plus, Qwen-Flash, dan DeepSeek. Kami merekomendasikan model dengan kemampuan coding yang kuat, seperti: qwen3-coder-plus qwen3-coder-480b-a35b-instruct qwen3-coder-flash qwen3-coder-30b-a3b-instruct

      Untuk menghindari memasukkan informasi ini setiap kali menjalankan Qwen Code, ekspor variabel lingkungan seperti dijelaskan di bawah.

      Ekspor variabel lingkungan

      Gunakan variabel lingkungan global atau file .env. Jika keduanya dikonfigurasi, variabel lingkungan global akan mengambil prioritas dibanding file .env.

      File .env

      Buat file .env di direktori root proyek dan tambahkan konten berikut. Variabel lingkungan ini hanya berlaku untuk proyek saat ini.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Model Studio Anda
      OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"
      # Berikut adalah URL untuk wilayah Singapura. Wilayah berbeda menggunakan base_url terpisah
      OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
      # Contoh ini menggunakan model qwen3-coder-plus. Anda dapat menggantinya dengan model lain sesuai kebutuhan.
      OPENAI_MODEL="qwen3-coder-plus"

      Variabel lingkungan global

      Tetapkan kunci API Model Studio, URL dasar, dan model sebagai variabel lingkungan global. Variabel ini berlaku untuk semua proyek dan sesi terminal.

      macOS

      1. Jalankan perintah berikut di terminal untuk memeriksa jenis shell default Anda.

         echo $SHELL

      2. Tetapkan variabel lingkungan berdasarkan jenis shell Anda.

         Zsh

         # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Model Studio Anda
         # Berikut adalah URL untuk wilayah Singapura. Wilayah berbeda menggunakan base_url terpisah
         # Contoh ini menggunakan model qwen3-coder-plus. Anda dapat menggantinya dengan model lain sesuai kebutuhan.
         echo 'export OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.zshrc
         echo 'export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"' >> ~/.zshrc
         echo 'export OPENAI_MODEL="qwen3-coder-plus"' >> ~/.zshrc

         Bash

         # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Model Studio Anda
         # Berikut adalah URL untuk wilayah Singapura. Wilayah berbeda menggunakan base_url terpisah
         # Contoh ini menggunakan model qwen3-coder-plus. Anda dapat menggantinya dengan model lain sesuai kebutuhan.
         echo 'export OPENAI_API_KEY="YOUR_DASHSCOPE_API_KEY"' >> ~/.bash_profile
         echo 'export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"' >> ~/.bash_profile
         echo 'export OPENAI_MODEL="qwen3-coder-plus"' >> ~/.bash_profile

      3. Jalankan perintah berikut di terminal untuk menerapkan variabel lingkungan.

         Zsh

         source ~/.zshrc

         Bash

         source ~/.bash_profile

      Windows

      CMD

      1. Jalankan perintah berikut di CMD untuk menetapkan variabel lingkungan.

         # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Model Studio Anda
         # Berikut adalah URL untuk wilayah Singapura. Wilayah berbeda menggunakan base_url terpisah
         # Contoh ini menggunakan model qwen3-coder-plus. Anda dapat menggantinya dengan model lain sesuai kebutuhan.
         setx OPENAI_API_KEY "YOUR_DASHSCOPE_API_KEY"
         setx OPENAI_BASE_URL "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
         setx OPENAI_MODEL "qwen3-coder-plus"

      2. Buka jendela CMD baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah ditetapkan dengan benar.

         echo %OPENAI_API_KEY%
         echo %OPENAI_BASE_URL%
         echo %OPENAI_MODEL%

      PowerShell

      1. Jalankan perintah berikut di PowerShell untuk menetapkan variabel lingkungan.

         # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Model Studio Anda
         # Berikut adalah URL untuk wilayah Singapura. Wilayah berbeda menggunakan base_url terpisah
         # Contoh ini menggunakan model qwen3-coder-plus. Anda dapat menggantinya dengan model lain sesuai kebutuhan.
         [Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
         [Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://dashscope-intl.aliyuncs.com/compatible-mode/v1", [EnvironmentVariableTarget]::User)
         [Environment]::SetEnvironmentVariable("OPENAI_MODEL", "qwen3-coder-plus", [EnvironmentVariableTarget]::User)

      2. Buka jendela PowerShell baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah ditetapkan dengan benar.

         echo $env:OPENAI_API_KEY
         echo $env:OPENAI_BASE_URL
         echo $env:OPENAI_MODEL

Q: Mengapa Qwen Code mengonsumsi token dengan cepat?

A: Qwen Code mungkin memanggil API beberapa kali, yang dapat menghabiskan banyak token. Gunakan metode berikut untuk mengontrol konsumsi token:

• Sederhanakan direktori kerja

  Jalankan Qwen Code di direktori proyek tertentu. Terlalu banyak file di direktori startup, seperti direktori root, dapat meningkatkan konsumsi token.

• Tetapkan batas token

  Buat file .qwen/settings.json di direktori root proyek dan restart Qwen Code. Gunakan sessionTokenLimit untuk mengontrol penggunaan token dalam satu panggilan API:

  {
    "sessionTokenLimit": 32000
  }

  Qwen Code mungkin memanggil API beberapa kali, sehingga konsumsi token untuk satu pertanyaan dapat melebihi nilai sessionTokenLimit.

• Gunakan perintah kompresi/purge

  Masukkan perintah berikut untuk mengurangi konsumsi token:

  • /compress

    Mengompresi riwayat percakapan agar dialog dapat dilanjutkan dalam batas token.

  • /clear

    Purge seluruh riwayat percakapan dan mulai sesi baru.

Q: Bagaimana cara mengganti model?

A: Metodenya bergantung pada apakah Anda telah menyetel variabel lingkungan:

• Jika Anda belum mengonfigurasi variabel lingkungan

  1. Masukkan /quit untuk keluar dari Qwen Code.

  2. Masukkan qwen untuk menjalankan Qwen Code, pilih metode autentikasi OpenAI, lalu masukkan kunci API, URL dasar, dan nama model target.

• Jika Anda telah mengonfigurasi variabel lingkungan

  1. Ubah variabel lingkungan OPENAI_MODEL menjadi model target dan terapkan perubahan tersebut. Untuk informasi selengkapnya, lihat Ekspor variabel lingkungan.

  2. Masukkan /quit untuk keluar dari Qwen Code, lalu masukkan qwen untuk menjalankannya kembali.

Q: Mengapa saya mendapatkan error 401 Incorrect API key provided?

A: Error ini mungkin disebabkan oleh konfigurasi API yang salah. Bandingkan kunci API dalam pesan error dengan pengaturan Anda untuk memastikan keduanya sesuai. Konfigurasi variabel lingkungan global memiliki prioritas lebih tinggi daripada konfigurasi file lingkungan. Untuk menggunakan konfigurasi dari file lingkungan, pastikan variabel lingkungan global terkait tidak disetel atau hapus sementara.

Untuk informasi selengkapnya, lihat panduan troubleshooting Qwen Code.