Blog

Qwen Code i Qwen 3.7-max: konfiguracja Token Plan

Markdown

Instalacja Qwen Code w Node.js 22, połączenie z międzynarodowym Token Plan oraz trzy pułapki powodujące błędy 401: adres API, klucz i przypisanie miejsca.

Przeczytaj cały artykuł

Dokumentacja referencyjna Ailoot: ailoot.ai/docs/.

Aktualizacja z 03.10.2026: od publikacji zmieniły się trzy rzeczy. Alibaba zamknęła możliwość nowych zakupów Coding Plan — Lite przestał być dostępny już w marcu, a Pro jest wyprzedany. Token Plan przeszedł z tygodniowego limitu na miesięczny. Ukazał się nowszy model Qwen3.8-max. Poprawiłem też błąd w opisie klucza Token Plan — ma on znaczenie przy tym konkretnym błędzie 401, co wyjaśniam poniżej.

Czym jest Qwen Code i dlaczego nie jest kolejną podróbką?

Najważniejsza informacja

Qwen Code to open source’owy terminalowy agent AI od Alibaba, który działa podobnie do Claude Code: uruchamia się w terminalu VS Code, czyta projekt, pisze kod i wykonuje polecenia. Kluczowa różnica to dostęp do kilkunastu modeli w ramach jednej subskrypcji, w tym Qwen 3.7, DeepSeek V4 i Kimi K2.

Kiedy po raz pierwszy usłyszałem o Qwen Code, pomyślałem: „kolejny klon Claude Code, który zepsuje się przy drugim promptcie”. Myliłem się. Alibaba nie skopiowała interfejsu — zbudowała własnego agenta CLI od podstaw, z pełną zgodnością z API OpenAI. Oznacza to, że można uruchamiać w nim nie tylko modele Qwen, ale też DeepSeek, GLM, Kimi, a nawet Claude przez API Anthropic.

Oto, co faktycznie potrafi:

  • Odczytuje strukturę projektu i rozumie kontekst (podobnie jak Claude Code z plikiem CLAUDE.md)
  • Uruchamia polecenia powłoki, edytuje pliki i tworzy commity
  • Obsługuje Skills i SubAgents
  • Działa w VS Code przez wbudowany terminal lub rozszerzenie
  • Przełącza modele za pomocą jednego polecenia /model

Ma jedną wadę, ale istotną: bezpłatny plan został zamknięty 15 kwietnia 2026 r. Wcześniej Qwen OAuth zapewniał 100 bezpłatnych zapytań dziennie — teraz dostępne są już tylko płatne opcje. Mimo to nawet płatny Qwen Code kosztuje zauważalnie mniej niż subskrypcja Claude Pro. Jeśli właśnie wybierasz narzędzie, wszystkie opcje opisałem w przewodniku „Czego używać do kodowania w 2026 roku: 8 narzędzi AI”.

Ile to kosztuje i który plan wybrać?

Najważniejsza informacja

Alibaba oferuje trzy opcje płatności: rozliczenie za tokeny, subskrypcję Coding Plan i subskrypcję Token Plan. Do codziennego vibe codingu najlepszą wartość oferuje Token Plan: stała kwota miesięczna, ponad 10 modeli i brak konieczności liczenia tokenów.

Największym problemem podczas konfiguracji Qwen Code jest zamieszanie wokół planów. Alibaba używa różnych nazw w różnych częściach konsoli, a rozszerzenie VS Code pokazuje nawet nieprawidłowe opcje. Oto jak to naprawdę działa (sprawdzone w dokumentacji Alibaba Cloud, zaktualizowanej tam 28.09.2026).

PlanNa czym polegaDla kogoPrzybliżony koszt
Pay-as-you-goPłacisz osobno za każdy milion tokenówSporadyczne użycie, testowanie$0.30-1.20 za 1M tokenów
Coding PlanSubskrypcja dla osób indywidualnych z miesięcznym limitem (tygodniowy limit wycofano 22.09.2026)Obecnie niedostępny dla nowych subskrybentów — zakup planu Lite zamknięto 20.03.2026, Pro jest wyprzedanyobecnie niedostępny dla nowych kont
Token Plan Team Edition, Standard Seat25 000 Credits na miejsce miesięcznie, ponad 10 modeliCodzienny vibe coding z przełączaniem modeli$20 za miejsce miesięcznie w promocji (cena regularna: $30)

Zgodnie z doświadczeniem opisanym przez autora wybrano Token Plan, ponieważ jedna subskrypcja zapewnia dostęp do Qwen 3.7-max (oraz nowszego Qwen3.8-max), DeepSeek V4 Pro i GLM-5. Wszystkie modele korzystają z tej samej puli Credits. Przełączaj je poleceniem /model — nie musisz kupować osobnego klucza dla każdego dostawcy.

Ważne: Coding Plan i Token Plan to różne produkty z różnymi adresami API. Klucz Coding Plan ma prefiks sk-sp-. Klucz Token Plan nie ma żadnego prefiksu — tak opisuje go oficjalna dokumentacja Qwen Code. Pomylenie adresu lub klucza między produktami spowoduje błąd 401. Ponieważ Coding Plan nie jest już dostępny w sprzedaży, Token Plan to obecnie jedyna działająca opcja dla większości czytelników.

Jak zainstalować Qwen Code?

Najważniejsza informacja

Są dwie opcje: przez npm (npm install -g @qwen-code/qwen-code@latest) albo Homebrew (brew install qwen-code). Potrzebujesz Node.js 22 lub nowszego. Po instalacji uruchom qwen w terminalu.

Przed instalacją sprawdź wersję Node.js:

node --version

Potrzebujesz wersji 22 lub nowszej. Jeśli masz starszą, zaktualizuj ją przez nodejs.org albo za pomocą nvm:

nvm install 22
nvm use 22

Następnie zainstaluj Qwen Code jednym poleceniem:

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

Na macOS możesz też użyć Homebrew:

brew install qwen-code

Sprawdź instalację:

qwen --version

Jeśli wyświetli się numer wersji, wszystko jest gotowe. Uruchom Qwen Code, wpisując qwen w terminalu. W VS Code otwórz wbudowany terminal (Ctrl+) i wpisz qwen`.

Dostępne jest również rozszerzenie VS Code — Qwen Code Companion od QwenLM w marketplace. Dodaje boczny panel czatu, podobnie jak GitHub Copilot. Używam go — jest wygodniejszy niż sam terminal.

Jak założyć konto i kupić Token Plan?

Najważniejsza informacja

Zarejestruj się w międzynarodowej konsoli Alibaba Cloud (modelstudio.console.alibabacloud.com), dodaj kartę akceptowaną przez dostawcę i wykup Token Plan. Cały proces zajmuje 10 minut.

Krok po kroku:

  1. Przejdź do modelstudio.console.alibabacloud.com
  2. Kliknij Free Sign Up w prawym górnym rogu
  3. Wpisz swój adres e-mail (Gmail działa) i potwierdź kod z poczty
  4. Dodaj numer telefonu
  5. Dodaj kartę akceptowaną przez dostawcę. Alibaba pobierze $1 w celu jej weryfikacji i zwróci tę kwotę w ciągu 1–3 dni.
  6. W konsoli znajdź sekcję ModelStudio — kartę Token Plan
  7. Wybierz plan Standard (najniższy, na początek)
  8. Potwierdź płatność

Po zakupie przejdziesz na stronę My Subscriptions. Zobaczysz tam:

  • Standard Seat: 0/1 — oznacza to, że kupiłeś miejsce, ale nie przypisałeś go jeszcze sobie
  • Kliknij Assign — wybierz swoje konto i potwierdź
  • Powinno zmienić się na 1/1

Bez tego klucz API nie zadziała. Zgodnie z doświadczeniem autora ten krok zajął 20 minut.

Gdzie znaleźć klucz API i prawidłowy adres?

Najważniejsza informacja

Klucz API i adres API (Base URL) znajdują się na stronie Management Platform. Adres międzynarodowego Token Plan to https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Nie pomyl go ze standardowym adresem DashScope — klucz Token Plan nie będzie tam działać.

Na stronie My Subscriptions kliknij duży fioletowy przycisk Go to Management Platform. Otworzy się osobny panel.

Wybierz Overview w menu po lewej stronie. Na tej stronie zobaczysz dwie sekcje:

Plan-specific API Key — twój osobisty klucz. Jest zamaskowany gwiazdkami. Kliknij znajdującą się obok ikonę kopiowania (nie zaznaczaj go myszą — skopiują się gwiazdki). Klucze Token Plan nie mają prefiksu. To nie literówka w instrukcji — tak opisuje je oficjalna dokumentacja Qwen Code. Jeśli widzisz sk-sp-, to klucz Coding Plan z innego produktu — skopiowałeś niewłaściwy klucz.

Plan-specific Base URL — dostępne są dwie opcje:

  • Dla narzędzi zgodnych z OpenAI (Qwen Code): https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • Dla narzędzi zgodnych z Anthropic: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

Pamiętaj: z kluczem Token Plan działają tylko te adresy. Standardowy adres dashscope-intl.aliyuncs.com jest przeznaczony dla zwykłych kluczy (pay-as-you-go), a coding-intl.dashscope.aliyuncs.com to adres Coding Plan. Użycie klucza Token Plan z którymkolwiek z nich spowoduje błąd 401.

Jak połączyć Qwen Code z VS Code?

Najważniejsza informacja

Skonfiguruj rozszerzenie VS Code w pliku ~/.qwen/settings.json. Musisz podać klucz, prawidłowy adres API i model. Oto gotowa konfiguracja — skopiuj ją i zastąp klucz własnym.

Jeśli zainstalowałeś rozszerzenie Qwen Code Companion z marketplace VS Code:

  1. Otwórz paletę poleceń (Cmd+Shift+P)
  2. Wpisz Qwen Code: Choose Provider
  3. Jeśli pojawi się menu opcji, nie wybieraj Coding Plan (to inny produkt). Wybierz Standard API Key
  4. Wklej klucz z Management Platform — klucze Token Plan nie mają stałego prefiksu
  5. Region: Singapore
  6. Model: qwen3.7-max

Jeśli po tym pojawi się błąd, skonfiguruj go ręcznie w pliku. Rozszerzenie czasem uzupełnia nieprawidłowy adres.

Otwórz lub utwórz plik ~/.qwen/settings.json i wklej:

{
  "env": {
    "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-max",
        "name": "qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 262144
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      },
      {
        "id": "deepseek-v4-pro",
        "name": "deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": { "enable_thinking": true },
          "contextWindowSize": 1000000
        }
      }
    ]
  },
  "security": {
    "auth": { "selectedType": "openai" }
  },
  "model": { "name": "qwen3.7-max" }
}

Zastąp YOUR-KEY-FROM-MANAGEMENT-PLATFORM swoim kluczem z Management Platform. Uruchom ponownie VS Code. Gotowe.

Dlaczego pojawia się błąd 401 i jak go naprawić?

Najważniejsza informacja

W 90% przypadków błąd 401 podczas konfigurowania Qwen Code oznacza, że adres API lub klucz jest nieprawidłowy. Token Plan, Coding Plan i pay-as-you-go korzystają z różnych adresów, a ich kluczy nie można stosować zamiennie.

Autor opisał błędy napotkane podczas konfiguracji. Oto pełna lista przyczyn błędów 401 i sposoby ich sprawdzenia:

ObjawPrzyczynaRozwiązanie
invalid_api_keyKlucz Token Plan jest wysyłany na adres DashScope (lub odwrotnie)Sprawdź Base URL. Dla Token Plan: token-plan.ap-southeast-1...; dla Coding Plan: coding-intl.dashscope...
invalid access tokenNie przypisano Standard Seat (0/1)Przejdź do My Subscriptions, kliknij Assign — powinno wyświetlić 1/1
invalid_api_keyRozszerzenie VS Code wygenerowało własny klucz w procesie uwierzytelniania zamiast użyć Token PlanOtwórz ~/.qwen/settings.json i sprawdź, czy klucz zgadza się z tym widocznym w Management Platform (nie pomyl go z kluczem Coding Plan, który ma prefiks sk-sp-)
invalid_api_keyRazem z kluczem skopiowano spację lub znak nowej liniiUsuń klucz i skopiuj go ponownie za pomocą ikony kopiowania (nie zaznaczaj go myszą)
model not foundTwoja subskrypcja nie obejmuje tego modeluSprawdź listę Available Models na stronie subskrypcji
Insufficient quotaSkończyły się CreditsSprawdź Usage w My Subscriptions. Jeśli wynosi 100%, poczekaj na reset lub kup Boost Pack

Szybkie sprawdzenie klucza w terminalu:

curl -s -o /dev/null -w "%{http_code}" -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}'

Jeśli zwróci 200, klucz działa, a problem tkwi w ustawieniach rozszerzenia. Jeśli zwróci 401, klucz lub adres jest nieprawidłowy.

Jakie modele są dostępne i który wybrać?

Najważniejsza informacja

Token Plan oferuje ponad 10 modeli od 5 dostawców; nowy flagowy Qwen3.8-max dodano w sierpniu 2026 r. Do vibe codingu głównym modelem roboczym jest qwen3.6-plus (równowaga ceny i jakości). Do złożonych zadań użyj qwen3.7-max lub nowszego qwen3.8-max. Do szybkich edycji wybierz qwen3.6-flash.

Oto modele naprawdę przydatne do vibe codingu:

ModelKiedy używaćZużycie Credits
qwen3.8-maxNowy flagowy model Alibaba (wydany w sierpniu 2026 r.), najwyższa jakość przy złożonych zadaniachWysokie — Credits kończą się szybciej niż w przypadku 3.7-max
qwen3.7-maxZłożona architektura, refaktoryzacja dużego projektu, generowanie od zeraWysokie — przy codziennym kodowaniu limit wyczerpuje się w tydzień
qwen3.6-plusCodzienny model roboczy: edycje, ulepszenia, przeglądy, wyjaśnieniaŚrednie — wystarczy na miesiąc przy pracy 2–4 godziny dziennie
qwen3.6-flashSzybkie edycje, proste pytania, formatowanieNiskie
deepseek-v4-proAlternatywa dla Qwen: czasem lepszy w zadaniach algorytmicznych i matematyceŚrednie
kimi-k2.6Długi kontekst: czytanie dużych baz kodu, analiza dokumentacjiŚrednie

Przełączaj modele poleceniem /model bezpośrednio w sesji Qwen Code — nie musisz zmieniać ustawień ani uruchamiać programu ponownie.

Zacząłbym od qwen3.6-plus. Jeśli po tygodniu okaże się, że limit wyczerpuje się zbyt szybko, przełącz rutynowe zadania na qwen3.6-flash, a qwen3.7-max zostaw tylko do złożonych zadań.

Qwen Code czy Claude Code — którego używać?

Najważniejsza informacja

Claude Code tworzy lepszy kod i lepiej rozumie kontekst. Qwen Code kosztuje mniej i zapewnia dostęp do kilku modeli w ramach jednej subskrypcji. Idealne połączenie: Claude Code do głównej pracy, Qwen Code do zadań równoległych i eksperymentów.

Recenzja opisuje miesiąc pracy autora z oboma narzędziami. Oto porównanie oparte na tym doświadczeniu:

KryteriumClaude CodeQwen Code
Jakość koduLepsza — Anthropic wypuściło później nowsze modele (Opus 5.5, 22.09.2026); różnica się nie zmniejszyłaDobra, ale nawet nowy flagowy Qwen3.8-max ustępuje najlepszym modelom Anthropic w niezależnych testach
Rozumienie projektuCLAUDE.md + dogłębne czytanie drzewa projektu = działa jak człowiekPodobne mechanizmy, ale mniejsze dopracowanie
CenaClaude Pro $20/miesiąc (Max $100-200/miesiąc dla intensywnego kodowania)Token Plan Standard od $20/miesiąc, obejmuje ponad 10 modeli
Wybór modeliTylko Claude (Opus/Sonnet/Haiku)Qwen + DeepSeek + GLM + Kimi + MiniMax
Open sourceNie (zamknięte źródło)Tak (licencja MIT)

| Rozszerzenie VS Code | Natywne, stabilne | Dostępne, ale niedopracowane — czasem pojawiają się problemy z kluczem |

Kiedy Qwen Code jest lepszym wyborem:

  • Potrzebujesz dostępu do kilku modeli (DeepSeek do matematyki, Kimi do długiego kontekstu)
  • Testujesz różne podejścia do jednego zadania
  • Masz ograniczony budżet, ale kodujesz codziennie
  • Chcesz korzystać z narzędzia open source, które możesz dostosować

Kiedy Claude Code jest niezbędny:

  • Krytyczny projekt, w którym jakość kodu przekłada się na pieniądze
  • Praca z dużym starszym projektem (Opus lepiej utrzymuje kontekst) — osobno opisałem jak nie wyczerpać limitów Claude Code
  • Potrzebujesz stabilnego rozszerzenia VS Code bez ręcznej konfiguracji

Połączenie opisane przez autora: Claude Code do głównego projektu, Qwen Code do eksperymentów i zadań równoległych, gdzie można szybko wypróbować pomysł na tańszym modelu. Szczegółowe porównanie z innymi narzędziami znajdziesz w artykułach Cursor vs Claude Code i Codex vs Claude Code.

Trzy pułapki, na które trafia każdy

Najważniejsza informacja

Token Plan i Coding Plan to różne produkty z różnymi adresami. Rozszerzenie VS Code wstawia niewłaściwy klucz. Miejsce trzeba przypisać ręcznie. Te trzy pułapki kosztują od 30 minut do kilku godzin — trafiłem na wszystkie i zapisałem rozwiązania.

Pułapka 1: Token Plan ≠ Coding Plan

Alibaba używa różnych nazw tych produktów w różnych częściach konsoli. Opcja „Coding Plan” w rozszerzeniu VS Code nie oznacza Token Plan. Pamiętaj: od 20.03.2026 Coding Plan Lite nie przyjmuje nowych zakupów, a Pro jest wyprzedany — jeśli jeszcze go nie masz, możesz wybrać tylko Token Plan. Produkty mają różne adresy API:

  • Token Plan: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  • Coding Plan: https://coding-intl.dashscope.aliyuncs.com/v1

Jeśli kupiłeś Token Plan, ale skonfigurowałeś rozszerzenie jako Coding Plan, otrzymasz błąd 401. I odwrotnie.

Pułapka 2: Rozszerzenie VS Code generuje własny klucz

Podczas konfiguracji przez GUI rozszerzenia (Cmd+Shift+P - Qwen Code: Choose Provider) rozszerzenie czasem generuje własny klucz przez Alibaba Auth API. Ten klucz ma inny format i nie jest powiązany z subskrypcją Token Plan.

Rozwiązanie: po konfiguracji przez GUI otwórz ~/.qwen/settings.json i upewnij się, że klucz w env jest taki sam jak w Management Platform (Overview - Plan-specific API Key). Jeśli nie, zastąp go ręcznie.

Pułapka 3: Standard Seat nie zostało przypisane

Po zakupie Token Plan na stronie My Subscriptions zobaczysz Standard Seat: 0/1. Oznacza to, że miejsce zostało kupione, ale nie jest przypisane do twojego konta. Klucz API nie zadziała, dopóki nie klikniesz Assign.

Zgodnie z doświadczeniem autora diagnozowanie błędu 401 zajęło 20 minut, zanim zauważono ten wiersz.

Jak sprawdzić, czy wszystko działa?

Najważniejsza informacja

Dwa kroki: najpierw sprawdź klucz poleceniem curl w terminalu (powinno zwrócić 200), a następnie wpisz dowolny prompt w Qwen Code. Jeśli curl działa, a rozszerzenie nie, problem tkwi w ustawieniach pliku ~/.qwen/settings.json.

Krok 1. Sprawdź klucz w terminalu:

curl -X POST \
  "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}'

Jeśli odpowiedź zawiera tekst wygenerowany przez model, klucz i adres działają.

Krok 2. Sprawdź Qwen Code:

Otwórz VS Code, uruchom wbudowany terminal i wpisz qwen. Jeśli program się uruchomi, wpisz coś:

Co to za projekt w tym folderze?

Qwen Code odczyta strukturę i odpowie. Jeśli to zrobi, konfiguracja jest zakończona.

Krok 3. Sprawdź zużycie Credits:

Pięć minut po pierwszych zapytaniach przejdź do Management Platform—Overview—Usage Consumption. Wartość procentowa powinna być różna od zera. Jeśli po ponad 10 zapytaniach nadal wynosi 0%, używasz niewłaściwego adresu (zapytania omijają subskrypcję i trafiają do rozliczenia pay-as-you-go albo donikąd).

Co dalej?

Najważniejsza informacja

Qwen Code jest skonfigurowany — możesz zacząć vibe coding. Samo narzędzie to jednak dopiero początek. Różnica między „zainstalowałem CLI” a „buduję produkt z AI” wynika z metodologii pracy z kontekstem.

Zainstalowałeś Qwen Code i działa. Możesz otworzyć dowolny projekt i zacząć go tworzyć, rozmawiając z AI.

Następne pytanie brzmi: dlaczego ten sam prompt w Qwen Code daje świetny wynik w jednym projekcie, a bezwartościowy w innym? Chodzi o kontekst. Jeśli projekt zawiera strukturę business/ z informacjami o odbiorcach, produktach i celach, AI działa jak partner. Jeśli folder jest pusty, zaczyna halucynować.

Źródła

Poznaj dalej Ailoot na ailoot.ai.

Więcej szczegółów

Pytania i odpowiedzi

Co najpierw sprawdzić, gdy klucz Token Plan zwraca 401?

Potwierdź, że klucz i Base URL należą do Token Plan, a nie Coding Plan lub zwykłego DashScope, skopiuj klucz przyciskiem kopiowania w konsoli i sprawdź przypisanie kupionego Standard Seat. Potem porównaj zapisane ustawienia rozszerzenia z tą samą konfiguracją.

Czy udane żądanie w terminalu potwierdza konfigurację rozszerzenia VS Code?

Nie. Sprawdza klucz, punkt końcowy i model użyte w tym żądaniu. Osobno przetestuj prompt w Qwen Code i porównaj zapisany Base URL oraz klucz z działającym żądaniem. Sprawdź też zużycie we właściwej subskrypcji.

Wszystkie artykuły