„ollama is not recognized as an internal or external command”
Aplikacja jest zainstalowana, ale terminal jej nie znajduje
Autor Jakub Rusinowski
Błąd
'ollama' is not recognized as an internal or external command, operable program or batch file. ollama : The term 'ollama' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
| Jeśli widzisz | Przyczyną jest | Przejdź do |
|---|---|---|
| Terminal był już otwarty, gdy instalowałeś Ollamę | Działający proces zachowuje blok środowiska, z którym wystartował | Rozwiązanie 1: zamknij i otwórz terminal na nowo |
| Działa w zwykłym terminalu, ale nie w tym uruchomionym jako administrator | Podniesiona powłoka czyta PATH innego konta użytkownika | Rozwiązanie 4: przestań używać do tego powłoki administratora |
$env:Path nie zawiera wpisu Ollamy nawet w świeżym terminalu | Wpis PATH z instalatora nie trafił na miejsce albo został usunięty | Rozwiązanie 3: dodaj go ponownie w Zmiennych środowiskowych |
Katalog %LOCALAPPDATA%\Programs\Ollama nie istnieje | Instalacja się nie dokończyła albo trafiła pod własną ścieżkę /DIR | Rozwiązanie 2: znajdź, gdzie naprawdę leży plik wykonywalny |
| Potrzebujesz jej w usłudze, zadaniu zaplanowanym albo w CI | PATH użytkownika jest niewidoczny dla LocalSystem i innych kont | Rozwiązanie 5: użyj samodzielnego archiwum zip w systemowym PATH |
Kiedy się pojawia
Ikona w zasobniku jest, okno aplikacji się otwiera, modele pobierają się przez interfejs graficzny — a terminal upiera się, że takiego polecenia nie ma. Obie połowy Ollamy wcale się nie pokłóciły; twoja powłoka po prostu nie wie, gdzie leży plik wykonywalny.
- Zainstalowałeś Ollamę przy już otwartym oknie PowerShella albo cmd i w tym samym oknie wpisałeś polecenie.
- Kliknąłeś terminal prawym przyciskiem i wybrałeś „Uruchom jako administrator”, bo tak kazał poradnik.
- Zainstalowałeś przez
OllamaSetup.exe /DIR=pod własną ścieżkę, a wpis w PATH wskazuje gdzie indziej. - Próbujesz wywołać
ollamaz zadania zaplanowanego, usługi Windows albo runnera CI. - Zainstalowało ją inne konto użytkownika na tej samej maszynie.
Co się właściwie dzieje
Ollama na Windowsie instaluje się w profilu użytkownika, do katalogu domowego, bez uprawnień administratora — to świadomy wybór, dzięki któremu da się ją zainstalować na maszynach z ograniczeniami. Pliki binarne lądują w %LOCALAPPDATA%\Programs\Ollama, a instalator dopisuje ten katalog do PATH użytkownika, nie systemu. Wynikają z tego dwie konsekwencje i to one tłumaczą niemal każde zgłoszenie tego błędu. Po pierwsze, proces dziedziczy blok środowiska w chwili startu i nigdy go ponownie nie odczytuje, więc terminal otwarty w trakcie instalacji wciąż trzyma stary PATH — i będzie go trzymał, dopóki go nie zamkniesz. Po drugie, podniesiona powłoka działa w innym kontekście bezpieczeństwa, z innym PATH-em użytkownika. Dlatego „uruchom jako administrator”, odruchowe lekarstwo na większość windowsowych problemów, akurat ten pogarsza.
Jak to naprawić
- 1
Zamknij terminal i otwórz nowy
To pomaga częściej niż wszystko inne na tej stronie razem wzięte i zajmuje trzy sekundy. Zamknij każde otwarte okno terminala — łącznie z kartami w Windows Terminal, bo dzielą jeden proces hosta — po czym otwórz świeże i spróbuj ponownie. Jeśli korzystasz z wbudowanego terminala VS Code, zrestartuj sam edytor: terminal dziedziczy jego blok środowiska, a nie świeży.
# PowerShell, in the NEW window ollama --versionCzy zadziałało?Wypisze numer wersji. Jeśli tak, to koniec — nic naprawdę nie było zepsute.ollama --version - 2
Sprawdź, czy katalog Ollamy jest w twoim PATH
Jeśli świeży terminal nadal jej nie znajduje, zajrzyj do PATH wprost, zamiast zgadywać. Rozbicie go po
;czyni go czytelnym; szukasz linii kończącej się na\Programs\Ollama. Sprawdź też, czy plik wykonywalny naprawdę tam jest — przerwana instalacja potrafi zostawić wpis w PATH bez plików albo pliki bez wpisu.# PowerShell — is the directory on PATH? $env:Path -split ';' | Select-String -Pattern "Ollama" # Is the binary actually where it should be? Test-Path "$env:LOCALAPPDATA\Programs\Ollama\ollama.exe" Get-ChildItem "$env:LOCALAPPDATA\Programs\Ollama"Czy zadziałało?Test-PathzwracająceTrueznaczy, że plik istnieje i problem dotyczy wyłącznie PATH.Falseznaczy, że instalacja nie trafiła tam, gdzie się spodziewasz — zainstaluj ponownie albo zajrzyj tam, gdzie wskazałeś/DIR.Test-Path "$env:LOCALAPPDATA\Programs\Ollama\ollama.exe" - 3
Dodaj katalog z powrotem do PATH użytkownika
Jeśli plik wykonywalny istnieje, a wpisu w PATH nie ma, dodaj go z powrotem przez Ustawienia → System → Informacje → Zaawansowane ustawienia systemu → Zmienne środowiskowe, edytując Path w sekcji *Zmienne użytkownika dla {twoje konto}* — nie w sekcji systemowej. Odpowiednik w PowerShellu poniżej zapisuje tę samą wartość w zakresie użytkownika. Uwaga: samo
$env:Path = ...działa tylko na bieżące okno; utrwala je dopiero wywołanie[Environment]::SetEnvironmentVariablez zakresem"User".Uwaga: Odczytaj istniejącą wartość, zanim zapiszesz nową. Nadpisanie PATH samym katalogiem Ollamy, zamiast dopisania do niego, psuje każde inne narzędzie wiersza poleceń na tym koncie.# PowerShell — append, never overwrite $old = [Environment]::GetEnvironmentVariable("Path", "User") $dir = "$env:LOCALAPPDATA\Programs\Ollama" if ($old -notlike "*$dir*") { [Environment]::SetEnvironmentVariable("Path", "$old;$dir", "User") }Czy zadziałało?Otwórz nowy terminal — zmiana nie dociera do bieżącego — i sprawdź, czy polecenie się rozwiązuje.Get-Command ollama | Select-Object Source - 4
Nie uruchamiaj jej z terminala administratora
Tego akurat nikt nie zauważa. Podniesiona powłoka nie działa jako *ty z większymi uprawnieniami*; w wielu konfiguracjach działa na innym koncie, którego PATH użytkownika nigdy nie widział instalatora Ollamy. Polecenia brakuje więc dokładnie w tym oknie, które otworzyłeś, żeby naprawić sprawę. Ollama przy normalnym użyciu nie potrzebuje uprawnień administratora do niczego — instaluje się, działa i serwuje w całości z twojego profilu. Użyj zwykłego terminala.
# PowerShell — which account is this shell actually running as? [Security.Principal.WindowsIdentity]::GetCurrent().Name [Environment]::GetEnvironmentVariable("Path", "User") -split ';' | Select-String "Ollama"Czy zadziałało?Uruchom obie linie w zwykłym terminalu i w tym podniesionym. Różne nazwy kont albo wpis Ollamy w jednym, a brak w drugim, potwierdzają diagnozę. - 5
Do usługi, zadania zaplanowanego albo CI zainstaluj samodzielne archiwum na całą maszynę
Instalacja w profilu użytkownika jest niewidoczna dla LocalSystem i każdego innego konta, więc do pracy bez nadzoru zwyczajnie się nie nadaje. Ollama publikuje na tę okazję samodzielne archiwum:
ollama-windows-amd64.zipdla NVIDII i CPU orazollama-windows-amd64-rocm.zip, jeśli masz Radeona i chcesz backend ROCm. Rozpakuj je gdzieś na poziomie całej maszyny, na przykład doC:\Program Files\Ollama, i dodaj ten katalog do systemowego PATH. Czasem okazuje się, że osoba szukająca tego błędu pobrała po prostu archiwum niepasujące do swojego GPU — to inny problem w tym samym przebraniu.# PowerShell as Administrator — machine-wide, for services and CI only Expand-Archive .\ollama-windows-amd64.zip -DestinationPath "C:\Program Files\Ollama" $sys = [Environment]::GetEnvironmentVariable("Path", "Machine") [Environment]::SetEnvironmentVariable("Path", "$sys;C:\Program Files\Ollama", "Machine")Czy zadziałało?Z zupełnie nowego terminala, na dowolnym koncie, polecenie rozwiązuje się do kopii w Program Files.(Get-Command ollama).Source - 6
Jeśli chcesz tylko uruchomić model, użyj aplikacjiNajczęstsze rozwiązanie
Warto to powiedzieć, zanim ktoś spędzi godzinę nad PATH: aplikacja desktopowa pobiera i uruchamia modele zupełnie bez terminala. CLI ma znaczenie, gdy potrzebujesz skryptów, API albo pliku Modelfile — ale jeśli trafiłeś tu z poradnika i chcesz po prostu, żeby model odpowiadał na pytania, aplikacja w zasobniku jest kompletną drogą. Wybierz model pasujący do twojego sprzętu, a w dwie minuty będziesz gotów.
Sprawdź, co pasuje do Twojego sprzętuwybierz model dopasowany do twojej maszyny przed pierwszym pobraniemOtwórz kalkulator VRAM →
Jeśli nic z tego nie pomogło
Jeśli polecenie już się rozwiązuje, ale Ollama nie startuje albo nie serwuje, problem przesunął się poza PATH. Zaraz po udanej instalacji na Windowsie gryzą zwykle dwie rzeczy: oprogramowanie zabezpieczające wrzucające plik wykonywalny albo pliki modeli do kwarantanny oraz API nieosiągalne z miejsca, z którego je wołasz.
- SmartScreen i antywirus blokujące instalację lokalnej AI
- Ollama „connection refused” — API nieosiągalne
- Instalacja Ollama — przewodnik krok po kroku
- Wynik
Test-Path "$env:LOCALAPPDATA\Programs\Ollama\ollama.exe" - Wpis Ollamy (albo jego brak) z
$env:Path -split ';' - Czy terminal jest podniesiony i jaką nazwę konta zgłasza
- Sposób instalacji: OllamaSetup.exe, własny
/DIRalbo samodzielne archiwum zip
Powiązane
Najczęściej zadawane pytania
Gdzie Ollama instaluje się na Windowsie?
Pliki binarne trafiają do %LOCALAPPDATA%\Programs\Ollama, logi i aktualizacje do %LOCALAPPDATA%\Ollama, a modele i konfiguracja do %HOMEPATH%\.ollama. Instalacja odbywa się w profilu użytkownika i nie wymaga uprawnień administratora — dlatego dodawany wpis PATH ma zakres użytkownika.
Dlaczego „uruchom jako administrator” tylko pogarsza sprawę?
Bo podniesiona powłoka czyta PATH innego konta, a Ollama zainstalowała się na twoim. Polecenie działające w zwykłym terminalu w podniesionym naprawdę nie istnieje. Przy normalnym użyciu Ollama nie potrzebuje podniesionych uprawnień do niczego.
Czy po instalacji trzeba zrestartować komputer?
Nie. Wystarczy zamknąć i otworzyć terminal, bo proces czyta blok środowiska tylko przy starcie. Restart ma sens dopiero wtedy, gdy edytowałeś PATH, a nawet świeży terminal nie widzi zmiany — co zwykle znaczy, że wartość zapisała się w złym zakresie.
Czy mogę zainstalować Ollamę poza profilem użytkownika?
Tak. OllamaSetup.exe /DIR="d:\jakas\lokalizacja" umieszcza aplikację gdzie indziej już przy instalacji — przydaje się, gdy dysk C: jest mały, bo sam program waży kilka gigabajtów. To osobna sprawa od miejsca przechowywania modeli, którym steruje OLLAMA_MODELS.
Które samodzielne archiwum zip jest mi potrzebne?
ollama-windows-amd64.zip obsługuje NVIDIĘ i CPU. ollama-windows-amd64-rocm.zip dokłada backend AMD ROCm dla kart Radeon. Pobranie niewłaściwego daje działające polecenie, które potem ignoruje twoje GPU — co wygląda już na zupełnie inny problem.