Vianmääritys: Terminaalit
Korjaa yleiset terminaaliongelmat – tyhjä tuloste, kirjoitusongelmat ja AI-agenttien häiriöt.
Terminaali avautuu, mutta kirjoittaessa ei näy mitään
Oireet: painat näppäimiä, mutta terminaaliin ei ilmesty mitään, tai terminaali avautuu tyhjänä ja pysyy sellaisena.
Mahdolliset syyt ja korjaukset:
Shellin alustustiedoston virhe. Shellisi käynnistystiedostossa (.zshrc, .bashrc tai .bash_profile) voi olla syntaksivirhe tai komento, joka jää jumiin. Avaa tavallinen Bash-terminaali 1DevToolissa ja suorita:
cat ~/.zshrc
Etsi ilmeisiä virheitä – puuttuva lopetusmerkki lainausmerkeistä, määrittelemätön muuttuja tai source-komento, joka osoittaa tiedostoon, jota ei ole olemassa. Korjaa virhe Env Managerissa tai tekstieditorissa ja avaa terminaali uudelleen.
Väärä terminaalityyppi. Jos valitsit “Claude Code” -terminaalin, mutta claude-CLI ei ole asennettu, terminaali avautuu, mutta shell ei pysty käynnistämään agenttia. Asenna Claude Code ensin (npm install -g @anthropic-ai/claude-code) tai vaihda terminaalityypiksi tavallinen Bash- tai Zsh-istunto.
Pikanollaus. Napsauta hiiren kakkospainikkeella mitä tahansa kohtaa terminaalivälilehdellä ja valitse Restart Terminal. Tämä lopettaa nykyisen shell-prosessin ja käynnistää uuden sulkematta paneelia.
AI-agentti ei reagoi syötteeseen
Oireet: kirjoitat kehotteen agenttiterminaaliin, mutta mitään ei tapahdu – ei latausindikaattoria, ei vastausta, ei kuittausta.
Yleisin syy on, että agentin käyttöliittymä on alitilassa, jossa se ei lue syötettäsi. Jos agentti esimerkiksi avasi tiedoston terminaalin sisällä tekstieditorissa, kuten vim tai nano, näppäinpainallukset menevät agentin sijaan kyseiseen editoriin.
Korjaukset:
- Paina Ctrl+C kerran tai kaksi keskeyttääksesi sen, mitä agentti on tekemässä, ja palauttaaksesi sen pääkehotteeseen. Kirjoita sitten viestisi uudelleen.
- Käytä Agent Input Overlay -näkymää suoraan terminaaliin kirjoittamisen sijaan. Avaa erillinen syöttökenttä painamalla Cmd+I (tai Ctrl+I Windowsissa/Linuxissa). Se lähettää kehotteesi agentille siististi ja ohittaa terminaalin tilaan liittyvät ongelmat.
- Jos agentti vaikuttaa täysin jumittuneelta, napsauta terminaalivälilehteä hiiren kakkospainikkeella ja valitse Restart Terminal aloittaaksesi uuden agenttiistunnon.
Vierityshistoria katkeaa agentin vastauksen jälkeen
Oireet: agentin tuotettua pitkän vastauksen vierität ylöspäin, mutta pääset vain tietyn matkan taaksepäin. Aiempi tuloste on kadonnut.
Korjaukset:
- Napsauta terminaalin otsikossa olevaa Expand scrollback -painiketta (nuolikuvake terminaalipaneelin oikeassa yläkulmassa). Tämä lataa näkymään tilapäisesti enemmän historiaa.
- Pysyvä korjaus on kasvattaa vierityshistorian rajaa: siirry kohtaan Settings → Terminal → Scrollback Lines. Oletusarvo on 10 000 riviä. Voit nostaa sen enintään 100 000:een. Huomaa, että hyvin suuret vierityspuskurit käyttävät enemmän muistia.
Vierityshistoriassa näkyy sekavaa tai päällekkäistä tekstiä
Oireet: paneelin koon muuttamisen tai terminaalin uudelleenavaamisen jälkeen vanhemmassa historiassa näkyy yhdistyneitä rivejä, ylimääräisiä merkkejä tai kahdentuneita lohkoja.
Korjaus: etsi terminaalista kullanruskea Repair view -pilleri. Se ilmestyy, kun osa historiasta on piirretty eri leveydellä kuin paneelin nykyinen leveys. Napsauta sitä, ja näkymä rakennetaan uudelleen terminaalin omista leveydeltään tarkoista riveistä.
Terminaalissa näkyy “[detached]”-viesti
Terminaalin yläreunassa saattaa näkyä rivi, kuten [detached (from session main)]. Tämä on tmuxin viesti. tmux on terminaalimultiplekseri, jota 1DevTool käyttää pitääkseen istunnot hengissä taustalla.
Se tarkoittaa, että näkymä irrotettiin hetkeksi käynnissä olevasta istunnosta ja yhdistettiin sitten uudelleen. Tämä on täysin normaalia – se tapahtuu yleensä, kun vaihdat projektia, piilotat ja avaat terminaalin uudelleen tai sovellus palautetaan pienennetystä tilasta. Istuntosi ja kaikki käynnissä olevat prosessit pysyvät ennallaan.
Piilotettu terminaali aloittaa uuden istunnon jatkamisen sijaan
Oireet: piilotat terminaalin napsauttamalla muualle tai sulkemalla paneelin, avaat sen sitten uudelleen, ja terminaali alkaa alusta – aiemmat komentosi ja käynnissä olleet prosessit ovat poissa.
Syy: 1DevTool käyttää tmuxia pitääkseen terminaali-istunnot hengissä taustalla. Jos tmuxia ei ole asennettu tai se ei ole shellisi PATH-polussa, istuntoa ei voida säilyttää, ja se käynnistyy alusta joka kerta.
Korjaus: asenna tmux ja käynnistä 1DevTool uudelleen.
- macOS:
brew install tmux - Linux (Debian/Ubuntu):
sudo apt install tmux - Linux (Fedora/RHEL):
sudo dnf install tmux
Asennuksen jälkeen sulje 1DevTool kokonaan ja käynnistä se uudelleen. Uudet terminaali-istunnot säilyvät nyt piilotettuinakin.
Terminaalien aiheuttama korkea suorittimen käyttö
Jos koneesi kuumenee tai tuulettimet pyörivät kovaa, jokin terminaaliprosessi voi kuluttaa liikaa suoritinta.
Lähteen tunnistaminen: vie hiiri jokaisen terminaalivälilehden päälle. Aktiivisella välilehdellä näkyy pyörivä ilmaisin. Voit myös avata terminaalin ja suorittaa komennon top tai htop nähdäksesi, mikä prosessi on vastuussa.
Pysäyttäminen:
- Paina terminaalissa Ctrl+C keskeyttääksesi käynnissä olevan prosessin.
- Tai napsauta terminaalivälilehteä hiiren kakkospainikkeella ja valitse Kill Process pakottaaksesi sen sisällä käynnissä olevan prosessin loppumaan.
Jos prosessi on karannut kehityspalvelin tai build-työkalu, sen voi turvallisesti lopettaa ja käynnistää uudelleen tavallisella käynnistyskomennolla.