Zasoby dla deweloperów

Aplikacja Codex

Użyj RunAPI jako dostawcy modelu w aplikacji Codex, wybierz model zgodny z Responses i zweryfikuj połączenie.

Omówienie

Codex jest dostępny w aplikacji desktopowej ChatGPT dla systemów Windows i macOS. Ten przewodnik kieruje lokalną aplikację Codex na endpoint Responses zgodny z OpenAI w RunAPI, wybiera model RunAPI i weryfikuje połączenie.

Zmienia to dostawcę modelu używanego do generowania odpowiedzi i kodu. Nie dodaje narzędzi RunAPI. Hostowany MCP to osobna integracja z własnymi wymaganiami dotyczącymi klienta i uwierzytelniania.

Zanim zaczniesz

Zainstaluj aktualną aplikację desktopową ChatGPT, zaloguj się i otwórz Codex co najmniej raz.
Utwórz dedykowany standardowy klucz API RunAPI, postępując zgodnie z Przewodnikiem uwierzytelniania. Nie zatwierdzaj klucza do repozytorium.
Z Katalogu modeli skopiuj dokładny identyfikator modelu obsługującego Responses API.

Te kroki konfigurują lokalnych klientów Codex, którzy odczytują konfigurację na poziomie użytkownika. Nie konfigurują hostowanych zadań Codex w chmurze.

Zapisz klucz API

Aplikacje desktopowe mogą nie dziedziczyć zmiennych środowiskowych z powłoki. Utwórz lub edytuj plik ~/.codex/.env i dodaj klucz w osobnym wierszu:

DOTENV

export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

Trzymaj ten plik poza swoimi repozytoriami. W systemach macOS i Linux ogranicz dostęp do niego do własnego konta użytkownika:

SHELL

chmod 600 ~/.codex/.env

Konfiguracja RunAPI

Otwórz plik ~/.codex/config.toml na poziomie użytkownika. Scal poniższe wartości z istniejącym plikiem; nie zastępuj niepowiązanych ustawień ani nie dodawaj drugiej kopii istniejącego klucza najwyższego poziomu:

TOML

model = "YOUR_RUNAPI_MODEL_ID"
model_provider = "runapi"

[model_providers.runapi]
name = "RunAPI"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"
wire_api = "responses"

Ustawienia dostawcy i uwierzytelniania muszą być na poziomie użytkownika. Codex ignoruje model_provider i model_providers w pliku .codex/config.toml projektu. Plik TOML przechowuje wyłącznie nazwę zmiennej środowiskowej; klucz API pozostaje w ~/.codex/.env.

base_url to korzeń API, a nie adres URL operacji. Przy wire_api = "responses" Codex wysyła POST /v1/responses. Zapoznaj się z konfiguracją niestandardowego dostawcy modelu OpenAI, aby poznać kontrakt dostawcy.

Wybierz model

Zastąp YOUR_RUNAPI_MODEL_ID dokładnym identyfikatorem skopiowanym z Katalogu modeli. Wybierz model udostępniający Responses API; obsługa samego Chat Completions nie jest wystarczająca dla tej konfiguracji.

Po zmianie model całkowicie uruchom ponownie aplikację i rozpocznij nowe zadanie. Istniejące zadanie może zachować model i dostawcę, z którymi zostało uruchomione.

Uruchom ponownie i zweryfikuj

Całkowicie zamknij i ponownie otwórz aplikację desktopową ChatGPT.
Otwórz Codex i uruchom nowe zadanie w repozytorium.
Wyślij krótki monit, np. Describe this repository in one sentence.
Upewnij się, że Codex zwraca normalną odpowiedź i że RunAPI rejestruje żądanie POST /v1/responses dla wybranego modelu.

Pierwsza weryfikacja powinna być krótka, aby błędy konfiguracyjne można było łatwo odróżnić od zachowania specyficznego dla zadania.

Dodaj narzędzia RunAPI

Powyższy dostawca modelu kieruje wnioskowanie Codex przez RunAPI. MCP jest osobnym rozwiązaniem: może umożliwiać obsługiwanym klientom wywoływanie narzędzi RunAPI do wykrywania modeli, informacji o koncie i obsługiwanych przepływów zadań.

Przewodnik po hostowanym MCP dokumentuje aktualnie obsługiwane wymagania dotyczące klienta i uwierzytelniania. Uwierzytelnianie hostowanego MCP specyficzne dla Codex nie zostało zweryfikowane, dlatego ta strona nie zawiera kroków konfiguracji MCP dla Codex. Nie zastępuj konfiguracji dostawcy modelu wpisem serwera MCP — te dwie integracje służą różnym celom.

Rozwiązywanie problemów

Codex nadal używa poprzedniego dostawcy: upewnij się, że plik to ~/.codex/config.toml, usuń zduplikowane klucze model lub model_provider, całkowicie uruchom ponownie aplikację i rozpocznij nowe zadanie.
Brak RUNAPI_API_KEY: upewnij się, że klucz znajduje się w ~/.codex/.env, a nie tylko w profilu terminala, a następnie uruchom ponownie aplikację.
Uwierzytelnianie kończy się niepowodzeniem: utwórz lub wymień standardowy klucz, korzystając z Przewodnika po uwierzytelnianiu. Nie wklejaj klucza do config.toml ani do logów pomocy technicznej.
Żądanie zwraca 404: ustaw base_url na https://runapi.ai/v1, a nie https://runapi.ai/v1/responses.
Model jest niedostępny lub odrzuca pole: skopiuj ponownie dokładny identyfikator i upewnij się, że model obsługuje Responses API oraz żądaną funkcję.
Codex wybiera inny model: sprawdź zaufane pliki .codex/config.toml projektu pod kątem nadpisania klucza model. Konfiguracja projektu może wybrać model, mimo że nie może zastąpić dostawcy na poziomie użytkownika.
CLI działa, ale aplikacja nie: sprawdź ~/.codex/.env, a następnie w pełni uruchom ponownie aplikację. Aplikacje GUI mogą nie odczytywać zmiennych eksportowanych wyłącznie przez powłokę.
Zadanie w chmurze nie używa RunAPI: ta lokalna konfiguracja dotyczy lokalnych klientów Codex; hostowane zadania w chmurze nie odczytują plików z Twojego komputera.

Usuń RunAPI

Usuń wartości model, model_provider i [model_providers.runapi] dla RunAPI z pliku ~/.codex/config.toml lub przywróć poprzednio używane wartości dostawcy.
Usuń RUNAPI_API_KEY z ~/.codex/.env, jeśli żadne inne lokalne narzędzie go nie używa.
Całkowicie uruchom ponownie aplikację i rozpocznij nowe zadanie.
Odwołaj dedykowany klucz w RunAPI, gdy nie jest już potrzebny.

Kolejne kroki

Skorzystaj z Szybkiego startu z API LLM, aby poznać wspólne zachowanie protokołu, oraz z Dokumentacji interfejsu API Responses w celu poznania dokładnych pól żądania i odpowiedzi. Kontynuuj, korzystając z Katalogu modeli, Przewodnika uwierzytelniania lub Hosted MCP zgodnie z potrzebami.