Skip to main content
Codex CLI to otwartoźródłowy lokalny agent programistyczny stworzony przez OpenAI, działający w Twoim terminalu. Potrafi czytać kod, modyfikować pliki, wykonywać polecenia, wyjaśniać błędy i pomagać w codziennych zadaniach programistycznych. Codex CLI obsługuje niestandardowych dostawców modeli. Możesz korzystać z niego za pośrednictwem kompatybilnego proxy OpenAI Responses dostarczanego przez Ace Data Cloud, bez konieczności osobnej subskrypcji oficjalnego konta OpenAI. Po konfiguracji Codex CLI wysyła zapytania do https://api.acedata.cloud/v1.

​
Proces rejestracji

Aby korzystać z Codex CLI, najpierw odwiedź konsolę Ace Data Cloud, aby uzyskać swój token API na zapas. Jeśli nie jesteś zalogowany lub zarejestrowany, zostaniesz automatycznie przekierowany do strony logowania, gdzie możesz się zarejestrować i zalogować. Po zalogowaniu zostaniesz automatycznie przeniesiony z powrotem na tę stronę. Przy pierwszym wniosku otrzymasz darmowy limit, dzięki czemu możesz bezpłatnie wypróbować usługę Codex CLI.

​
Instalacja Codex CLI

Codex CLI obsługuje macOS, Linux, Windows oraz WSL. Możesz zainstalować go przez npm lub użyć Homebrew (tylko macOS).

​
Instalacja przez npm (zalecane)

Jeśli masz już zainstalowany Node.js, możesz zainstalować go bezpośrednio przez npm. Wymaga to Node.js w wersji 18 lub wyższej.

​
Instalacja przez Homebrew (macOS)

Użytkownicy macOS mogą również zainstalować Codex CLI przez Homebrew:

​
Sprawdzenie instalacji

Po instalacji otwórz ponownie terminal i sprawdź, czy polecenie jest dostępne:
Jeśli pojawi się komunikat command not found, oznacza to zwykle, że terminal nie załadował nowej ścieżki PATH. Zamknij i otwórz terminal ponownie lub sprawdź konfigurację PATH podaną w komunikacie instalacyjnym.

​
Konfiguracja Codex CLI

Po instalacji Codex CLI domyślnie próbuje łączyć się z oficjalną usługą OpenAI. Aby użyć Ace Data Cloud, musisz zadeklarować niestandardowego model_provider w pliku konfiguracyjnym Codex oraz umieścić token API w odpowiedniej zmiennej środowiskowej.

​
Krok pierwszy: ustawienie zmiennej środowiskowej

Zaleca się zapisanie tokena API w pliku konfiguracyjnym powłoki, np. ~/.zshrc, ~/.bashrc lub ~/.bash_profile:
Zamień {token} na token API skopiowany z konsoli Ace Data Cloud. Po konfiguracji otwórz terminal ponownie lub wykonaj odpowiednie polecenie source, aby zmiany od razu weszły w życie:

​
Krok drugi: edycja pliku konfiguracyjnego Codex

Codex CLI używa pliku globalnej konfiguracji ~/.codex/config.toml. Jeśli plik nie istnieje, utwórz go:
Wklej poniższą zawartość do ~/.codex/config.toml:
Opis pól:

​
Czyszczenie zapisanych danych logowania OpenAI

Jeśli wcześniej logowałeś się do Codex CLI oficjalnym kontem OpenAI, lokalnie mogą być zapisane dane logowania (zwykle w ~/.codex/auth.json). Przed przełączeniem na proxy Ace Data Cloud zaleca się usunięcie tych danych:
Jeśli polecenie codex logout nie jest dostępne, możesz ręcznie usunąć plik:
Jeśli nigdy nie logowałeś się oficjalnym kontem OpenAI, możesz pominąć ten krok.

​
Uruchomienie sesji

Przejdź do katalogu swojego projektu i uruchom Codex CLI:
Po pojawieniu się interfejsu Codex możesz wpisywać zapytania, np.:

​
Weryfikacja konfiguracji

Po wejściu do Codex CLI możesz sprawdzić aktualny model i dostawcę:
Powinieneś zobaczyć, że model pochodzi od dostawcy acedatacloud, np.:
Jeśli dostawca nie jest acedatacloud, oznacza to, że konfiguracja nie została zastosowana. Sprawdź, czy plik ~/.codex/config.toml został poprawnie zapisany oraz czy zmienna ACEDATACLOUD_API_KEY jest dostępna w bieżącym terminalu:
Możesz również sprawdzić historię użycia i szczegóły rozliczeń w konsoli Ace Data Cloud - Historia użycia oraz pozostały limit w konsoli Ace Data Cloud - Lista aplikacji.

​
Jak to działa

Codex CLI natywnie korzysta z protokołu OpenAI Responses API. Ace Data Cloud udostępnia kompatybilne proxy pod adresem https://api.acedata.cloud/v1/responses, więc Codex CLI nie wymaga lokalnego proxy ani dodatkowych wtyczek. Proces działania:
  1. Codex CLI odczytuje model_provider z ~/.codex/config.toml i ładuje odpowiadającą sekcję [model_providers.acedatacloud].
  2. Codex CLI pobiera token API ze zmiennej środowiskowej wskazanej przez env_key (czyli ACEDATACLOUD_API_KEY).
  3. Zapytania wysyłane są protokołem wire_api = "responses" na adres base_url + /responses, czyli https://api.acedata.cloud/v1/responses.
  4. Ace Data Cloud weryfikuje token API, sprawdza limit i przekazuje zapytanie do dostępnego kanału modelu.
  5. Po zakończeniu zapytania platforma rejestruje zużycie i odejmuje odpowiednią ilość z limitu.
Oznacza to, że nadal korzystasz z oryginalnego polecenia codex i natywnego interfejsu Codex CLI, ale z usługą modelu działającą przez Ace Data Cloud.

​
Konfiguracja modelu

Pole model w ~/.codex/config.toml określa domyślny model używany przez Codex. Usługa OpenAI Responses Ace Data Cloud obsługuje wiele modeli, najczęściej używane to: Jeśli chcesz tymczasowo zmienić model, możesz podać go jako parametr przy uruchamianiu Codex:
Możesz też bezpośrednio zmodyfikować pole model w ~/.codex/config.toml i ponownie uruchomić program. Pełną listę modeli znajdziesz w dokumentacji usługi OpenAI Ace Data Cloud.

​
Poziomy zaufania projektów

Codex CLI pozwala ustawić różne poziomy zaufania dla poszczególnych projektów, kontrolując, jakie operacje agent może wykonywać. Możesz dodać na końcu ~/.codex/config.toml:
Znaczenie:
  • trusted: Agent ma pełne uprawnienia, może wykonywać polecenia i modyfikować pliki.
  • untrusted: Agent ma ograniczone uprawnienia, odpowiednie dla projektów, których nie znasz dobrze.

​
Dowiedz się więcej