Felo API PlatformFelo API Platform

Pierwsze kroki

FeloAPI CLI

Zainstaluj FeloAPI CLI i uruchom npx feloapi-cli setup, aby skonfigurować Codex lub Claude Code z Twoim kluczem Felo API.

Skonfiguruj modele Felo i Felo Skills dla Codex lub Claude Code z poziomu terminala. Możesz też używać poleceń wyszukiwania Felo, slajdów, Web Fetch i LiveDocs.

Zacznij od jednego polecenia

Zainstaluj Node.js 22 lub nowszy, a następnie uruchom:

npx feloapi-cli setup

Zaakceptuj monit instalacyjny npm, jeśli się pojawi. Konto npm ani instalacja globalna nie są wymagane. Codex lub Claude Code zainstaluj osobno; konfiguracja modeli Codex wymaga Codex CLI 0.134.0+.

Pobierz klucz API i dokończ konfigurację

  1. Otwórz stronę kluczy API Felo Console i zaloguj się do Felo.
  2. Utwórz klucz i skopiuj pełny klucz z wyniku utworzenia. Lista pokazuje tylko zamaskowany klucz; nie można odzyskać pełnej wartości. Jeśli go już nie masz, utwórz nowy klucz.
  3. Uruchom npx feloapi-cli setup w terminalu i wybierz Codex lub Claude Code.
  4. Wybierz Models + Skills, Skills only lub Models only. Wklej pełny klucz, gdy pojawi się monit; dane wejściowe są ukryte.
  5. Jeśli konfigurujesz model, wybierz model dostępny dla Twojego konta. Codex wymaga modelu tekstowego obsługującego Responses; Claude Code wymaga Anthropic Messages. Samo pojawienie się na liście modeli nie gwarantuje zgodności z klientem.
  6. Przejrzyj podgląd konfiguracji i potwierdź zapis.

CLI zapisuje klucz lokalnie w ~/.feloapi/state.json. Ten plik nie jest szyfrowany; trzymaj go poza Git i folderami współdzielonymi. Nie wklejaj klucza do argumentów poleceń ani publicznych logów. Monit konfiguracji przyjmuje klucz API, a nie token konta Felo ani identyfikator klucza.

Uruchom skonfigurowanego agenta

Po konfiguracji uruchom agenta, którego skonfigurowałeś:

npx feloapi-cli run codex

Dla Claude Code:

npx feloapi-cli run claude-code

Ten launcher przekazuje zapisany klucz i konfigurację Felo do agenta. Konfiguracja tworzy osobną konfigurację Felo; nie przełącza domyślnego dostawcy modeli. Rozpocznij nową sesję agenta, aby wczytać nowo zainstalowane Skills.

Instalacja globalna lub wybór możliwości

Do częstego użytku zainstaluj pakiet npm feloapi-cli globalnie. Zainstalowane polecenie to feloapi:

npm install -g feloapi-cli
feloapi setup
feloapi run codex

Aby zainstalować tylko Felo Skills:

npx feloapi-cli setup --agent codex --skills-only

Aby podejrzeć połączenie bez zapisywania konfiguracji, zastąp YOUR_MODEL_ID dostępnym identyfikatorem modelu:

npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run

--no-skills konfiguruje tylko model. Ponowne uruchomienie konfiguracji zastępuje połączenie Felo tego agenta nowymi wyborami; wybór Skills only usuwa wcześniej zarządzany profil modelu.

Używaj narzędzi Felo i sprawdź konfigurację

Po zapisaniu klucza korzystaj z istniejących narzędzi Felo. Żądania API mogą zużywać limit Twojego konta:

npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdown

Uruchom lokalne kontrole lub wyświetl pomoc poleceń:

npx feloapi-cli doctor
npx feloapi-cli --help

doctor sprawdza lokalną konfigurację bez wykonywania płatnego wywołania API. doctor --online dodatkowo sprawdza wykrywanie modeli; doctor --probe --agent codex po potwierdzeniu wysyła małe żądanie do modelu i może wiązać się z opłatami.

ProblemCo zrobić
Nie znaleziono npx lub Node jest zbyt staryZainstaluj Node.js 22+ i ponownie otwórz terminal. Sprawdź node --version.
Klucz jest odrzucanyUżyj pełnego klucza z wyniku jego utworzenia. Zaktualizuj go poleceniem npx feloapi-cli auth login.
Agent używa innego dostawcyUruchom go poleceniem npx feloapi-cli run codex lub run claude-code; sprawdź ustawienia projektu i jawne nadpisania.
Konflikt z istniejącą konfiguracjąPrzejrzyj zgłoszone pliki. CLI zachowuje pliki, którymi nie zarządza, oraz pliki edytowane poza CLI.
Usuwanie połączeniaUruchom npx feloapi-cli disconnect codex lub disconnect claude-code.

npx feloapi-cli auth logout usuwa tylko lokalny klucz. Aby unieważnić klucz, użyj Felo Console.

Informacje o konfiguracji ręcznej znajdziesz w przewodniku Codex i przewodniku Claude Code.