Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Socraigh do thimpeallacht agus AGENTS.md

Ceacht 3 as 20 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Ullmhaigh do thionscadal do Codex
  2. Céim 1: Do rochtain ar Codex
  3. Céim 2: Suiteáil leathnú an eagarthóra
  4. Céim 3: Suiteáil an CLI
  5. An comhad AGENTS.md—do threoir tionscadail
  6. Dea-chleachtais le haghaidh AGENTS.md
  7. Príomhphointí

Nuashonraithe 3 Samhain, 2026 bunaithe ar dhoiciméadú Codex (Codex CLI, Fíordheimhniú, Leathnú IDE Codex, Treoracha saincheaptha le AGENTS.md): níl an pacáiste @openai/codex-cli ná an t-ordú codex auth login ann (úsáid npm install -g @openai/codex agus codex login); is é openai.chatgpt an t-aitheantóir leathnaithe; tá an seoladh codex.openai.com agus na pleananna “Team, Enterprise, nó API” curtha in ionad modhanna rochtana reatha; agus tá ord léitheoireachta AGENTS.md soiléirithe (fréamh an tionscadail → an chomhadlann reatha). Foinse: Codex CLI · Fíordheimhniú · AGENTS.md · Praghsáil.

Ullmhaigh do thionscadal do Codex

Tá dhá rud le bheith i bhfeidhm sula dtosaíonn tú ar do chéad tasc: do rochtain ar Codex—do chuntas agus do cheangal GitHub—agus do thionscadal féin, sainmhínithe tríd an gcomhad AGENTS.md a threoróidh an gníomhaire. Tógann an chéad chuid thart ar 15 nóiméad agus ní dhéantar ach uair amháin í. Cinneann an dara cuid cáilíocht gach rud a fhaigheann tú ó Codex, ag scaradh foirne atá sásta le Codex óna siúd a fhaigheann díomá air.

Céim 1: Do rochtain ar Codex

Is féidir leat Codex a úsáid le cuntas ChatGPT nó le heochair API. Soláthraíonn na pleananna Saor in Aisce agus Go rochtain, ag brath ar an leagan reatha, ar GPT-6 Luna san aip deisce. Ag tosú le Plus, tá Codex ar fáil ar an ngréasán, sa CLI, i leathnú an eagarthóra, agus ar iOS, le comhtháthuithe scamaill cosúil le hathbhreithniú uathoibrithe cód. Oibríonn eochair API d’uathoibriú i dtimpeallachtaí roinnte cosúil le CI, ag baint úsáide as an CLI, an SDK, nó an leathnú—cé nach bhfuil roinnt gnéithe ar fáil b’fhéidir. Tá sonraí agus teorainneacha úsáide ar leathanach praghsála Codex.

Chun obair sa scamall ar do stórtha, ceangail GitHub nuair a chruthaíonn tú do chéad timpeallacht Codex Cloud (Ceacht 2). Agus ceadanna á dtabhairt agat, coinnigh íosmhéid iad: teorannaigh rochtain do na stórtha a theastaíonn uait i ndáiríre amháin.

Céim 2: Suiteáil leathnú an eagarthóra

In VS Code agus ina dhíorthaigh (Cursor, Windsurf), suiteáil leathnú Codex ón margadh—is é openai.chatgpt a aitheantóir:

code --install-extension openai.chatgpt

Ansin oscail Codex trína dheilbhín, nó tríd an bpailéad ordaithe le Codex: Open Codex Sidebar, agus déan logáil isteach. Tá comhtháthuithe ar leith ag Xcode agus ag IDEanna JetBrains: i JetBrains, oscail AI Chat agus roghnaigh Codex.

Céim 3: Suiteáil an CLI

# Suiteáil (macOS agus Linux), nó npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Fíoraigh an tsuiteáil
codex --version

# Logáil isteach (brabhsálaí), nó seiceáil stádas an naisc
codex login
codex login status

Osclaíonn codex login an sruth logála isteach i do bhrabhsálaí. I gcás eochair API, cuir ar fáil é trí ionchur caighdeánach (printenv OPENAI_API_KEY | codex login --with-api-key). Taisceann Codex dintiúir i gcomhad téacs simplí, ~/.codex/auth.json, nó sa bhainisteoir eochracha an chórais, ag brath ar an socruithe cli_auth_credentials_store (file, keyring, auto, nó ephemeral). Má úsáidtear an comhad, caith leis mar fhocal faire: tá comharthaí rochtana ann, mar sin ná déan é a chur faoi rialú leaganacha riamh. Roinneann an CLI agus an leathnú an taisce seo.

An comhad AGENTS.md—do threoir tionscadail

Tá AGENTS.md lárnach chun Codex a úsáid go héifeachtach. Is comhad Markdown simplí é a chuirtear i bhfréamh do stórtha a bhailíonn treoracha, coinbhinsiúin, agus orduithe atá sonrach do do thionscadal. Nuair a dhéanann Codex clónáil ar an stór, léann sé an comhad seo ar dtús: smaoinigh air mar oiliúint uathoibrithe don ghníomhaire, díreach mar a mhíníofá ó bhéal do bhall nua foirne.

Tá an tionchar láithreach. Gan AGENTS.md, má iarrann tú tástáil aonaid ar thionscadal a úsáideann Vitest, tá seans maith go dtugfaidh Codex Jest duit, toisc gurb é sin an rogha is coitianta san éiceachóras. Is le líne amháin de choinbhinsiún is féidir Vitest a fháil ceart an chéad uair, rud a shábhálann duit an ceartúchán céanna a dhéanamh céad uair. Seo struchtúr bunúsach comhaid do thionscadal bainistíochta fachtúirí SaaS.

# AGENTS.md

## Comhthéacs an tionscadail
Feidhmchlár bainistíochta fachtúirí SaaS.
Cruach: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Coinbhinsiúin cóid
- Úsáid comhpháirteanna feidhmiúla React (gan aicmí)
- Ainmnigh comhaid i gcás kebab
- Cineálacha TypeScript i gcomhaid .types.ts ar leith
- Tástálacha le Vitest, comhaid .test.ts in aice leis an gcód

## Orduithe úsáideacha
- `npm run dev` — freastalaí forbartha
- `npm run test` — rith tástálacha
- `npm run lint` — seiceáil linting
- `npm run build` — tógáil táirgeachta

## Struchtúr an tionscadail
    src/
      app/          → Leathanaigh Next.js (App Router)
      components/   → Comhpháirteanna React in-athúsáidte
      lib/          → Loighic gnó agus fóntais
      prisma/       → Scéama DB agus imirceacha

## Rialacha dian
- NÁ MODHNAIGH scéama Prisma riamh gan imirce
- NÁ CUIR comhaid .env faoi rialú leaganacha riamh
- Úsáid Gníomhartha Freastalaí i gcónaí le haghaidh athruithe

Conas a aimsíonn Codex comhaid AGENTS.md

Éiríonn comhad fréamhe amháin ró-ghinearálta go tapa. Ligeann Codex duit treoracha a chruachadh in ord cruinn ar gá duit a bheith ar an eolas faoi:

  1. Leibhéal domhanda: I do fhillteán Codex (~/.codex, mura sáraíonn CODEX_HOME é), léann Codex AGENTS.override.md má tá sé ann, seachas sin AGENTS.md.
  2. Leibhéal tionscadail: Ag tosú ó fhréamh an tionscadail (de ghnáth fréamh Git), téann Codex síos go dtí an chomhadlann reatha agus léann sé, i ngach fillteán a thrasnaítear, AGENTS.override.md nó, mura bhfuil, AGENTS.md.
  3. Cumasc: Déantar comhaid a chomhcheangal ón bhfréamh síos go dtí an chomhadlann reatha; tagann na cinn is gaire don chomhadlann reatha deireanach agus mar sin sáraíonn siad treoracha níos ginearálta.
mo-thionscadal/
  AGENTS.md              → Treoracha tionscadail
  src/
    api/
      AGENTS.md          → "Úsáideann bealaí API Zod le haghaidh bailíochtaithe"

Toradh praiticiúil: ní léitear src/api/AGENTS.md ach amháin má tá Codex ag obair ó src/api nó ó cheann dá fho-fhillteáin, ní nuair a sheoltar é ón bhfréamh. Déantar neamhaird ar chomhaid fholmha, agus stopann an comhcheangal ag 32 KiB de réir réamhshocraithe (project_doc_max_bytes). Má úsáideann do stór ainm eile cheana féin, cosúil le TEAM_GUIDE.md, cuir leis é i project_doc_fallback_filenames in ~/.codex/config.toml.

Chun a fhíorú cad atá lódáilte ag Codex i ndáiríre, iarr air go simplí: codex --ask-for-approval never "Summarize the current instructions.". Athdhéanann Codex an slabhra treoracha ag gach tosú: má tá amhras ort, atoscaigh é sa chomhadlann cheart.

Dea-chleachtais le haghaidh AGENTS.md

Is é an prionsabal treorach ná soiléireacht. Is fearr “Úsáid Vitest, ní Jest” ná “Úsáid ár gcreatlach tástála”, rud a ghlacann leis go bhfuil eolas ag an ngníomhaire nach bhfuil aige. Cuir orduithe san áireamh i gcónaí: gan iad, ní bheidh a fhios ag Codex conas do thástálacha, do linter, nó do thógáil a rith, agus seachadfaidh sé cód nach bhféadfadh sé a fhíorú. Doiciméadaigh an struchtúr mar chrann comhadlainne, rud a choscann air iniúchadh dall a dhéanamh agus comhaid a chruthú san áit mhícheart.

Ar deireadh, liostaigh na toirmisc. Is iad rialacha a scríobhtar mar “NÁ RIAMH” an rud is cost-éifeachtaí sa chomhad, toisc go gcuireann siad bac ar mhisteacha costacha atá deacair a shocrú: comhad .env a chur faoi rialú leaganacha, scéama a mhodhnú gan imirce. Is é an disciplín is deacra ná an comhad a choinneáil cothrom le dáta. Treoraíonn AGENTS.md a dhéanann cur síos ar thionscadal na bliana seo caite Codex go gníomhach i dtreo coinbhinsiúin tréigthe—i bhfad níos measa ná gan aon chomhad a bheith ann, ós rud é go n-éiríonn an earráid córasach ansin.

Príomhphointí

  • Éilíonn an tsocrú tosaigh cuntas OpenAI agus ceangal GitHub
  • Suiteáiltear leathnú an IDE agus an CLI i gceann cúpla nóiméad
  • Is é AGENTS.md an comhad is tábhachtaí chun Codex a úsáid go héifeachtach
  • Cuimsíonn sé coinbhinsiúin, orduithe, agus rialacha atá sonrach do do thionscadal
  • Cuireann comhaid AGENTS.md i bhfo-fhillteáin ar chumas treoracha comhthéacsúla