Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Koodin kirjoittaminen Codexilla

Oppitunti 5 / 20 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Ideasta koodiksi yhdellä käskyllä
  2. Uuden tiedoston tai moduulin luominen
  3. Olemassa olevan koodin laajentaminen
  4. Koodin generointi määritelmän perusteella
  5. Työskentely useiden tiedostojen kanssa
  6. Vinkkejä optimaalisiin tuloksiin
  7. Keskeiset asiat

Ideasta koodiksi yhdellä käskyllä

Koodin kirjoittaminen on tehtävä, jonka annat Codexille useimmiten, ja juuri siinä ero Codexin ja yksinkertaisen koodinpätkien generaattorin välillä käy kaikkein selvimmin. Agentti ei vain tuota eristettyä koodinpätkää, jota sinun pitäisi myöhemmin muokata. Sen sijaan se lukee koodikantasi, päättelee käyttämäsi käytännöt ja kirjoittaa jotain, joka istuu saumattomasti olemassa olevaan arkkitehtuuriisi. Tehtäväsi on siis vähemmän koodin kuvaamista ja enemmän järjestelmässä olevan paikan määrittämistä.

Uuden tiedoston tai moduulin luominen

Kun generoit täysin uutta koodia, tarkkuus on yhtä tärkeää kontekstin kuin odotetun toiminnallisuudenkin kannalta.

"Create a service at src/services/notification.service.ts that handles 
sending notifications via email and webhook. Use the same pattern as 
src/services/auth.service.ts. The service must expose sendEmail(to, subject, body) 
and sendWebhook(url, payload)."

Codex lukee tiedoston auth.service.ts ymmärtääkseen nykyisen mallin, analysoi projektin tuonnit ja riippuvuudet, luo tiedoston samalla rakenteella, lisää sopivat TypeScript-tyypit ja vie funktiot projektin käytäntöjen mukaisesti. Tulos näyttää tältä:

// src/services/notification.service.ts
import { z } from "zod";
import { logger } from "@/lib/logger";
import { env } from "@/lib/env";

const emailSchema = z.object({
  to: z.string().email(),
  subject: z.string().min(1),
  body: z.string().min(1),
});

export async function sendEmail(
  to: string, 
  subject: string, 
  body: string
): Promise<void> {
  const validated = emailSchema.parse({ to, subject, body });
  // ... implementation
}

export async function sendWebhook(
  url: string, 
  payload: Record<string, unknown>
): Promise<Response> {
  // ... implementation
}

Yksi yksityiskohta ansaitsee huomion: kukaan ei pyytänyt Zod-validointia. Codex lisäsi sen, koska se huomasi projektin käyttävän Zodía kaikkialla muualla. Siksi mallitiedostoon viittaaminen kannattaa – kymmenen sanan fraasi säästää sinut kokonaiselta määrittelykappaleelta.

Olemassa olevan koodin laajentaminen

Agentit tuottavat eniten arvoa olemassa olevalle koodille, ei siksi, että rivien kirjoittaminen olisi vaikeaa, vaan siksi, että niiden ympärillä olevien asioiden kunnioittaminen on.

"In src/api/routes/users.ts, add a GET /users/:id/activity endpoint 
that returns the user's last 50 actions. Use the same authentication 
middleware as the other routes."

Codex analysoi viereiset reitit, tunnistaa käytössä olevan välivaraston (middleware), huomaa nykyisen vastausmuodon ja lisää päätepisteen johdonmukaisesti. Tämä tiedustelutyö veisi sinulta paljon enemmän aikaa kuin varsinainen koodaus, ja juuri tämä on se osa, josta ihmiset tinkivät kiireessä.

Koodin generointi määritelmän perusteella

Monimutkaisten ominaisuuksien kohdalla nosta tasoa ylemmäs ja kirjoita kunnollinen määritelmä. Jokaisesta kohdasta tulee vaatimus, jota agentti kohtelee sellaisena.

"Implement a rate limiting system for the API:
- Maximum 100 requests per minute per IP
- Maximum 1000 requests per hour per authenticated user
- Return an X-RateLimit-Remaining header
- Return 429 Too Many Requests when the limit is reached
- Store counters in Redis (already configured in the project)
- Create the middleware in src/middleware/rate-limit.ts"

Tämä määritelmä tarjoaa numeeriset arvot, otsikon nimen, HTTP-tilakoodin, käytettävissä olevan infrastruktuurin ja tiedoston sijainnin. Jokainen yksityiskohta poistaa mielivaltaisen päätöksen, jonka Codex muuten tekisi puolestasi – päätöksen, jonka huomaisit vasta koodikatselmuksen aikana.

Työskentely useiden tiedostojen kanssa

Yksi tehtävä voi perustellusti kattaa useita sovelluskerroksia, kunhan luettelet tuotokset.

"Add an in-app notification system:
1. Prisma model Notification (id, userId, type, message, read, createdAt)
2. Service at src/services/notification.service.ts
3. CRUD API routes in src/api/routes/notifications.ts
4. Tests in src/api/routes/notifications.test.ts"

Codex tuottaa kaikki neljä tiedostoa johdonmukaisesti: palvelu nojaa Prisma-malliin, reitit kutsuvat palvelua ja testit kattavat reitit. Tämän pystysuoran johdonmukaisuuden saavuttaminen on vaikeaa, jos pilkot pyynnön neljäksi erilliseksi tehtäväksi, joissa jokaisen vaiheen on löydettävä uudelleen, mitä edellinen päätti – ja joskus oltava sitä vastaan.

Vinkkejä optimaalisiin tuloksiin

Muista ensin olemassa olevaan koodiin viittaamisen voima: “kuten tiedostossa auth.service.ts” välittää viidellä sanalla mallin, jonka kuvaamiseen sinulta menisi sivukaupalla tekstiä. Nimeä kirjastot eksplisiittisesti – käytä “Zodia validointiin” äläkä vain “lisää validointi” – ja määritä tulostemuoto, kun sillä on väliä, kuten yhtenäinen { success, data, error } -objekti koko rajapinnassasi. Mainitse huolestuttavat reunatapaukset, kuten “käsittele tilanne, jossa käyttäjää ei ole olemassa”: omilleen jätettynä agentti hoitaa vain onnellisen polun ja jättää loput sinun löydettäväksesi. Lopuksi, kaikki mitä toistat tehtävästä toiseen, kuuluu tiedostoon AGENTS.md, mikä pitää ohjeesi lyhyinä.

Keskeiset asiat

  • Codex ymmärtää koodikantasi ja kunnioittaa olemassa olevia käytäntöjäsi
  • Viittaa olemassa oleviin tiedostoihin ohjataksesi tyyliä ja malleja
  • Yksityiskohtaiset määritelmät tuottavat tarkempia tuloksia
  • Codex voi luoda ja muokata useita tiedostoja yhdessä tehtävässä
  • AGENTS.md täydentää ohjeitasi pysyvillä säännöillä