Jak uruchomić Qwen Code w terminalu i skonfigurować tryb edycji

Pytanie brzmi mniej więcej tak: jak sprawić, żeby Qwen działał poprawnie w konsoli i samodzielnie pisał kod? Zwykle kryje się za nim rozczarowanie: ktoś zainstalował Qwen Code, zadał pytanie, a w odpowiedzi dostał tekst i fragment kodu, który musiał ręcznie skopiować — mimo że obiecano mu agenta, który wejdzie do projektu i sam wszystko zrobi.

Właśnie tym jest Qwen Code: pełnoprawnym agentem. Potrafi samodzielnie otwierać i edytować pliki oraz uruchamiać polecenia. Zachowanie zależy od aktywnego trybu zatwierdzania: Ask Permissions prosi o zgodę, a Auto-Edit i Auto pozwalają na większą samodzielność. Sprawdź wiersz statusu zamiast zakładać, że tryb o nazwie Default jest wyborem po instalacji. Poniżej, po kolei: instalacja, uruchomienie w projekcie, podłączenie modelu po kwietniowych zmianach oraz przełączenie na tryb, w którym agent edytuje kod bez zadawania zbędnych pytań. Wszystkie informacje sprawdzono na podstawie oficjalnej dokumentacji Qwen z 30 sierpnia 2026 roku.

Praktyczne materiały o modelach i agentach: dokumentacja Ailoot.

Co oznacza „Qwen Code sam pisze kod”?#

Różnica jest prosta. Czat w przeglądarce odpowiada tekstem na pytanie. Czytasz odpowiedź, kopiujesz kod, wklejasz go do pliku, samodzielnie go uruchamiasz, sam znajdujesz błędy i wracasz z nimi do czatu. To ty przenosisz informacje między czatem a projektem.

Agent działa inaczej. W zwykłym języku zlecasz mu zadanie: „dodaj formularz opinii”, „napraw ten błąd”. Następnie analizuje strukturę projektu, znajduje odpowiednie pliki, wprowadza zmiany i uruchamia kontrolę. Dokumentacja ujmuje to jasno: agent tworzy plan, pisze kod i upewnia się, że działa.

Stąd bierze się nieporozumienie zawarte w pytaniu. „Qwen sam nie pisze kodu” prawie zawsze oznacza jedno z dwóch: dana osoba ma otwarty czat w przeglądarce zamiast agenta terminalowego albo agent działa w trybie, który wymaga zgody na każdą edycję. Pierwszy problem rozwiązuje instalacja Qwen Code, a drugi — przełączenie trybu. Poniżej omawiamy oba rozwiązania.

Jak zainstalować Qwen Code w terminalu?#

Najszybsza metoda to oficjalny instalator, który automatycznie wybiera wersję odpowiednią dla twojego systemu.

W systemie macOS lub Linux otwórz terminal i wklej jedną linię:

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

W systemie Windows użyj tego polecenia PowerShell:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

Druga opcja to npm, jeśli jest już zainstalowany. Wymaga Node.js w wersji 22 lub nowszej:

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

Po instalacji uruchom ponownie terminal. Instalator dodaje polecenie qwen do ścieżek systemowych, ale terminal rozpozna je dopiero po ponownym uruchomieniu — to najczęstsza przyczyna komunikatu „zainstalowałem, ale nie znajduje polecenia”. Aby sprawdzić, czy instalacja się powiodła, uruchom:

qwen --version

Jeśli zobaczysz numer wersji, agent jest zainstalowany i gotowy do uruchomienia w projekcie.

Jak uruchomić Qwen Code w swoim projekcie?#

Najpierw przejdź do folderu z kodem. To ważne: agent pracuje w folderze, z którego został uruchomiony, i widzi tylko jego zawartość.

cd path-to-your-project
qwen

Interfejs agenta otworzy się bezpośrednio w terminalu. Przy pierwszym uruchomieniu agent zaproponuje podłączenie modelu; opisujemy to w następnej sekcji. Po podłączeniu modelu możesz zlecić agentowi zadanie zwykłym językiem, aby sprawdzić, do czego ma dostęp:

Co robi ten projekt?

Agent przeczyta pliki, zrozumie strukturę i udzieli przydatnej odpowiedzi. Potem możesz poprosić go o napisanie lub edycję kodu: „dodaj przycisk wylogowania”, „podziel ten plik na dwa”, „sprawdź, dlaczego test nie przechodzi”. Agent znajdzie odpowiednie miejsca i sam wprowadzi zmiany.

Można go też uruchomić na drugi sposób — jednym poleceniem, bez interfejsu. Przydaje się to w skryptach i zadaniach automatycznych:

qwen -p "ponownie przeczytaj README i zaktualizuj listę poleceń"

Agent wykona zadanie i zakończy działanie, bez rozmowy. Na początek nie musisz z tego korzystać, ale warto o tym pamiętać na przyszłość.

Dlaczego agent działa, ale nie wykonuje niczego samodzielnie?#

Pierwszą przeszkodą jest dostęp do modelu. Dawniej Qwen Code zapewniał bezpłatny dostęp: wystarczyło zalogować się kontem qwen.ai, a agent działał bez karty płatniczej. Ten dostęp nazywał się Qwen OAuth i został wycofany. Dokumentacja uwierzytelniania mówi wprost: bezpłatny poziom Qwen OAuth zakończył się 15 kwietnia 2026 roku; wcześniej zapisane logowania mogą jeszcze przez krótki czas działać, ale serwer odrzuca nowe żądania. Opcję „zaloguj przez qwen.ai” również usunięto z menu.

Aby agent mógł w ogóle zacząć analizować zadanie, trzeba więc podłączyć model. Następna sekcja opisuje dostępne metody — płatne i bezpłatne, lokalne.

Drugi powód jest mniej widoczny i bardziej frustrujący. Model jest podłączony, agent odpowiada, ale nie edytuje plików — tylko pokazuje, co planuje zrobić, i czeka. To oczekiwane zachowanie trybu Ask Permissions, który pyta przed edycjami i poleceniami; nie dowodzi uniwersalnego trybu startowego. Aby agent pracował samodzielnie, trzeba zmienić tryb. Opisujemy to dwie sekcje dalej, gdzie znajdziesz odpowiedź na początkowe pytanie.

Jak podłączyć model po zamknięciu bezpłatnego dostępu?#

W agencie wpisz polecenie:

/auth

Otworzy się menu z trzema głównymi opcjami. Oto, do czego służy każda z nich.

Alibaba ModelStudio to oficjalna opcja od twórców Qwen. Oferuje Coding Plan ze stałą ceną i tygodniowym limitem dla indywidualnych programistów, Token Plan z rozliczeniem według zużycia dla zespołów oraz możliwość podłączenia istniejącego klucza ModelStudio. To płatny dostęp do „natywnego” modelu Qwen.

Dostawcy zewnętrzni pozwalają wybrać wbudowanego dostawcę i podłączyć go za pomocą klucza. Oficjalna lista obejmuje DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope i innych. Pobierz klucz od dostawcy i wpisz go, a agent będzie korzystać z jego modelu.

Custom Provider pozwala podłączyć własny serwer, proxy lub lokalny silnik. Właśnie tę opcję wybierz, aby podłączyć model działający na twoim komputerze przez Ollama. Obsługuje formaty OpenAI, Anthropic i Gemini, dlatego współpracuje niemal z każdą metodą dostępu.

Możesz też ręcznie wpisać klucz i ustawienia w pliku ~/.qwen/settings.json. Zawiera on pole modelProviders (dostępne modele), env (same klucze), security.auth.selectedType (protokół, który ma być włączony podczas uruchamiania) oraz model.name (model domyślny). Następnie qwen uruchomi się z tymi ustawieniami i o nic nie zapyta. Przy pierwszym uruchomieniu łatwiej skorzystać z /auth; do pliku możesz wrócić, gdy zechcesz zapisać wszystkie ustawienia.

Informacje o tym, co pozostało bezpłatne po kwietniu, znajdziesz w artykule o bezpłatnym Qwen Code.

Który tryb włączyć, aby agent samodzielnie edytował kod?#

Najważniejsza zasada jest taka: tryb dostępu określa, jak samodzielnie działa agent. Dostępnych jest pięć trybów, od najbardziej ostrożnego do najbardziej liberalnego.

Jeśli agent tylko pokazuje zmiany i czeka, prawdopodobnie działa w trybie Ask Permissions (w starszych wersjach nazywanym Default). Musisz wtedy ręcznie potwierdzać każdą edycję i każde polecenie, przez co może się wydawać, że agent niczego nie robi samodzielnie.

Aby agent edytował pliki bez pytania, przełącz go na Auto-Edit. Edycje będą wykonywane automatycznie, ale przed uruchomieniem poleceń agent nadal będzie pytać. To rozsądne zabezpieczenie przed przypadkowym uruchomieniem rm w niewłaściwym miejscu.

Auto korzysta z wewnętrznego modułu do czynności wymagających oceny. Wybierz go świadomie po sprawdzeniu wersji i aktywnego statusu; słowo default zachowane w konfiguracji Ask Permissions jest nazwą zgodności, nie dowodem trybu startowego.

YOLO to tryb z najmniejszymi ograniczeniami. Agent sam edytuje pliki i uruchamia polecenia, o nic nie pytając. Dokumentacja zaleca go wyłącznie do zaufanych, prywatnych projektów i zautomatyzowanych przepływów pracy. W projekcie służbowym łatwo o niepożądane skutki, dlatego włączaj go tylko z pełną świadomością, najlepiej pracując na kopii.

Jak przełączać tryby podczas sesji?#

Tryb możesz zmienić w dowolnym momencie, także w trakcie zadania. Naciśnij Shift+Tab, aby przejść do następnego trybu. W Windows to samo robi zwykły klawisz Tab. Kolejność jest następująca: Plan, potwierdzenia, automatyczne edycje, Auto, YOLO i z powrotem Plan.

Aktualny tryb jest zawsze widoczny na pasku stanu u dołu interfejsu. Przyzwyczaj się do sprawdzania go przed zleceniem agentowi dużego zadania, aby nie uruchomić YOLO, gdy chcesz tylko zobaczyć plan.

Przyjazny dla początkujących sposób pracy składa się z trzech kroków:

1. Uruchom agenta w trybie Plan i poproś o analizę zadania oraz propozycję planu. Agent niczego nie zmieni — przeczyta kod i opisze, co zamierza zrobić.
2. Przeczytaj plan. Jeśli się zgadzasz, naciśnij Shift+Tab, aby przełączyć na Auto-Edit lub Auto.
3. Powiedz agentowi, żeby kontynuował. Teraz będzie samodzielnie edytować pliki, a ty możesz obserwować wyniki.

Takie podejście usuwa największą obawę początkujących — że agent od razu wszystko zepsuje. Najpierw sprawdzasz plan w bezpiecznym trybie, a dopiero potem pozwalasz mu działać.

Model lokalny bez karty#

Zainstaluj otwarty model na komputerze przez Ollama lub vLLM, a następnie podłącz go jako Custom Provider z menu /auth. Od tej chwili agent korzysta z modelu działającego na twoim komputerze, a nie z chmury Alibaba. Nie potrzeba karty ani kluczy, nie ma też limitu żądań. Informacje o otwartych modelach, które potrafią programować, znajdziesz w przeglądzie bezpłatnych modeli do kodowania.

Wadą są wymagania sprzętowe. Model, który potrafi sensownie pisać kod, potrzebuje dużo pamięci wideo. Da się z niego korzystać na komputerze gamingowym z wydajną kartą graficzną, ale na zwykłym laptopie model może się nie zmieścić albo każda odpowiedź może powstawać tak długo, że lepiej poszukać innego rozwiązania.

Kolejną zaletą uruchamiania lokalnego jest prywatność danych. Cały kod zostaje na twoim komputerze i nic nie trafia na serwer innej firmy. W przypadku wrażliwego projektu ma to większe znaczenie niż oszczędność na subskrypcji.

Jak nie dopuścić do tego, by agent zepsuł projekt?#

Samodzielny agent jest wygodny, dopóki robi to, czego oczekujesz. Aby potknięcie nie naraziło cię na straty, stosuj trzy nawyki.

Po pierwsze, używaj git. Jeśli projekt jest objęty kontrolą wersji, możesz zobaczyć każdą zmianę agenta i cofnąć dowolną z nich. Samodzielny agent bez git naprawdę stwarza ryzyko: coś zmieni, a ty nie będziesz mieć jak przywrócić poprzedniej wersji. Z git przywrócenie zmian wymaga jednego krótkiego polecenia.

Po drugie, zaczynaj w trybie Plan. Zanim powierzysz agentowi duże zadanie, poproś go o przygotowanie planu w trybie, w którym niczego nie zmieni. Przeczytaj plan i zrozum, co agent zamierza zrobić, a dopiero potem przełącz na edycję.

Po trzecie, uważaj z YOLO. W tym trybie agent sam uruchamia polecenia, również te usuwające pliki. To zbyt duża swoboda w projekcie służbowym. Używaj YOLO przy kopiach roboczych i małych zadaniach, w których ewentualny błąd nie będzie miał znaczenia.

Te trzy nawyki pomagają przezwyciężyć główną obawę: „programowałem przez vibe coding i wszystko zepsułem”. Więcej o cofaniu zmian w vibe codingu znajdziesz w osobnym przeglądzie. Dotyczy Claude Code, ale zasada korzystania z git jest dokładnie taka sama.

Od czego zacząć w swoim zadaniu?#

Oto cały proces w skrócie. Wykonuj kroki po kolei:

1. Zainstaluj Qwen Code jednym poleceniem i uruchom ponownie terminal.
2. Przejdź do folderu projektu przez cd i uruchom qwen.
3. Podłącz model przez /auth: wybierz płatny plan albo model lokalny przez Ollama, jeśli nie możesz płacić kartą.
4. Zleć agentowi zadanie w trybie Plan i przeczytaj jego plan.
5. Naciśnij Shift+Tab, aby przełączyć na Auto-Edit lub Auto, i pozwól mu działać.
6. Zarządzaj projektem w git, aby móc cofnąć każdą zmianę.

Krótko mówiąc, „Qwen sam nie pisze kodu” prawie zawsze oznacza, że model nie jest podłączony albo agent działa w trybie wymagającym potwierdzeń. Pierwszy problem rozwiąż w menu /auth, a drugi — naciskając Shift+Tab, aż przełączysz na Auto-Edit. Potem agent naprawdę będzie samodzielnie pracował w terminalu.

Jeśli chcesz porównać Qwen z innymi agentami pod kątem swojego zadania, zobacz przegląd alternatyw dla Claude Code. Qwen jest tam zestawiony z pozostałymi narzędziami, dzięki czemu możesz sprawdzić, które najlepiej pasuje do konkretnego zastosowania.

Praktyczne materiały: dokumentacja Ailoot.

Więcej materiałów i narzędzi: Ailoot.