Kodowanie z kluczami API

Za pomocą klucza API Koderen możesz korzystać z narzędzi coding pracujących z API kompatybilnym z OpenAI. Narzędzie wysyła żądania do AI-Corporate. AI-Corporate weryfikuje klucz, budżet, okres ważności oraz dozwolone modele.

Następnie AI-Corporate przetwarza żądanie poprzez techniczne połączenie środowiska.

Czego potrzebujesz?

Potrzebujesz trzech danych:

Dane	Gdzie to znaleźć?
Klucz API	Otrzymasz go od administratora
Endpoint	https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nazwa modelu	Na przykład gpt-5.6-luna, gpt-5.6-terra lub gpt-5.6-sol

Klucz API zaczyna się od aic.. Traktuj ten klucz jak hasło.

Jaki narzędzie wybrać?

AI-Corporate zaleca OpenCode dla większości użytkowników. OpenCode to narzędzie do kodowania o charakterze agentowym dla terminala, pulpitu i IDE. Narzędzie potrafi samodzielnie wykonywać kroki, edytować pliki i rozwijać zadania.

Aider technicznie kompatybilny z endpointem kompatybilnym z OpenAI, ale w środowiskach korporacyjnych nie jest zalecany jako narzędzie domyślne.

Zobacz także oficjalną dokumentację OpenCode.

Bezpieczeństwo kluczy

Nie udostępniaj publicznie swojego klucza API i nie umieszczaj go w kodzie, który udostępniasz.

Najlepiej używać:

• zmiennych środowiskowych
• lokalnego pliku .env, który nie jest wysyłany do git
• wbudowanej konfiguracji narzędzia

Uważaj

Nigdy nie umieszczaj kluczy API w publicznym repozytorium, czacie, udostępnionym dokumencie ani zrzucie ekranu.

Co zrobić, jeśli klucz nie działa

Sprawdź:

• czy Koderen jest włączony dla środowiska
• czy klucz jest aktywny
• czy budżet nie jest wyczerpany
• czy klucz mieści się w ustalonym okresie ważności
• czy używasz dozwolonego modelu
• czy endpoint został poprawnie skonfigurowany

W razie wątpliwości poproś administratora o weryfikację klucza.

Zmienne środowiskowe i OpenCode

Dla OpenCode możesz zapisać klucz API Koderen w lokalnym pliku .env w katalogu projektu:

AI_SCHOOL_CODEREN_API_KEY=ais.twoj-klucz-api

Upewnij się, że OpenCode naprawdę ładuje tę zmienną środowiskową. W PowerShell można tymczasowo ustawić zmienną dla bieżącej sesji terminala:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.twoj-klucz-api"

Jeśli pojawi się Authorization header with Bearer token is required, narzędzie nie prześle klucza jako Authorization: Bearer .... Jeśli zobaczysz Unknown parameter, usuń ustawienia specyficzne dla dostawcy, które nie są obsługiwane przez endpoint Koderen AI-Corporate.