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 setupZaakceptuj 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ę
- Otwórz stronę kluczy API Felo Console i zaloguj się do Felo.
- 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.
- Uruchom
npx feloapi-cli setupw terminalu i wybierz Codex lub Claude Code. - Wybierz Models + Skills, Skills only lub Models only. Wklej pełny klucz, gdy pojawi się monit; dane wejściowe są ukryte.
- 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.
- 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 codexDla Claude Code:
npx feloapi-cli run claude-codeTen 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 codexAby zainstalować tylko Felo Skills:
npx feloapi-cli setup --agent codex --skills-onlyAby 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 markdownUruchom lokalne kontrole lub wyświetl pomoc poleceń:
npx feloapi-cli doctor
npx feloapi-cli --helpdoctor 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.
| Problem | Co zrobić |
|---|---|
Nie znaleziono npx lub Node jest zbyt stary | Zainstaluj Node.js 22+ i ponownie otwórz terminal. Sprawdź node --version. |
| Klucz jest odrzucany | Użyj pełnego klucza z wyniku jego utworzenia. Zaktualizuj go poleceniem npx feloapi-cli auth login. |
| Agent używa innego dostawcy | Uruchom 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łączenia | Uruchom 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.