Kodowanie z kluczami API
Z kluczem API Koderen możesz korzystać z narzędzi kodowania pracujących z interfejsem API kompatybilnym z OpenAI. Narzędzie wysyła żądania do AI-Corporate. AI-Corporate sprawdza klucz, budżet, okres ważności i dozwolone modele.
Następnie AI-Corporate przetwarza żądanie przez techniczne połączenie środowiska.
Czego potrzebujesz?
Potrzebujesz trzech danych:
| Dane | Gdzie to znaleźć? |
|---|---|
| Klucz API | Otrzymujesz go od administratora |
| Endpoint | https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| Nazwa modelu | Na przykład gpt-5.4-mini, gpt-5.4 lub gpt-5.5 |
Klucz API zaczyna się od aic.. Traktuj go jak hasło.
Które narzędzie wybrać?
AI-Corporate zaleca OpenCode dla większości użytkowników. OpenCode to narzędzie kodujące agentycznie do terminala, pulpitu i IDE. Narzędzie może samodzielnie wykonywać kroki, edytować pliki i rozwijać zadania.
Aider jest technicznie kompatybilny z interfejsem kompatybilnym z OpenAI, ale w środowiskach korporacyjnych nie jest zalecane jako domyślne narzędzie.
Zobacz także oficjalną dokumentację OpenCode.
Bezpieczne obchodzenie się z kluczami
Nie udostępniaj klucza API publicznie 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
Nigdy nie umieszczaj kluczy API w publicznym repozytorium, czacie, udokumentowanym dokumencie ani zrzucie ekranu.
Gdy klucz nie działa
Sprawdź:
- czy Koderen jest włączony dla środowiska
- czy klucz jest nadal aktywny
- czy budżet nie został wyczerpany
- czy klucz mieści się w ustalonym okresie ważności
- czy używasz dozwolonego modelu
- czy endpoint jest poprawnie skonfigurowany
W razie wątpliwości skontaktuj się z administratorem, aby sprawdził klucz.
Zmienne środowiskowe i OpenCode
Dla OpenCode można zapisać klucz API Koderen w lokalnym pliku .env w katalogu projektu:
AI_SCHOOL_CODEREN_API_KEY=ais.twoj-klucz-api
Upewnij się, że OpenCode ładuje tę zmienną środowiskową. W PowerShell można tymczasowo ustawić zmienną dla bieżącego terminala:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.twoj-klucz-api"
Jeżeli widzisz Authorization header with Bearer token is required, narzędzie nie przekaże klucza w nagłówku Authorization: Bearer .... Jeżeli widzisz Unknown parameter, usuń ustawienia specyficzne dla dostawcy, które endpoint Koderen AI-Corporate nie obsługuje.