Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Konfigurē savu vidi un AGENTS.md

Nodarbība 3 no 20 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Sagatavo savu projektu Codex
  2. 1. solis: Tava Codex piekļuve
  3. 2. solis: Instalē redaktora paplašinājumu
  4. 3. solis: Instalē CLI
  5. Fails AGENTS.md — tava projekta ceļvedis
  6. Labākā prakse priekš AGENTS.md
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Codex dokumentāciju (Codex CLI, Autentifikācija, Codex IDE paplašinājums, Pielāgotas instrukcijas ar AGENTS.md): pakotne @openai/codex-cli un komanda codex auth login nepastāv (izmanto npm install -g @openai/codex un codex login); paplašinājuma identifikators ir openai.chatgpt; adrese codex.openai.com un plāni “Team, Enterprise vai API” ir aizstāti ar pašreizējām piekļuves metodēm; un AGENTS.md lasīšanas secība ir precizēta (projekta sakne → pašreizējā direktorija). Avoti: Codex CLI · Autentifikācija · AGENTS.md · Cenas.

Sagatavo savu projektu Codex

Pirms pirmā uzdevuma ir jābūt divām lietām: tavai Codex piekļuvei (tavs konts un GitHub savienojums) un pašam projektam, kas definēts caur failu AGENTS.md, kurš vadīs aģentu. Pirmā daļa aizņem aptuveni 15 minūtes un ir vienreizēja konfigurācija. Otrā daļa nosaka visu rezultātu kvalitāti, ko iegūsi no Codex, atdalot komandas, kas ir apmierinātas ar Codex, no tām, kurām tas šķiet vīlušies.

1. solis: Tava Codex piekļuve

Tu vari lietot Codex ar ChatGPT kontu vai API atslēgu. Bezmaksas un Go plāni nodrošina piekļuvi, atkarībā no pašreizējās izvietošanas, modelim GPT-6 Luna darbvirsmas lietotnē. Sākot ar Plus plānu, Codex ir pieejams tīmeklī, CLI, redaktora paplašinājumā un iOS, ar mākoņa integrācijām, piemēram, automatizētu koda pārskatīšanu. API atslēga darbojas automatizācijai koplietotās vidēs, piemēram, CI, izmantojot CLI, SDK vai paplašinājumu, lai gan dažas funkcijas var nebūt pieejamas. Detaļas un lietošanas limiti ir atrodami Codex cenu lapā.

Lai strādātu mākonī ar saviem repozitorijiem, pieslēdz GitHub, kad izveido savu pirmo Codex Cloud vidi (2. nodarbība). Piešķirot atļaujas, uzturi tās minimālas: ierobežo piekļuvi tikai tiem repozitorijiem, kas tev patiešām ir nepieciešami.

2. solis: Instalē redaktora paplašinājumu

VS Code un tā atvasinājumos (Cursor, Windsurf) instalē Codex paplašinājumu no tirgus laukuma — tā identifikators ir openai.chatgpt:

code --install-extension openai.chatgpt

Tad atver Codex, izmantojot tā ikonu vai caur komandu paleti ar Codex: Open Codex Sidebar, un piesakies. Xcode un JetBrains IDE ir savas integrācijas: JetBrains vidē atver AI Chat un izvēlies Codex.

3. solis: Instalē CLI

# Instalācija (macOS un Linux), vai npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Pārbaudi instalāciju
codex --version

# Piesakies (pārlūkā), vai pārbaudi savienojuma statusu
codex login
codex login status

codex login atver pieteikšanās plūsmu tavā pārlūkā. API atslēgas gadījumā nodod to caur standarta ievadi (printenv OPENAI_API_KEY | codex login --with-api-key). Codex saglabā akreditācijas datus vai nu skaidrteksta failā ~/.codex/auth.json, vai sistēmas atslēgu saišķī (keychain), atkarībā no iestatījuma cli_auth_credentials_store (file, keyring, auto vai ephemeral). Ja tiek lietots fails, izturies pret to kā ar paroli: tas satur piekļuves pilnvaras, tāpēc nekad to neiekļauj repozitorijā. CLI un paplašinājums koplieto šo kešatmiņu.

Fails AGENTS.md — tava projekta ceļvedis

AGENTS.md ir centrālais elements, lai efektīvi izmantotu Codex. Tas ir vienkāršs Markdown fails, kas novietots repozitorija saknē un apkopo instrukcijas, konvencijas un komandas, kas specifiskas tavam projektam. Kad Codex klonē repozitoriju, tas vispirms nolasa šo failu: domā par to kā par automātisku ievadīšanu aģentam, tieši tā, kā tu mutiski izskaidrotu jaunam komandas biedram.

Ietekme ir tūlītēja. Bez AGENTS.md, ja lūgsi izveidot vienības testu projektam, kas izmanto Vitest, ir liela varbūtība, ka Codex piedāvās Jest, jo tas ir visizplatītākais variants ekosistēmā. Viena konvencijas rindiņa ir pietiekama, lai Vitest tiktu iestatīts pareizi jau pirmajā reizē, ietaupot tevi no šīs pašas kļūdas labošanas simtiem reižu. Lūk, pamata faila struktūra SaaS rēķinu pārvaldības projektam.

# AGENTS.md

## Projekta konteksts
SaaS rēķinu pārvaldības lietotne.
Steks: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Koda konvencijas
- Izmanto React funkcionālos komponentus (bez klasēm)
- Nosauc failus kebab-case formātā
- TypeScript tipi atsevišķos .types.ts failos
- Testi ar Vitest, .test.ts faili blakus kodam

## Noderīgas komandas
- `npm run dev` — izstrādes serveris
- `npm run test` — palaist testus
- `npm run lint` — pārbaudīt lintingu
- `npm run build` — ražošanas būve

## Projekta struktūra
    src/
      app/          → Next.js lapas (App Router)
      components/   → Atkārtoti izmantojami React komponenti
      lib/          → Biznesa loģika un utilīti
      prisma/       → DB shēma un migrācijas

## Stingri noteikumi
- NEKAD nemaini Prisma shēmu bez migrācijas
- NEKAD neiekļauj .env failus repozitorijā
- Vienmēr izmanto Server Actions mutācijām

Kā Codex atrod AGENTS.md failus

Viens faila saknē ātri kļūst pārāk vispārīgs. Codex ļauj slāņot instrukcijas precīzā secībā, kas tev ir jāzina:

  1. Globālais līmenis: Tavā Codex mapē (~/.codex, ja vien CODEX_HOME to nepārraksta), Codex nolasa AGENTS.override.md, ja tas eksistē, pretējā gadījumā AGENTS.md.
  2. Projekta līmenis: Sākot no projekta saknes (parasti Git sakne), Codex virzās uz leju līdz pašreizējai direktorijai un nolasa katrā šķērsotajā mapē AGENTS.override.md vai, ja tāda nav, AGENTS.md.
  3. Apvienošana: Faili tiek sakārtoti virknē no saknes uz leju līdz pašreizējai direktorijai; tie, kas atrodas vistuvāk pašreizējai direktorijai, ir beigās un tāpēc pārraksta vispārīgākas instrukcijas.
my-project/
  AGENTS.md              → Projekta instrukcijas
  src/
    api/
      AGENTS.md          → "API maršruti validācijai izmanto Zod"

Praktiskas sekas: src/api/AGENTS.md tiek nolasīts tikai tad, ja Codex strādā no src/api vai kādas no tās apakšdirektorijām, nevis kad tas palaists no saknes. Tukši faili tiek ignorēti, un sakārtošana apstājas pie 32 KiB pēc noklusējuma (project_doc_max_bytes). Ja tavs repozitorijs jau izmanto citu nosaukumu, piemēram, TEAM_GUIDE.md, pievieno to project_doc_fallback_filenames failā ~/.codex/config.toml.

Lai pārbaudītu, ko Codex patiesībā ir ielādējis, vienkārši jautā: codex --ask-for-approval never "Summarize the current instructions.". Codex pārbūvē instrukciju ķēdi katrā palaišanas reizē: ja rodas šaubas, restartē to pareizajā direktorijā.

Labākā prakse priekš AGENTS.md

Vadošais princips ir skaidrība. “Izmanto Vitest, nevis Jest” ir labāk nekā “Izmanto mūsu testēšanas ietvaru”, kas pieņem zināšanas, kas aģentam nav. Vienmēr iekļauj komandas: bez tām Codex nezinās, kā palaist tavus testus, linteri vai būvi, un tas piegādās kodu, ko nevarēja pārbaudīt. Dokumentē struktūru kā direktoriju koku, kas novērš aklu izpēti un failu izveidi nepareizās vietās.

Visbeidzot, uzskaiti aizliegumus. Noteikumi, kas rakstīti kā “NEKAD”, ir visizdevīgākie failā, jo tie bloķē dārgas kļūdas, kuras ir grūti labot: .env faila iekļaušana repozitorijā, shēmas mainīšana bez migrācijas. Visgrūtākā disciplīna ir faila uzturēšana aktuālā stāvoklī. AGENTS.md, kas apraksta pagājušā gada projektu, aktīvi virza Codex uz pamestām konvencijām — tas ir daudz sliktāk nekā faila neesamība vispār, jo tad kļūda kļūst sistemātiska.

Galvenās atziņas

  • Sākotnējā iestatīšana prasa OpenAI kontu un GitHub savienojumu
  • IDE paplašinājums un CLI tiek instalēti minūšu laikā
  • AGENTS.md ir vissvarīgākais fails efektīvai Codex lietošanai
  • Tas satur konvencijas, komandas un noteikumus, kas specifiski tavam projektam
  • AGENTS.md faili apakšdirektorijās ļauj veidot kontekstuālas instrukcijas