Coding Agent (Codex)

1. Czym jest Coding Agent

Coding Agent (wewnetrznie zwany Codex) to rozszerzenie Visual Studio Code, ktore przenosi mozliwosci platformy OmniCog AI do Twojego edytora. Agent dziala na kontekscie biezacego projektu: czyta pliki, rozumie strukture repozytorium i moze wykonywac operacje edycji, tworzenia i refaktoryzacji kodu w sposob sterowany modelem.

Co odroznia Coding Agent od zwyklego autouzupelniacza

Kontekst projektu - agent widzi pliki i strukture, nie tylko biezacy bufor.
Wiele krokow na raz - potrafi zaplanowac i wykonac sekwencje zmian w kilku plikach.
Sandbox-first - wykonuje operacje w izolowanym srodowisku, z biasem na bezpieczenstwo.
Model routing - zadania codex trafiaja do modeli dobranych do pracy z kodem.
AGENT.md - agent prowadzi wewnetrzny plik stanu per folder, aby zachowac ciaglosc pracy.

2. Instalacja

Rozszerzenie dostepne jest w VS Code Marketplace. Zalecana jest instalacja bezposrednio z poziomu edytora.

Krok po kroku

Otworz Visual Studio Code.
Przejdz do panelu Extensions (Ctrl+Shift+X lub Cmd+Shift+X).
Wyszukaj ai-best codex lub OmniCog AI.
Kliknij Install przy rozszerzeniu ai-best Codex.
Po instalacji uruchom VS Code ponownie, jesli zostaniesz o to poproszony.

Alternatywnie

Rozszerzenie mozna zainstalowac takze bezposrednio z marketplace: marketplace.visualstudio.com/items?itemName=ai-best.ai-best-codex.

3. Logowanie i konto

Aby korzystac z Coding Agent, potrzebujesz konta OmniCog AI. Limity oraz dostep do modeli zaleza od Twojego planu (patrz Cennik).

Kliknij ikone OmniCog AI na pasku bocznym VS Code.
Wybierz Zaloguj sie - otworzy sie przegladarka z widokiem logowania.
Po zalogowaniu token sesji zostanie automatycznie przekazany do edytora.
Status konta i pozostale kredyty widoczne sa w stopce panelu agenta.

4. Glowne funkcje

Generowanie kodu

Opisz w jezyku naturalnym, co chcesz uzyskac - agent zaproponuje implementacje z uwzglednieniem stylu Twojego projektu.

Refaktoryzacja

Zaznacz fragment kodu i popros agenta o refaktoryzacje, zmiane wzorca, uproszczenie lub optymalizacje.

Wyjasnianie kodu

Agent potrafi wytlumaczyc dzialanie zaznaczonego fragmentu w jezyku naturalnym, z podzialem na kroki.

Wiele plikow

Dla zadan typu "dodaj nowa funkcjonalnosc" agent przygotowuje plan i modyfikuje kilka plikow jednoczesnie, zachowujac spujnosc zmian.

Integracja z terminalem

Agent moze uruchamiac polecenia w zintegrowanym terminalu (np. testy, build, lint) i interpretowac ich wynik, aby kontynuowac prace.

5. Tryby pracy

Coding Agent udostepnia kilka trybow uprawnien i modeli, ktore mozna ustawic per zapytanie lub globalnie w ustawieniach.

Tryby modeli (codex model mode)

auto - automatyczny dobor modelu do zadania (domyslny).
fast - szybkie odpowiedzi, mniej zasobow, dobre dla krotkich edycji.
deep - glebsza analiza, wiecej krokow rozumowania, wyzszy koszt.

Tryby uprawnien (codex permission mode)

read-only - agent moze tylko czytac pliki, nie wprowadza zmian.
edit - agent moze edytowac pliki po akceptacji uzytkownika.
auto-edit - agent moze wprowadzac zmiany samodzielnie w zakresie projektu.

Poziomy rozumowania (codex reasoning level)

low / medium / high - kompromis miedzy kosztem, czasem odpowiedzi i jakoscia analizy.

6. Plik AGENT.md

Dla kazdego folderu, w ktorym pracujesz, agent utrzymuje wewnetrzny plik AGENT.md. Sluzy on jako pamiec kontekstowa: notatki o strukturze, konwencjach, zaleznosciach i ustaleniach. Plik jest automatycznie sprawdzany pod katem aktualnosci i odswiezany, gdy agent wykryje istotne zmiany.

Co trafia do AGENT.md

Najwazniejsze punkty wejscia projektu.
Konwencje nazewnictwa i styl kodu.
Informacje o narzedziach buildu, testach i linterach.
Dlugoterminowe decyzje architektoniczne odkryte podczas pracy.

Mozesz edytowac AGENT.md recznie, aby narzucic agentowi okreslone zasady lub preferencje.

7. Sandbox i bezpieczenstwo

Coding Agent domyslnie wykonuje dlugie, wieloetapowe zadania w izolowanym srodowisku sandbox. Wprowadzane zmiany sa widoczne jako diff i wymagaja zatwierdzenia, chyba ze aktywny jest tryb auto-edit.

Kazda operacja zapisu plikow jest logowana.
Operacje sieciowe poza dozwolona lista domen sa blokowane.
Sekrety i klucze API nigdy nie sa wysylane jawnym tekstem do modeli - przechodza przez Secret Manager.
Uzytkownik ma do dyspozycji przycisk Cofnij dla ostatniej serii zmian.

8. Limity i billing

Uzycie Coding Agent jest rozliczane w tym samym systemie kredytow co reszta platformy OmniCog AI. Kazde zadanie (plan + kroki wykonania) zuzywa kredyty zgodnie z uzytym modelem i poziomem rozumowania.

Miesiecny limit zalezy od planu (patrz Cennik).
Po przekroczeniu soft limitu otrzymasz powiadomienie.
Po przekroczeniu hard limitu nowe zadania sa wstrzymywane do doladowania lub nowego okresu.
Szczegolowe koszty per zadanie widoczne sa w historii zadan w aplikacji webowej.

9. Czesto zadawane pytania

Czy Coding Agent dziala offline?

Nie. Agent wymaga polaczenia z backendem OmniCog AI, aby korzystac z modeli i rozliczenia kredytow.

Czy moj kod jest uzywany do treningu?

Nie. Kod oraz zawartosc projektu nie sa wykorzystywane do treningu modeli. Szczegoly w Polityce prywatnosci.

Czy agent moze modyfikowac pliki bez mojej zgody?

Domyslnie nie - zmiany sa prezentowane jako diff do zatwierdzenia. Tryb auto-edit trzeba wlaczyc swiadomie.

Czy mozna ograniczyc agenta do okreslonych folderow?

Tak. W ustawieniach rozszerzenia mozesz zdefiniowac liste dozwolonych lub zablokowanych sciezek.

Jak zglosic blad lub zasugerowac funkcje?

Skorzystaj ze strony Kontakt lub opcji Zglos problem w menu rozszerzenia.

Zainstaluj Coding Agent

Pelna moc OmniCog AI w Twoim edytorze kodu.

Pobierz z VS Code Marketplace