Začínáme
FeloAPI CLI
Nainstalujte FeloAPI CLI a spusťte npx feloapi-cli setup, abyste nakonfigurovali Codex nebo Claude Code s vaším klíčem Felo API.
Nakonfigurujte modely Felo a Felo Skills pro Codex nebo Claude Code přímo z terminálu. Můžete také používat příkazy Felo search, slides, Web Fetch a LiveDocs.
Začněte jediným příkazem
Nainstalujte Node.js 22 nebo novější a poté spusťte:
npx feloapi-cli setupPokud se objeví instalační výzva npm, přijměte ji. Účet npm ani globální instalace nejsou nutné. Codex nebo Claude Code nainstalujte samostatně; konfigurace modelu pro Codex vyžaduje Codex CLI 0.134.0+.
Získejte API klíč a dokončete nastavení
- Otevřete stránku API klíčů Felo Console a přihlaste se do Felo.
- Vytvořte klíč a zkopírujte kompletní klíč z výsledku vytvoření. Seznam zobrazuje pouze maskovaný klíč; nedokáže obnovit celou hodnotu. Pokud jej už nemáte, vytvořte nový klíč.
- Spusťte v terminálu
npx feloapi-cli setupa vyberte Codex nebo Claude Code. - Zvolte Models + Skills, Skills only nebo Models only. Po výzvě vložte svůj celý klíč; vstup je skrytý.
- Pokud konfigurujete model, zvolte model dostupný pro váš účet. Codex potřebuje textový model podporující Responses; Claude Code potřebuje Anthropic Messages. Přítomnost v seznamu modelů nezaručuje kompatibilitu s klientem.
- Zkontrolujte náhled konfigurace a potvrďte uložení.
CLI ukládá váš klíč lokálně do ~/.feloapi/state.json. Tento soubor není šifrovaný; uchovávejte jej mimo Git a sdílené složky. Nevkládejte klíč do argumentů příkazů ani do veřejných logů. Výzva k nastavení přijímá API klíč, nikoli token účtu Felo ani ID klíče.
Spusťte nakonfigurovaného agenta
Po nastavení spusťte agenta, kterého jste nakonfigurovali:
npx feloapi-cli run codexPro Claude Code:
npx feloapi-cli run claude-codeTento spouštěč předává uložený klíč a konfiguraci Felo agentovi. Nastavení vytváří samostatnou konfiguraci Felo; nepřepíná vašeho výchozího poskytovatele modelů. Chcete-li načíst nově nainstalované Skills, spusťte novou relaci agenta.
Nainstalujte globálně nebo zvolte možnosti
Pro časté používání nainstalujte balíček npm feloapi-cli globálně. Nainstalovaný příkaz je feloapi:
npm install -g feloapi-cli
feloapi setup
feloapi run codexChcete-li nainstalovat pouze Felo Skills:
npx feloapi-cli setup --agent codex --skills-onlyChcete-li zobrazit náhled připojení bez uložení konfigurace, nahraďte YOUR_MODEL_ID dostupným ID modelu:
npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run--no-skills konfiguruje pouze model. Opětovné spuštění nastavení nahradí připojení daného agenta k Felo vašimi novými volbami; volba Skills only odstraní jeho dříve spravovaný profil modelu.
Používejte nástroje Felo a zkontrolujte nastavení
Po uložení klíče používejte stávající nástroje Felo. Požadavky API mohou spotřebovávat kvótu vašeho účtu:
npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdownSpusťte lokální kontroly nebo zobrazte nápovědu k příkazům:
npx feloapi-cli doctor
npx feloapi-cli --helpdoctor kontroluje lokální konfiguraci bez placeného volání API. doctor --online navíc kontroluje zjišťování modelů; doctor --probe --agent codex po potvrzení odešle malý požadavek na model a může účtovat poplatky.
| Problém | Co dělat |
|---|---|
npx nebyl nalezen nebo je Node příliš starý | Nainstalujte Node.js 22+ a znovu otevřete terminál. Zkontrolujte node --version. |
| Klíč je odmítnut | Použijte kompletní klíč z výsledku jeho vytvoření. Aktualizujte jej pomocí npx feloapi-cli auth login. |
| Agent používá jiného poskytovatele | Spusťte jej pomocí npx feloapi-cli run codex nebo run claude-code; zkontrolujte nastavení projektu a explicitní přepisy. |
| Existující konfigurace koliduje | Projděte hlášené soubory. CLI zachovává soubory, které nespravuje, a soubory upravené mimo CLI. |
| Odebrání připojení | Spusťte npx feloapi-cli disconnect codex nebo disconnect claude-code. |
npx feloapi-cli auth logout odstraní pouze lokální klíč. Chcete-li klíč zrušit, použijte Felo Console.
Ruční konfiguraci najdete v příručce Codex a příručce Claude Code.