Claude Code, Codex CLI ja OpenCode: AI-agendid Zone platvormil

Terminalipõhised AI-agendid on viimase aastaga muutunud päriselt praktilisteks tööriistadeks. Oleme Zones AI-koodimisagentide arengut huviga jälginud ning teinud ka platvormis väikseid muudatusi, et vajalikud tööriistad töötaksid meie veebimajutuse serverites võimalikult probleemivabalt.

Kuna lähenemisi ja eelistusi on erinevaid, oleme võtnud luubi alla kaks suuremat tegijat ning ühe vabavama alternatiivi. Täpsemalt oleme püüdnud platvormi arendada nõnda, et meie keskkonnas töötaksid võimalikult hästi:

• Claude Code
• Codex CLI
• OpenCode

Antud agentidel töötab kõige standardsem paigaldusvoog. Tuleb seadistada SSH ühendus ning serverisse sisse logida, seejärel paigaldada vastavalt soovitud agent.

Claude Code

npm install -g @anthropic-ai/claude-codeCode language: Bash (bash)

Codex CLI

npm install -g @openai/codexCode language: Bash (bash)

OpenCode

npm install -g opencode-aiCode language: Bash (bash)

Enamasti piisab installist ja esmasest autentimisest. Kaasaegsed CLI-agendid teevad login/auth flow üsna mugavaks ning kasutaja ei pea tavaliselt käsitsi API võtmeid või keerulisi environment muutujaid seadistama.

Mõned agendid kasutavad keskkonna isoleerimiseks bubblewrap tööriista, mille kasutamine Zone platvormi konteineripõhises keskkonnas ei ole võimalik. Seetõttu tuleb agentide õiguseid mõnevõrra lõdvendada arvestusega, et isolatsioon toimub juba virtuaalserveri tasemel.

Praktikas tähendab see, et agent pääseb ligi kogu virtuaalserveri keskkonnale. Kuna tegemist on siiski eraldatud serveriga, ei ole see tingimata probleem, kuid produktsioonikeskkonnas tuleb sellega kindlasti arvestada.

Hea nipp: tmux

Hea nipp Zone veebimajutuses on kasutada koos agendiga tmux tööriista, mis võimaldab agenti töös hoida ka siis, kui SSH ühendus katkeb või logid välja. Lisaks annab see võimaluse jätkata sama sessiooni kasutamist kasvõi teisest arvutist.

Eelis tavalise /resume käsu ees on see, et ei pea agendi tööd katkestama.

Selleks tuleks esmalt luua uus tmux sessioon:

tmux new -s aiCode language: Bash (bash)

Seejärel käivitada soovitud agent:

codexCode language: Bash (bash)

Kui agent töötab millegi kallal, saab tmux sessioonist lahti ühendada järgmise kombinatsiooniga:

Ctrl+B DCode language: Bash (bash)

NB! tmux kasutab nn “prefix key” süsteemi. See tähendab, et esmalt tuleb vajutada Ctrl+B, klahvid vabastada ning alles seejärel vajutada D.

Sessioon jääb serveris tööle ka pärast SSH ühenduse katkestamist.

Hiljem saab samasse sessiooni tagasi siseneda:

tmux attach -t aiCode language: Bash (bash)

Sessiooni loomisel kasutatud nimi ai võib olla vabalt valitud ning võimaldab kasutada ka mitut paralleelset sessiooni.

SSH + tmux + AI-agent loob mugava “remote-first” arendusworkflow.

Serverikeskkonna eelised

Virtuaalserveri keskkonna üheks suureks eeliseks on ligipääs logifailidele. Näiteks saab AI-agendile ette öelda, et probleemide tuvastamiseks loeks PHP või access logi faile.

Näiteks:

tail -10 ~/domeenid/*/logs/apache.ssl.access.log
tail -10 ~/domeenid/*/logs/php.logCode language: Bash (bash)

Samuti saab agendile öelda, et veebile on võimalik teha päringuid käsureatööriistaga curl, mille järel kontrollida logisid ning nende abil probleeme lahendada.

Näiteks:

curl https://example.eeCode language: Bash (bash)

või:

curl -I https://example.eeCode language: Bash (bash)

See võimaldab agendil:

• kontrollida HTTP staatuseid
• testida API endpoint’e
• võrrelda vastuseid logidega
• aidata debugimisel

Sarnaselt eelnevaga on agendil võimalik kasutada ka andmebaasi käsureatööriistu nagu mariadb, agendile anda ligipääsuks vajalikud andmed.

Kõige eelnevaga peab siiski arvestama, et ligipääsud produktsioonikeskkonnas ei ole alati kõige targem mõte. Arenduskeskkonnas, kus reaalseid andmeid ei ole, võib see aga olla väga mugav ja praktiline viis töö tegemiseks.

Kokkuvõtteks

Kindlasti tasub luua workflow, mis käivitab agente vaid eraldiseisvas arenduseks mõeldud virtuaalserveris, et mõne agendi vea tõttu ei lekiks andmeid või ligipääse.

Virtuaalserveris agendi käivitamise boonused:

• Rakenduse arendus toimub juba tuttavas Zone keskkonnas, kus agent näeb eelnevalt sarnast serveri ülesehitust ja võimalusi
• Agent pääseb ligi logidele
• Saab kasutada serveris juba olemasolevaid CLI tööriistu (curl, git, mariadb, npm, composer jne) ilma neid oma arvutisse paigaldamata
• Agent saab teha HTTP päringuid ja kontrollida kohe muudatuste mõju
• Kuna agent töötab virtuaalserveris, siis ei pea sellele tingimata andma ligipääsu sinu igapäevases arvutis olevatele andmetele või autentimistele

Kui workflow on läbimõeldud, siis võib AI-agent olla väga praktiline abiline nii arenduses kui ka serverihalduses.