> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Użyj Codex z CometAPI

> Skorzystaj z tego przewodnika, aby skonfigurować Codex z CometAPI jako dostawcą modeli, edytując ustawienia dostawcy w pliku config.toml na poziomie użytkownika.

Skorzystaj z tego przewodnika, aby uruchomić [Codex](https://developers.openai.com/codex/quickstart) z CometAPI jako dostawcą modeli.

Oficjalne materiały:

* [Codex quickstart](https://developers.openai.com/codex/quickstart)
* [Podstawy konfiguracji Codex](https://developers.openai.com/codex/config-basic)
* [Niestandardowi dostawcy modeli w Codex](https://developers.openai.com/codex/config-advanced#custom-model-providers)
* [Uwierzytelnianie Codex](https://developers.openai.com/codex/auth)
* [Codex w systemie Windows](https://developers.openai.com/codex/windows)

## Wymagania wstępne

| Wymaganie        | Szczegóły                                                                                                             |
| ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| OS               | macOS, Linux, natywny Windows PowerShell lub Windows z WSL                                                            |
| Git              | Zalecana wersja 2.23+                                                                                                 |
| Codex            | Zainstaluj aplikację Codex lub Codex CLI zgodnie z [Codex quickstart](https://developers.openai.com/codex/quickstart) |
| CometAPI API key | Pobierz go z [panelu CometAPI](https://www.cometapi.com/console/token)                                                |
| Model ID         | Użyj model ID ze [strony modeli](/pl/overview/models)                                                                 |

## Wybierz sposób konfiguracji

Udostępniamy dwie opcje, aby pomóc Ci szybko skonfigurować Codex.

<CardGroup cols={2}>
  <Card title="Opcja 1: Skonfiguruj Codex ręcznie (zalecane)" icon="bolt" href="#configure-codex-manually">
    Edytuj bezpośrednio plik `~/.codex/config.toml` na poziomie użytkownika. To najbardziej niezawodna ścieżka, szczególnie dla użytkowników Windows i WSL.
  </Card>

  <Card title="Opcja 2: Skonfiguruj za pomocą skryptu" icon="puzzle-piece" href="#run-the-setup-script">
    Uruchom skrypt konfiguracyjny jako skrót. Zapisuje on tę samą konfigurację dostawcy i przechowuje CometAPI API key dla Codex.
  </Card>
</CardGroup>

## Skonfiguruj Codex ręcznie

Codex odczytuje domyślne ustawienia dostawcy z pliku `~/.codex/config.toml` na poziomie użytkownika. Skonfiguruj tam dostawcę CometAPI, a nie w projektowym pliku `.codex/config.toml`. Codex ignoruje ustawienia provider i provider-auth w projektowych plikach konfiguracyjnych.

Zalecana konfiguracja używa nazwanego dostawcy `cometapi` oraz uwierzytelniania opartego na poleceniu. Dzięki temu CometAPI pozostaje oddzielone od wbudowanego dostawcy OpenAI, nie wymaga dziedziczenia zmiennych środowiskowych powłoki i nie zastępuje `~/.codex/auth.json`.

<Tabs>
  <Tab title="macOS / Linux / WSL">
    Zapisz swój klucz API CometAPI w lokalnym pliku z kluczem:

    ```bash theme={null}
    mkdir -p "$HOME/.codex"
    printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
    chmod 600 "$HOME/.codex/cometapi_key"
    ```

    Dodaj tę konfigurację do `~/.codex/config.toml`:

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "sh"
    args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    Zapisz swój klucz API CometAPI w katalogu domowym Codex w systemie Windows:

    ```powershell theme={null}
    New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
    Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY
    ```

    Dodaj tę konfigurację do `$HOME\.codex\config.toml`:

    ```toml theme={null}
    model_provider = "cometapi"
    model = "your-model-id"

    [model_providers.cometapi]
    name = "CometAPI"
    base_url = "https://api.cometapi.com/v1"
    wire_api = "responses"

    [model_providers.cometapi.auth]
    command = "powershell.exe"
    args = [
      "-NoProfile",
      "-Command",
      "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
    ]
    ```
  </Tab>
</Tabs>

<Note>
  Natywny Codex w systemie Windows używa `$HOME\.codex`, zwykle `C:\Users\<user>\.codex`. WSL używa `~/.codex` z dystrybucji Linux. Edytuj katalog odpowiadający środowisku, w którym działa agent Codex.
</Note>

## Użyj uwierzytelniania za pomocą zmiennej środowiskowej

Jeśli wolisz przechowywać klucz API CometAPI w zmiennej środowiskowej, użyj `env_key` zamiast bloku `[model_providers.cometapi.auth]`.

Używaj tej konfiguracji dostawcy tylko wtedy, gdy `COMETAPI_KEY` jest dostępny w środowisku uruchamiającym Codex:

```toml theme={null}
model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"
```

<Warning>
  Nie łącz `env_key` z `[model_providers.cometapi.auth]`. Codex obsługuje jedną metodę uwierzytelniania na niestandardowego dostawcę.
</Warning>

## Uruchom skrypt konfiguracji

Skrypt konfiguracji jest opcjonalny. Zapisuje tę samą konfigurację providera `cometapi` do `~/.codex/config.toml`, przechowuje Twój klucz API CometAPI w `~/.codex/cometapi_key`, tworzy kopie zapasowe przed zmianami plików i weryfikuje konfigurację za pomocą `codex exec`, gdy dostępny jest Codex CLI.

W przypadku macOS, Linux lub WSL uruchom interaktywny instalator:

```bash theme={null}
sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"
```

W przypadku konfiguracji nieinteraktywnej przekaż klucz API jawnie:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"
```

W przypadku natywnego Windows PowerShell uruchom interaktywny instalator:

```powershell theme={null}
powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"
```

W przypadku nieinteraktywnej konfiguracji w Windows przekaż klucz API jawnie:

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"
```

<Warning>
  Domyślnie skrypt nie zastępuje `~/.codex/auth.json` i nie usuwa logowania ChatGPT. Używaj `--force-auth-json` lub `-ForceAuthJson` tylko wtedy, gdy chcesz, aby skrypt zarządzał logowaniem Codex z użyciem klucza API przez `auth.json`.
</Warning>

## Wybierz lub zmień model ID

Użyj model ID ze [strony Models](/pl/overview/models). W konfiguracji ręcznej zmień wartość `model` w `~/.codex/config.toml`.

W przypadku macOS, Linux lub WSL przekaż `--model` podczas uruchamiania skryptu konfiguracji:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id
```

W przypadku natywnego Windows PowerShell przekaż `-Model` podczas uruchamiania skryptu konfiguracji:

```powershell theme={null}
powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"
```

<Note>
  Skrypt używa `CODEX_HOME`, jeśli jest ustawione. W przeciwnym razie zapisuje do `~/.codex` bieżącego środowiska.
</Note>

## Zweryfikuj konfigurację

Aby zweryfikować konfigurację za pomocą Codex CLI, uruchom to polecenie tylko do odczytu z dowolnego lokalnego projektu:

```bash theme={null}
codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"
```

Jeśli Codex CLI nie jest dostępny w `PATH`, otwórz aplikację Codex i wyślij krótki Prompt z lokalnego projektu.

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Codex nadal używa domyślnego dostawcy OpenAI">
    Upewnij się, że `model_provider = "cometapi"` znajduje się w pliku `~/.codex/config.toml` na poziomie użytkownika.
  </Accordion>

  <Accordion title="Klucz API się zmienił">
    Zaktualizuj `~/.codex/cometapi_key` albo ponownie uruchom skrypt konfiguracji ze zaktualizowaną wartością `$COMETAPI_KEY`.
  </Accordion>

  <Accordion title="Skrypt PowerShell kończy się niepowodzeniem podczas kontroli wstępnych">
    Użyj ręcznych natywnych kroków PowerShell dla Windows, a następnie uruchom polecenie weryfikacyjne.
  </Accordion>

  <Accordion title="Konfiguracja shella przez potok nie prosi o klucz API">
    Użyj `--key "$COMETAPI_KEY"`, ustaw `COMETAPI_KEY` albo uruchom interaktywne polecenie `sh -c "$(curl ...)"`.
  </Accordion>

  <Accordion title="Połączenie przekracza limit czasu lub używa nieprawidłowego base URL">
    Upewnij się, że `base_url` ma wartość `https://api.cometapi.com/v1` w `~/.codex/config.toml`.
  </Accordion>

  <Accordion title="Model nie został znaleziony">
    Sprawdź [stronę Models](/pl/overview/models), aby zobaczyć dostępne model IDs.
  </Accordion>

  <Accordion title="Konfiguracja Windows wpływa na niewłaściwe środowisko">
    Edytuj `$HOME\.codex` dla natywnego trybu Windows albo edytuj `~/.codex` wewnątrz WSL dla trybu agenta WSL.
  </Accordion>

  <Accordion title="Zmieniło się logowanie ChatGPT">
    Nie używaj `--force-auth-json` ani `-ForceAuthJson`, chyba że chcesz korzystać z trybu logowania za pomocą klucza API.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/codex#howto",
        "name": "Używanie Codex z CometAPI",
        "description": "Użyj tego przewodnika, aby skonfigurować Codex z CometAPI, edytując ustawienia dostawcy w config.toml na poziomie użytkownika.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-1",
            "position": 1,
            "name": "Przejrzyj wymagania wstępne",
            "text": "Ukończ krok Przejrzyj wymagania wstępne w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-2",
            "position": 2,
            "name": "Wybierz ścieżkę konfiguracji",
            "text": "Ukończ krok Wybierz ścieżkę konfiguracji w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-3",
            "position": 3,
            "name": "Skonfiguruj Codex ręcznie",
            "text": "Ukończ krok Skonfiguruj Codex ręcznie w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-4",
            "position": 4,
            "name": "Użyj uwierzytelniania za pomocą zmiennej środowiskowej",
            "text": "Ukończ krok Użyj uwierzytelniania za pomocą zmiennej środowiskowej w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-5",
            "position": 5,
            "name": "Uruchom skrypt konfiguracji",
            "text": "Ukończ krok Uruchom skrypt konfiguracji w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-6",
            "position": 6,
            "name": "Wybierz lub zmień model ID",
            "text": "Ukończ krok Wybierz lub zmień model ID w przewodniku Używanie Codex z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/codex#step-7",
            "position": 7,
            "name": "Zweryfikuj konfigurację",
            "text": "Ukończ krok Zweryfikuj konfigurację w przewodniku Używanie Codex z CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentacja CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integracje",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Używanie Codex z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/codex"
          }
        ]
      }
    ]
    }
    `}
</script>