Qwen Code a Qwen 3.7-max: nastavení Token Plan
MarkdownInstalace Qwen Code na Node.js 22, připojení mezinárodního Token Plan a tři úskalí, která způsobují chyby 401: adresa API, klíč a přiřazení licence.
Přečíst celý článek
Referenční dokumentace Ailoot: ailoot.ai/docs/.
Aktualizováno 03.10.2026: od vydání se změnily tři věci. Alibaba uzavřela Coding Plan pro nové nákupy — tarif Lite už v březnu a tarif Pro je vyprodaný. Token Plan přešel z týdenního limitu na měsíční. Byl vydán novější model Qwen3.8-max. Opravil jsem také chybu v popisu klíče Token Plan — právě ta souvisí s chybou 401 a vysvětluji ji níže.
Co je Qwen Code a proč nejde jen o další napodobeninu?
Hlavní poznatek
Qwen Code je open-source AI agent pro terminál od Alibaby, který funguje jako Claude Code: běží v terminálu VS Code, čte váš projekt, píše kód a spouští příkazy. Klíčový rozdíl je přístup k více než deseti modelům v rámci jednoho předplatného, včetně Qwen 3.7, DeepSeek V4 a Kimi K2.
Když jsem o Qwen Code slyšel poprvé, pomyslel jsem si: „Další klon Claude Code, který selže u druhého zadání.“ Mýlil jsem se. Alibaba nezkopírovala rozhraní — vlastního agenta CLI vytvořila od základu, s plnou kompatibilitou s API OpenAI. To znamená, že v něm můžete používat nejen modely Qwen, ale také DeepSeek, GLM, Kimi, a dokonce Claude přes API Anthropic.
Co skutečně umí:
- Čte strukturu projektu a rozumí kontextu (jako Claude Code se souborem
CLAUDE.md) - Spouští příkazy shellu, upravuje soubory a vytváří commity
- Podporuje Skills a SubAgents
- Funguje ve VS Code přes vestavěný terminál nebo rozšíření
- Přepíná mezi modely jediným příkazem
/model
Má jednu nevýhodu, která je ale zásadní: bezplatná verze skončila 15. dubna 2026. Dříve vám Qwen OAuth poskytoval 100 bezplatných požadavků denně — nyní zbývají jen placené možnosti. I placený Qwen Code ale stojí výrazně méně než předplatné Claude Pro. Pokud se právě rozhodujete mezi nástroji, všechny možnosti jsem probral v návodu „S čím programovat v roce 2026: 8 nástrojů AI“.
Kolik stojí Qwen Code s Token Plan a který tarif vybrat?
Hlavní poznatek
Alibaba nabízí tři možnosti platby: platbu za tokeny, předplatné Coding Plan a předplatné Token Plan. Pro každodenní vibe coding nabízí nejlepší poměr ceny a hodnoty Token Plan: pevná měsíční částka, přes 10 modelů a bez nutnosti počítat tokeny.
Největší potíže při nastavování Qwen Code způsobuje nejasnost kolem tarifů. Alibaba jim v různých částech konzole říká různě a rozšíření VS Code dokonce zobrazuje nesprávné možnosti. Takhle to skutečně funguje (ověřeno v dokumentaci Alibaba Cloud, naposledy aktualizované 28.09.2026).
| Tarif | Co to je | Pro koho je určený | Přibližná cena |
|---|---|---|---|
| Platba podle skutečného využití | Platíte zvlášť za každý milion tokenů | Příležitostné používání a zkoušení | $0.30–1.20 za 1M tokenů |
| Coding Plan | Předplatné pro jednotlivce s měsíčním limitem (týdenní limit byl ukončen 22.09.2026) | Pro nové předplatitele momentálně nedostupný — tarif Lite přestal přijímat nákupy 20.03.2026 a Pro je vyprodaný | pro nové účty momentálně nedostupný |
| Token Plan Team Edition, Standard Seat | 25 000 kreditů na licenci měsíčně, přes 10 modelů | Každodenní vibe coding s přepínáním modelů | $20 za licenci měsíčně v rámci akce (běžná cena: $30) |
V popsané zkušenosti autora zvolil Token Plan, protože jedno předplatné poskytuje přístup k Qwen 3.7-max (a novějšímu Qwen3.8-max), DeepSeek V4 Pro a GLM-5. Všechny modely čerpají ze stejného balíku kreditů. Přepínejte příkazem /model — nemusíte kupovat samostatný klíč pro každého poskytovatele.
Důležité: Coding Plan a Token Plan jsou různé produkty s různými adresami API. Klíč Coding Plan má předponu sk-sp-. Klíč Token Plan nemá žádnou předponu — tak jej popisuje oficiální dokumentace Qwen Code. Pokud si spletete adresu nebo klíč mezi produkty, dostanete chybu 401. A protože nové nákupy Coding Plan jsou uzavřené, Token Plan je nyní pro většinu čtenářů jedinou funkční možností.
Jak nainstalovat Qwen Code?
Hlavní poznatek
Máte dvě možnosti: přes npm (npm install -g @qwen-code/qwen-code@latest) nebo Homebrew (brew install qwen-code). Potřebujete Node.js 22 nebo novější. Po instalaci spusťte v terminálu qwen.
Před instalací zkontrolujte verzi Node.js:
node --version
Potřebujete verzi 22 nebo novější. Pokud máte starší, aktualizujte ji přes nodejs.org nebo pomocí nvm:
nvm install 22
nvm use 22
Poté nainstalujte Qwen Code jedním příkazem:
npm install -g @qwen-code/qwen-code@latest
Nebo na macOS použijte Homebrew:
brew install qwen-code
Ověřte instalaci:
qwen --version
Pokud se zobrazí verze, můžete pokračovat. Qwen Code spustíte příkazem qwen v terminálu. Ve VS Code otevřete vestavěný terminál (Ctrl+) a zadejte qwen`.
K dispozici je také rozšíření VS Code — Qwen Code Companion od QwenLM na marketplace. Přidává postranní panel chatu podobný GitHub Copilot. Používám ho, protože je pohodlnější než samotný terminál.
Jak vytvořit účet a koupit Token Plan?
Hlavní poznatek
Zaregistrujte se v mezinárodní konzoli Alibaba Cloud (modelstudio.console.alibabacloud.com), přidejte kartu, kterou poskytovatel přijímá, a předplaťte si Token Plan. Celý proces zabere 10 minut.
Postup krok za krokem:
- Přejděte na modelstudio.console.alibabacloud.com
- Vpravo nahoře klikněte na Free Sign Up
- Zadejte e-mail (Gmail funguje) a potvrďte kód z doručené pošty
- Přidejte své telefonní číslo
- Přidejte kartu, kterou poskytovatel přijímá. Alibaba strhne $1 na ověření a vrátí vám ho za 1–3 dny.
- V konzoli najděte sekci ModelStudio a kartu Token Plan
- Vyberte tarif Standard (nejnižší tarif pro začátek)
- Potvrďte platbu
Po nákupu se dostanete na stránku My Subscriptions. Uvidíte tam:
- Standard Seat: 0/1 — znamená to, že jste koupili licenci, ale ještě jste ji nepřiřadili sobě
- Klikněte na Assign — vyberte svůj účet a potvrďte
- Stav by se měl změnit na 1/1
Bez tohoto kroku klíč API nebude fungovat. Podle autorovy zkušenosti tento krok zabral 20 minut.
Kde získat klíč API a správnou adresu?
Hlavní poznatek
Klíč API a adresa API (Base URL) jsou na stránce Management Platform. Pro mezinárodní Token Plan je adresa https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Nepleťte si ji s běžnou adresou DashScope — klíč Token Plan na ní nebude fungovat.
Na stránce My Subscriptions klikněte na velké fialové tlačítko Go to Management Platform. Otevře se samostatný panel.
V levé nabídce vyberte Overview. Na této stránce uvidíte dvě sekce:
Plan-specific API Key — váš osobní klíč. Je skrytý za hvězdičkami. Klikněte na ikonu kopírování vedle něj (neoznačujte ho myší — zkopírovaly by se hvězdičky). Klíče Token Plan nemají předponu. V pokynech nejde o překlep; tak je popisuje oficiální dokumentace Qwen Code. Pokud vidíte sk-sp-, jde o klíč Coding Plan z jiného produktu — zkopírovali jste nesprávný klíč.
Plan-specific Base URL — dvě možnosti:
- Pro nástroje kompatibilní s OpenAI (Qwen Code):
https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - Pro nástroje kompatibilní s Anthropic:
https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
Pamatujte: s klíčem Token Plan fungují pouze tyto adresy. Standardní adresa dashscope-intl.aliyuncs.com je určena pro běžné klíče (platba podle využití), zatímco coding-intl.dashscope.aliyuncs.com je adresa Coding Plan. Klíč Token Plan použitý s kteroukoli z nich vrátí chybu 401.
Jak připojit Qwen Code k VS Code?
Hlavní poznatek
Rozšíření VS Code nakonfigurujete přes soubor ~/.qwen/settings.json. Je třeba zadat klíč, správnou adresu API a model. Zde je hotová konfigurace — zkopírujte ji a nahraďte klíč svým.
Pokud jste nainstalovali rozšíření Qwen Code Companion z marketplace VS Code:
- Otevřete paletu příkazů (Cmd+Shift+P)
- Zadejte Qwen Code: Choose Provider
- Pokud se zobrazí nabídka možností, nevybírejte Coding Plan (jde o jiný produkt). Vyberte Standard API Key
- Vložte klíč z Management Platform — klíče Token Plan nemají pevně danou předponu
- Oblast: Singapore
- Model:
qwen3.7-max
Pokud se poté objeví chyba, nakonfigurujte jej ručně přes soubor. Rozšíření někdy vyplní nesprávnou adresu.
Otevřete nebo vytvořte soubor ~/.qwen/settings.json a vložte do něj:
{
"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" }
}
Nahraďte YOUR-KEY-FROM-MANAGEMENT-PLATFORM svým klíčem z Management Platform. Restartujte VS Code. Hotovo.
Proč se zobrazuje chyba 401 a jak ji opravit?
Hlavní poznatek
V 90 % případů znamená chyba 401 při nastavení Qwen Code nesprávnou adresu API nebo klíč. Token Plan, Coding Plan a platba podle skutečného využití používají různé adresy a jejich klíče nelze zaměňovat.
Autor popisuje chyby, na které narazil při nastavování. Zde je úplný seznam příčin chyb 401 a způsobů, jak je ověřit:
| Příznak | Příčina | Řešení |
|---|---|---|
invalid_api_key | Klíč Token Plan se posílá na adresu DashScope (nebo naopak) | Zkontrolujte Base URL. Pro Token Plan: token-plan.ap-southeast-1...; pro Coding Plan: coding-intl.dashscope... |
invalid access token | Licence Standard Seat nebyla přiřazena (0/1) | Přejděte do My Subscriptions — klikněte na Assign — měl by se zobrazit stav 1/1 |
invalid_api_key | Rozšíření VS Code vygenerovalo vlastní klíč prostřednictvím ověřovacího postupu místo použití Token Plan | Otevřete ~/.qwen/settings.json a zkontrolujte, zda klíč odpovídá tomu, který zobrazuje Management Platform (nezaměňujte ho za klíč Coding Plan s předponou sk-sp-) |
invalid_api_key | Spolu s klíčem se zkopírovala mezera nebo konec řádku | Klíč smažte a zkopírujte znovu pomocí ikony kopírování (neoznačujte ho myší) |
model not found | Model není součástí vašeho tarifu | Zkontrolujte seznam Available Models na stránce předplatného |
Insufficient quota | Došly kredity | Zkontrolujte Usage na stránce My Subscriptions. Pokud je stav 100 %, počkejte na obnovení limitu nebo kupte Boost Pack |
Rychlé ověření klíče přes terminál:
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}'
Pokud vrátí 200, klíč funguje a problém je v nastavení rozšíření. Pokud vrátí 401, klíč nebo adresa jsou nesprávné.
Které modely jsou k dispozici a který si vybrat?
Hlavní poznatek
Token Plan nabízí přes 10 modelů od 5 poskytovatelů; nový vlajkový model Qwen3.8-max byl přidán v srpnu 2026. Pro vibe coding je hlavním univerzálním modelem qwen3.6-plus (vyvážený poměr ceny a kvality). Pro složité úkoly použijte qwen3.7-max nebo novější qwen3.8-max. Na rychlé úpravy použijte qwen3.6-flash.
Tady jsou modely, které se pro vibe coding opravdu hodí:
| Model | Kdy ho použít | Spotřeba kreditů |
|---|---|---|
| qwen3.8-max | Nový vlajkový model Alibaby (vydaný v srpnu 2026), maximální kvalita u složitých úkolů | Vysoká — kredity ubývají rychleji než u 3.7-max |
| qwen3.7-max | Složitá architektura, refaktoring velkého projektu, generování od nuly | Vysoká — při každodenním programování se limit vyčerpá za týden |
| qwen3.6-plus | Každodenní univerzální model: úpravy, vylepšení, kontroly, vysvětlení | Střední — vystačí na měsíc při 2–4 hodinách denně |
| qwen3.6-flash | Rychlé úpravy, jednoduché dotazy, formátování | Nízká |
| deepseek-v4-pro | Alternativa k Qwen: někdy lepší pro algoritmické úkoly a matematiku | Střední |
| kimi-k2.6 | Dlouhý kontext: čtení rozsáhlých kódových základen, analýza dokumentace | Střední |
Mezi modely můžete přepínat příkazem /model přímo v relaci Qwen Code — nemusíte měnit nastavení ani restartovat.
Začal bych s qwen3.6-plus. Pokud vám po týdnu připadá, že se limit vyčerpává příliš rychle, přejděte pro běžnou práci na qwen3.6-flash a qwen3.7-max si nechte jen na složité úkoly.
Qwen Code nebo Claude Code — který používat?
Hlavní poznatek
Claude Code vytváří kvalitnější kód a lépe rozumí kontextu. Qwen Code stojí méně a dává vám v rámci jednoho předplatného přístup k několika modelům. Ideální kombinace: Claude Code pro hlavní práci, Qwen Code pro paralelní úkoly a experimenty.
Recenze popisuje měsíc, během kterého autor pracoval s oběma nástroji. Zde je srovnání založené na této zkušenosti:
| Kritérium | Claude Code | Qwen Code |
|---|---|---|
| Kvalita kódu | Lepší — Anthropic mezitím vydal novější modely (Opus 5.5, 22.09.2026); rozdíl se nezmenšil | Dobrá, ale i nový vlajkový Qwen3.8-max zaostává za nejlepšími modely Anthropic v nezávislých testech |
| Porozumění projektu | CLAUDE.md + důkladné čtení struktury projektu = funguje jako člověk | Podobný princip, ale méně propracovaný |
| Cena | Claude Pro $20/měsíc (Max $100–200/měsíc při intenzivním programování) | Token Plan Standard od $20/měsíc, zahrnuje přes 10 modelů |
| Výběr modelů | Jen Claude (Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax |
| Open source | Ne (uzavřený zdrojový kód) | Ano (licence MIT) |
| Rozšíření VS Code | Nativní, stabilní | K dispozici, ale nedotažené — někdy má problémy s klíčem |
Kdy je Qwen Code výhodnější:
- Potřebujete přístup k několika modelům (DeepSeek na matematiku, Kimi na dlouhý kontext)
- Zkoušíte pro jeden úkol různé postupy
- Máte omezený rozpočet, ale programujete každý den
- Chcete open-source nástroj, který můžete upravovat
Kdy je Claude Code nepostradatelný:
- Kritický projekt, kde kvalita kódu znamená peníze
- Práce s rozsáhlým zastaralým projektem (Opus lépe udržuje kontext) — samostatně jsem popsal jak nepřekročit limity Claude Code
- Potřebujete stabilní rozšíření VS Code bez ručního nastavování
V popsané zkušenosti autora se osvědčila kombinace: Claude Code pro hlavní projekt, Qwen Code pro experimenty a paralelní úkoly, kde můžete rychle vyzkoušet nápad s levnějším modelem. Podrobné srovnání s dalšími nástroji najdete v srovnání Cursor a Claude Code a srovnání Codex a Claude Code.
Tři úskalí, na která narazí každý
Hlavní poznatek
Token Plan a Coding Plan jsou různé produkty s různými adresami. Rozšíření VS Code doplní nesprávný klíč. Licenci musíte přiřadit ručně. Tato tři úskalí vás mohou stát 30 minut až několik hodin — narazil jsem na všechna tři a zaznamenal jejich řešení.
Úskalí 1: Token Plan ≠ Coding Plan
Alibaba těmto produktům říká v různých částech konzole různě. Možnost „Coding Plan“ v rozšíření VS Code není Token Plan. Pamatujte: k 20.03.2026 je Coding Plan Lite uzavřený pro nové nákupy a tarif Pro je vyprodaný — pokud ho už nemáte, jedinou možností je Token Plan. Mají různé 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
Pokud jste koupili Token Plan, ale nastavili rozšíření jako Coding Plan, zobrazí se chyba 401. A platí to i naopak.
Úskalí 2: Rozšíření VS Code vygeneruje vlastní klíč
Při nastavování přes grafické rozhraní rozšíření (Cmd+Shift+P - Qwen Code: Choose Provider) rozšíření někdy prostřednictvím Alibaba Auth API vygeneruje vlastní klíč. Má jiný formát a není propojený s vaším předplatným Token Plan.
Řešení: po nastavení přes grafické rozhraní otevřete ~/.qwen/settings.json a ověřte, že klíč v env odpovídá tomu, který zobrazuje Management Platform (Overview - Plan-specific API Key). Pokud se liší, ručně ho nahraďte.
Úskalí 3: Licence Standard Seat nebyla přiřazena
Po nákupu Token Plan se na stránce My Subscriptions zobrazí Standard Seat: 0/1. To znamená, že licence byla zakoupena, ale není propojená s vaším účtem. Klíč API nebude fungovat, dokud nekliknete na Assign.
Podle autorovy zkušenosti trvalo 20 minut, než při hledání příčiny chyby 401 zaznamenal tento řádek.
Jak ověřit, že všechno funguje?
Hlavní poznatek
Dva kroky: nejprve ověřte klíč pomocí curl v terminálu (měl by vrátit 200), potom napište v Qwen Code libovolné zadání. Pokud curl funguje, ale rozšíření ne, problém je v nastavení souboru ~/.qwen/settings.json.
Krok 1. Ověřte klíč přes terminál:
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"}]}'
Pokud odpověď obsahuje text od modelu, klíč i adresa fungují.
Krok 2. Ověřte Qwen Code:
Otevřete VS Code — vestavěný terminál — a zadejte qwen. Pokud se spustí, napište:
Co je v této složce za projekt?
Qwen Code přečte strukturu a odpoví. Pokud tak učiní, nastavení je dokončeno.
Krok 3. Zkontrolujte spotřebu kreditů:
Pět minut po prvních požadavcích přejděte na Management Platform — Overview — Usage Consumption. Procento by mělo být vyšší než nula. Pokud zůstane na 0 % i po více než 10 požadavcích, používáte nesprávnou adresu (požadavky míří mimo předplatné, do tarifu s platbou podle využití, nebo nikam).
Co dál?
Hlavní poznatek
Qwen Code je nastavený — můžete začít s vibe codingem. Samotný nástroj je ale jen začátek. Rozdíl mezi „nainstaloval jsem CLI“ a „buduji produkt pomocí AI“ spočívá v metodice práce s kontextem.
Nainstalovali jste Qwen Code a funguje. Můžete otevřít libovolný projekt a začít ho budovat prostřednictvím dialogu s AI.
Další otázka zní: proč vede stejné zadání v Qwen Code v jednom projektu ke skvělému výsledku a v jiném k nesmyslům? Rozhoduje kontext. Pokud projekt obsahuje strukturu business/ s informacemi o publiku, produktech a cílech, AI pracuje jako partner. Pokud je složka prázdná, AI si vymýšlí.
Zdroje
- Qwen Code na GitHubu — zdrojový kód a dokumentace, ověřeno 03.10.2026
- Alibaba Cloud ModelStudio — konzole pro správu předplatných a klíčů
- Přehled Token Plan — aktuální tarify a stav Coding Plan, aktualizováno společností Alibaba 28.09.2026, ověřeno 03.10.2026
- Dokumentace Qwen Code: Ověřování — formáty klíčů Token Plan a Coding Plan, ověřeno 03.10.2026
Pokračujte v objevování Ailoot na ailoot.ai.
Další podrobnosti
Časté otázky
Co ověřit jako první, když klíč Token Plan vrací 401?
Ověřte, že klíč i Base URL patří k Token Plan, nikoli ke Coding Plan nebo běžnému DashScope. Klíč zkopírujte tlačítkem v konzoli a zkontrolujte přiřazení zakoupeného Standard Seat. Pak s touto konfigurací porovnejte uložené nastavení rozšíření.
Dokazuje úspěšný požadavek v terminálu správné nastavení rozšíření VS Code?
Ne. Ověřuje klíč, endpoint a model použité v daném požadavku. Samostatně vyzkoušejte zadání v Qwen Code a porovnejte uložené Base URL a klíč s funkčním požadavkem. Zkontrolujte také spotřebu v zamýšleném předplatném.