Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Konfigūruokite savo aplinką ir AGENTS.md

Paskaita 3 iš 20 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Paruoškite savo projektą „Codex“
  2. 1 žingsnis: Jūsų prieiga prie „Codex“
  3. 2 žingsnis: Įdiekite redaktoriaus plėtinį
  4. 3 žingsnis: Įdiekite CLI
  5. Failas AGENTS.md – jūsų projekto gidas
  6. Geriausios AGENTS.md praktikos
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. pagal „Codex“ dokumentaciją (Codex CLI, Autentifikavimas, Codex IDE plėtinys, Tinkintos instrukcijos su AGENTS.md): paketo @openai/codex-cli ir komandos codex auth login nėra (naudokite npm install -g @openai/codex ir codex login); plėtinio identifikatorius yra openai.chatgpt; adresas codex.openai.com ir planai „Team“, „Enterprise“ arba „API“ pakeisti dabartiniais prieigos būdais; patikslinta AGENTS.md skaitymo tvarka (projekto šaknis → dabartinis katalogas). Šaltiniai: Codex CLI · Autentifikavimas · AGENTS.md · Kainodara.

Paruoškite savo projektą „Codex“

Prieš pradėdami pirmąją užduotį, turite pasirūpinti dviem dalykais: prieiga prie „Codex“ (jūsų paskyra ir „GitHub“ ryšys) bei pačiu projektu, apibrėžtu per failą AGENTS.md, kuris nukreips agentą. Pirmoji dalis trunka apie 15 minučių ir atliekama vieną kartą. Antroji lemia visko, ką gausite iš „Codex“, kokybę ir skiria komandas, patenkintas „Codex“, nuo tų, kurios nusivilia.

1 žingsnis: Jūsų prieiga prie „Codex“

„Codex“ galite naudoti su „ChatGPT“ paskyra arba API raktu. Nemokami ir „Go“ planai, priklausomai nuo dabartinio diegimo, suteikia prieigą prie GPT-6 Luna darbalaukio programėlėje. Nuo „Plus“ plano „Codex“ available internete, CLI, redaktoriaus plėtinyje ir iOS įrenginiuose, su debesijos integracijomis, tokiomis kaip automatinis kodo peržiūra. API raktas tinka automatizavimui bendrinamose aplinkose, pvz., CI, naudojant CLI, SDK arba plėtinį, nors kai kurios funkcijos gali būti neprieinamos. Išsami informacija ir naudojimo limitai pateikti „Codex“ kainodaros puslapyje.

Norėdami dirbti debesyje su savo saugyklomis, prijunkite „GitHub“ kurdami pirmąją „Codex Cloud“ aplinką (2 pamoka). Suteikdami leidimus, laikykitės minimalumo principo: apribokite prieigą tik toms saugykloms, kurių jums iš tikrųjų reikia.

2 žingsnis: Įdiekite redaktoriaus plėtinį

„VS Code“ ir jo variantuose („Cursor“, „Windsurf“) įdiekite „Codex“ plėtinį iš rinkos – jo identifikatorius yra openai.chatgpt:

code --install-extension openai.chatgpt

Tada atidarykite „Codex“ per jo piktogramą arba per komandų paletę pasirinkę Codex: Open Codex Sidebar ir prisijunkite. „Xcode“ ir „JetBrains“ IDE turi savo integracijas: „JetBrains“ aplinkoje atidarykite AI Chat ir pasirinkite „Codex“.

3 žingsnis: Įdiekite CLI

# Diegimas (macOS ir Linux), arba npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Patikrinkite diegimą
codex --version

# Prisijunkite (naršyklėje) arba patikrinkite ryšio būseną
codex login
codex login status

codex login atidaro prisijungimo eigą jūsų naršyklėje. Norėdami naudoti API raktą, perduokite jį per standartinę įvestį (printenv OPENAI_API_KEY | codex login --with-api-key). „Codex“ prisijungimo duomenis talpina arba paprasto teksto faile ~/.codex/auth.json, arba sistemos raktinėje, priklausomai nuo cli_auth_credentials_store nustatymo (file, keyring, auto arba ephemeral). Jei naudojamas failas, elkitės su juo kaip su slaptažodžiu: jame yra prieigos raktų, todėl niekada jo neįkelkite į saugyklą. CLI ir plėtinys dalijasi šia talpykla.

Failas AGENTS.md – jūsų projekto gidas

AGENTS.md yra esminis norint efektyviai naudoti „Codex“. Tai paprastas „Markdown“ failas, patalpinamas jūsų saugyklos šaknyje, kuriame surinktos instrukcijos, susitarimai ir komandos, specifinės jūsų projektui. Kai „Codex“ klonuoja saugyklą, šį failą jis skaito pirmiausia: laikykite jį automatiniu agento įvadu, lyg žodžiu paaiškintumėte naujam komandos nariui.

Poveikis juntamas iškart. Be AGENTS.md, jei paprašysite vienetinio testo projekte, naudojančiame „Vitest“, yra didelė tikimybė, kad „Codex“ pateiks „Jest“, nes tai dažniausias pasirinkimas ekosistemoje. Vienos eilutės susitarimo pakanka, kad „Vitest“ būtų sukonfigūruotas teisingai iš pirmo karto, taip sutaupant šimtų taisymų. Štai pagrindinės SaaS sąskaitų valdymo projekto failo struktūros pavyzdys.

# AGENTS.md

## Projekto kontekstas
SaaS sąskaitų valdymo programėlė.
Technologijos: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Kodo susitarimai
- Naudoti funkcinius React komponentus (be klasių)
- Failus vadinti kebab-case formatu
- TypeScript tipus laikyti atskiruose .types.ts failuose
- Testai su Vitest, .test.ts failai šalia kodo

## Naudingos komandos
- `npm run dev` — kūrimo serveris
- `npm run test` — vykdyti testus
- `npm run lint` — tikrinti linting
- `npm run build` — gamybinė versija

## Projekto struktūra
    src/
      app/          → Next.js puslapiai (App Router)
      components/   → Pakartotinai naudojami React komponentai
      lib/          → Verslo logika ir pagalbinės priemonės
      prisma/       → DB schema ir migracijos

## Griežtos taisyklės
- NIEKADA nekeisti Prisma schemos be migracijos
- NIEKADA neįkelti .env failų
- Visada naudoti Server Actions mutacijoms

Kaip „Codex“ randa AGENTS.md failus

Vienas šakninis failas greitai tampa per daug bendras. „Codex“ leidžia sluoksniuoti instrukcijas tiksliu eiliškumu, kurį privalote žinoti:

  1. Globalus lygmuo: „Codex“ aplanke (~/.codex, nebent CODEX_HOME tai pakeičia), „Codex“ skaito AGENTS.override.md, jei jis egzistuoja, kitu atveju – AGENTS.md.
  2. Projekto lygmuo: Pradedant nuo projekto šaknies (dažniausiai „Git“ šaknies), „Codex“ leidžiasi į dabartinį katalogą ir kiekviename pereiname aplanke skaito AGENTS.override.md arba, jo nesant, AGENTS.md.
  3. Sujungimas: Failai sujungiami nuo šaknies žemyn iki dabartinio katalogo; tie, kurie yra arčiausiai dabartinio katalogo, yra pabaigoje ir todėl nustelbia bendresnes instrukcijas.
my-project/
  AGENTS.md              → Projekto instrukcijos
  src/
    api/
      AGENTS.md          → „API maršrutams naudoti Zod validacijai“

Praktinė išvada: src/api/AGENTS.md bus perskaitytas tik tada, kai „Codex“ dirbs iš src/api arba vieno iš jo pakatalogių, o ne paleidus iš šaknies. Tušti failai ignoruojami, o sujungimas sustabdomas ties 32 KiB pagal nutylėjimą (project_doc_max_bytes). Jei jūsų saugykloje jau naudojamas kitas pavadinimas, pvz., TEAM_GUIDE.md, pridėkite jį į project_doc_fallback_filenames faile ~/.codex/config.toml.

Norėdami patikrinti, ką „Codex“ iš tikrųjų įkrovė, tiesiog paklauskite: codex --ask-for-approval never "Summarize the current instructions.". „Codex“ instrukcijų grandinę atkuria kiekvieno paleidimo metu: jei abejojate, paleiskite jį iš naujo tinkamame kataloge.

Geriausios AGENTS.md praktikos

Pagrindinis principas – aiškumas. „Naudoti Vitest, o ne Jest“ yra geriau nei „Naudoti mūsų testų sistemą“, kas daro prielaidą, kad agentas turi žinių, kurių jis neturi. Visada įtraukite komandas: be jų „Codex“ nežinos, kaip vykdyti jūsų testus, linting ar kūrimą, ir pateiks kodą, kurio negalės patikrinti. Dokumentuokite struktūrą kaip katalogų medį, tai neleis jam aklai naršyti ir kurti failų netinkamose vietose.

Galiausiai, išvardykite draudimus. Taisyklės, suformuluotos kaip „NIEKADA“, yra efektyviausios faile, nes jos blokuoja brangias klaidas, kurias sunku ištaisyti: .env failo įkėlimas, schemos keitimas be migracijos. Sunkiausia disciplina – išlaikyti failą atnaujintą. AGENTS.md, aprašantis praėjusių metų projektą, aktyviai nukreipia „Codex“ link apleistų susitarimų – tai daug blogiau nei neturėti jokio failo, nes tada klaida tampa sistemine.

Svarbiausi punktai

  • Pradinis nustatymas reikalauja OpenAI paskyros ir GitHub ryšio
  • IDE plėtinys ir CLI įdiegiami per kelias minutes
  • AGENTS.md yra svarbiausias failas efektyviam „Codex“ naudojimui
  • Jame pateikiami jūsų projektui specifiniai susitarimai, komandos ir taisyklės
  • AGENTS.md failai pakatalogiuose leidžia kurti kontekstines instrukcijas