Postavi svoje okruženje i AGENTS.md
Na ovoj stranici
Ažurirano 3. studenoga 2026. na temelju Codex dokumentacije (Codex CLI, Autentifikacija, Codex IDE proširenje, Prilagođene upute s AGENTS.md): paket
@openai/codex-clii naredbacodex auth loginne postoje (koristinpm install -g @openai/codexicodex login); identifikator proširenja jeopenai.chatgpt; adresa codex.openai.com i planovi “Team, Enterprise ili API” zamijenjeni su trenutnim metodama pristupa; a redoslijed čitanja AGENTS.md je pojašnjen (korijen projekta → trenutni direktorij). Izvori: Codex CLI · Autentifikacija · AGENTS.md · Cjenik.
Pripremi svoj projekt za Codex
Prije prvog zadatka dvije stvari moraju biti spremne: tvoj Codex pristup—tvoj račun i povezanost s GitHubom—i tvoj sam projekt, definiran kroz datoteku AGENTS.md koja će voditi agenta. Prvi dio traje oko 15 minuta i radi se jednokratno. Drugi dio određuje kvalitetu svega što dobiješ od Codexa, razdvajajući timove koji su zadovoljni Codexom od onih koji ga smatraju razočaranjem.
Korak 1: Tvoj Codex pristup
Codex možeš koristiti s ChatGPT računom ili API ključem. Besplatni (Free) i Go planovi omogućuju pristup, ovisno o trenutnoj implementaciji, modelu GPT-6 Luna u desktop aplikaciji. Počevši od Plus plana, Codex je dostupan na webu, u CLI-u, u proširenju za uređivač i na iOS-u, uz integracije s oblakom poput automatiziranog pregleda koda. API ključ funkcionira za automatizaciju u dijeljenim okruženjima poput CI-a, koristeći CLI, SDK ili proširenje—iako neke značajke možda neće biti dostupne. Detalji i ograničenja korištenja nalaze se na stranici s cjenikom za Codex.
Za rad u oblaku na tvojim repozitorijima, poveži GitHub kada stvoriš svoje prvo Codex Cloud okruženje (Lekcija 2). Prilikom dodjele dopuštenja, zadrži ih na minimumu: ograniči pristup samo na repozitorije koji su ti stvarno potrebni.
Korak 2: Instaliraj proširenje za uređivač
U VS Code-u i njegovim derivatima (Cursor, Windsurf), instaliraj Codex proširenje iz trgovine—njegov identifikator je openai.chatgpt:
code --install-extension openai.chatgpt
Zatim otvori Codex putem njegove ikone ili kroz paletu naredbi s Codex: Open Codex Sidebar i prijavi se. Xcode i JetBrains IDE-ovi imaju vlastite integracije: u JetBrainsu otvori AI Chat i odaberi Codex.
Korak 3: Instaliraj CLI
# Instalacija (macOS i Linux), ili npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Provjera instalacije
codex --version
# Prijava (preglednik) ili provjera statusa veze
codex login
codex login status
codex login otvara tijek prijave u tvom pregledniku. Za API ključ, proslijedi ga putem standardnog ulaza (printenv OPENAI_API_KEY | codex login --with-api-key). Codex predmemorira vjerodajnice ili u tekstualnu datoteku ~/.codex/auth.json ili u sustavski privjesak za ključeve (keychain), ovisno o postavci cli_auth_credentials_store (file, keyring, auto ili ephemeral). Ako se koristi datoteka, tretiraj je kao lozinku: sadrži pristupne tokena, stoga je nikada nemoj commitati. CLI i proširenje dijele ovu predmemoriju.
Datoteka AGENTS.md—tvoj vodič kroz projekt
AGENTS.md je središnji element za učinkovito korištenje Codexa. To je jednostavna Markdown datoteka smještena u korijenu tvog repozitorija koja okuplja upute, konvencije i naredbe specifične za tvoj projekt. Kada Codex klonira repozitorij, prvo čita ovu datoteku: zamisli to kao automatsko uvođenje agenta, točno onako kako bi usmeno objasnio novom članu tima.
Utjecaj je trenutan. Bez AGENTS.md-a, ako zatražiš jedinični test za projekt koji koristi Vitest, velika je vjerojatnost da će ti Codex dati Jest, jer je to najčešći izbor u ekosustavu. Jedan redak konvencije dovoljan je da Vitest bude ispravan iz prvog pokušaja, štedeći te ispravljanja iste greške stotinu puta. Evo strukture osnovne datoteke za SaaS projekt upravljanja računima.
# AGENTS.md
## Kontekst projekta
SaaS aplikacija za upravljanje računima.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.
## Konvencije koda
- Koristi React funkcionalne komponente (bez klasa)
- Imenuj datoteke u kebab-caseu
- TypeScript tipovi u odvojenim .types.ts datotekama
- Testovi s Vitestom, .test.ts datoteke uz kod
## Korisne naredbe
- `npm run dev` — razvojni poslužitelj
- `npm run test` — pokreni testove
- `npm run lint` — provjeri linting
- `npm run build` — produkcijska gradnja
## Struktura projekta
src/
app/ → Next.js stranice (App Router)
components/ → Ponovno upotrebljive React komponente
lib/ → Poslovna logika i uslužni programi
prisma/ → DB shema i migracije
## Stroga pravila
- NIKADA ne mijenjaj Prisma shemu bez migracije
- NIKADA ne commitaj .env datoteke
- Uvijek koristi Server Actions za mutacije
Kako Codex pronalazi AGENTS.md datoteke
Jedna datoteka u korijenu brzo postane preopćenita. Codex ti omogućuje slaganje uputa preciznim redoslijedom koji moraš znati:
- Globalna razina: U tvojoj Codex mapi (
~/.codex, osim akoCODEX_HOMEto ne nadjača), Codex čitaAGENTS.override.mdako postoji, inačeAGENTS.md. - Razina projekta: Počevši od korijena projekta (obično Git korijen), Codex silazi do trenutnog direktorija i čita, u svakoj mapi kroz koju prolazi,
AGENTS.override.mdili, ako toga nema,AGENTS.md. - Spajanje: Datoteke se konkateniraju od korijena prema dolje do trenutnog direktorija; one najbliže trenutnom direktoriju dolaze zadnje i stoga nadjačavaju općenitije upute.
my-project/
AGENTS.md → Upute za projekt
src/
api/
AGENTS.md → "API rute koriste Zod za validaciju"
Praktična posljedica: src/api/AGENTS.md se čita samo ako Codex radi iz src/api ili jednog od njegovih poddirektorija, a ne kada je pokrenut iz korijena. Prazne datoteke se ignoriraju, a konkatenacija se zaustavlja na 32 KiB prema zadanim postavkama (project_doc_max_bytes). Ako tvoj repozitorij već koristi drugo ime, poput TEAM_GUIDE.md, dodaj ga u project_doc_fallback_filenames u ~/.codex/config.toml.
Da provjeriš što je Codex stvarno učitao, jednostavno pitaj: codex --ask-for-approval never "Summarize the current instructions.". Codex ponovno gradi lanac uputa pri svakom pokretanju: ako sumnjaš, ponovno ga pokreni u ispravnom direktoriju.
Najbolje prakse za AGENTS.md
Vodeće načelo je eksplicitnost. „Koristi Vitest, a ne Jest“ bolje je od „Koristi naš testni okvir“, što podrazumijeva znanje koje agent nema. Uvijek uključi naredbe: bez njih Codex neće znati kako pokrenuti tvoje testove, linter ili gradnju, i isporučit će kod koji nije mogao verificirati. Dokumentiraj strukturu kao stablo direktorija, što sprječava slijepo istraživanje i stvaranje datoteka na pogrešnom mjestu.
Na kraju, navedi zabrane. Pravila napisana kao „NIKADA“ najisplativija su u datoteci jer blokiraju skupe greške koje je teško popraviti: commitanje .env datoteke, modificiranje sheme bez migracije. Najteža disciplina je održavanje datoteke ažurnom. AGENTS.md koji opisuje prošlogodišnji projekt aktivno usmjerava Codex prema napuštenim konvencijama—što je daleko gore od nepostojanja datoteke, jer tada greška postaje sustavna.
Ključne točke
- Početno postavljanje zahtijeva OpenAI račun i povezanost s GitHubom
- IDE proširenje i CLI instaliraju se u nekoliko minuta
- AGENTS.md je najvažnija datoteka za učinkovito korištenje Codexa
- Sadrži konvencije, naredbe i pravila specifična za tvoj projekt
- AGENTS.md datoteke u poddirektorijima omogućuju kontekstualne upute