Przejdź do głównej treści
Polski— Wybierz język
Menu

Pisanie kodu z Codex

Lekcja 5 z 20 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Od pomysłu do kodu w jednej instrukcji
  2. Tworzenie nowego pliku lub modułu
  3. Dodawanie funkcji do istniejącego kodu
  4. Generowanie kodu na podstawie specyfikacji
  5. Praca z wieloma plikami
  6. Wskazówki dla optymalnych rezultatów
  7. Kluczowe wnioski

Od pomysłu do kodu w jednej instrukcji

Pisanie kodu to zadanie, które będziesz powierzać Codexowi najczęściej i właśnie tutaj różnica między Codex a zwykłym generatorem fragmentów kodu staje się najbardziej widoczna. Agent nie produkuje po prostu izolowanego kawałka kodu, który potem musisz dostosować. Zamiast tego analizuje Twoją bazę kodu, wnioskowane stosowane konwencje i pisze coś, co bezproblemowo wpisuje się w istniejącą architekturę. Twoim zadaniem jest więc mniej opisywanie samego kodu, a bardziej wskazanie miejsca w systemie, gdzie ma on trafić.

Tworzenie nowego pliku lub modułu

Podczas generowania całkowicie nowego kodu precyzja jest równie ważna w kontekście, co w przypadku oczekiwanej funkcjonalności.

"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 odczytuje plik auth.service.ts, aby zrozumieć obecny wzorzec, analizuje importy i zależności projektu, tworzy plik o tej samej strukturze, dodaje odpowiednie typy TypeScript i eksportuje funkcje zgodnie z konwencjami projektu. Wynik wygląda następująco:

// 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
}

Jeden szczegół zasługuje na uwagę: nikt nie prosił o walidację Zod. Codex dodał ją, ponieważ zauważył, że projekt używa Zod we wszystkich innych miejscach. Dlatego odwoływanie się do pliku wzorcowego się opłaca – dziesięciowyrazowe zdanie oszczędza Ci pisania całego akapitu specyfikacji.

Dodawanie funkcji do istniejącego kodu

Agenci dostarczają największej wartości przy pracy z istniejącym kodem, nie dlatego, że napisanie linii jest trudne, ale dlatego, że trudne jest uszanowanie wszystkiego, co je otacza.

"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 analizuje sąsiednie route’y, identyfikuje faktycznie używany middleware, odnotowuje obecny format odpowiedzi, a następnie spójnie dodaje endpoint. To rozpoznanie zajęłoby Ci znacznie więcej czasu niż samo kodowanie i jest to dokładnie ta część, którą ludzie pomijają, gdy się spieszą.

Generowanie kodu na podstawie specyfikacji

W przypadku złożonych funkcji wejdź o poziom wyżej i napisz właściwą specyfikację. Każdy punkt staje się wymogiem, który agent traktuje jako taki.

"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"

Ta specyfikacja dostarcza wartości liczbowe, nazwę nagłówka, kod statusu HTTP, dostępną infrastrukturę oraz lokalizację pliku. Każdy szczegół eliminuje arbitralną decyzję, którą Codex podjąłby za Ciebie – decyzję, o której dowiedziałbyś się dopiero podczas przeglądu kodu.

Praca z wieloma plikami

Pojedyncze zadanie może słusznie obejmować wiele warstw aplikacji, pod warunkiem że wymienisz deliverables (elementy do dostarczenia).

"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 tworzy wszystkie cztery pliki w sposób spójny: serwis opiera się na modelu Prisma, route’y wywołują serwis, a testy pokrywają route’y. Osiągnięcie tej pionowej spójności jest trudne, jeśli podzielisz żądanie na cztery osobne zadania, gdzie każdy krok musi na nowo odkrywać to, co zdecydował poprzedni – a czasem nawet temu zaprzeczać.

Wskazówki dla optymalnych rezultatów

Po pierwsze, pamiętaj o sile odwoływania się do istniejącego kodu: „jak w auth.service.ts“ przekazuje w pięciu słowach wzorzec, którego opisanie zajęłoby Ci stronę. Nazywaj biblioteki wprost – „użyj Zod do walidacji“ zamiast „dodaj walidację“ – i określ format wyjścia, gdy ma to znaczenie, na przykład jednolity obiekt { success, data, error } w całym API. Wspomnij o przypadkach brzegowych, które Cię niepokoją, takich jak „obsłuż przypadek, gdy użytkownik nie istnieje“: pozostawiony sam sobie agent obsłuży tylko szczęśliwy scenariusz (happy path), a Tobie zostawi odkrywanie reszty. Na koniec, wszystko, co powtarzasz z zadania na zadanie, należy umieścić w pliku AGENTS.md, co pozwoli utrzymać Twoje instrukcje w zwięzłości.

Kluczowe wnioski

  • Codex rozumie Twoją bazę kodu i szanuje Twoje istniejące konwencje
  • Odwołuj się do istniejących plików, aby kierować stylem i wzorcami
  • Szczegółowe specyfikacje przynoszą bardziej precyzyjne rezultaty
  • Codex potrafi tworzyć i modyfikować wiele plików w ramach jednego zadania
  • Plik AGENTS.md uzupełnia Twoje instrukcje o stałe reguły