Başlangıç
FeloAPI CLI
FeloAPI CLI'yi kurun ve Codex veya Claude Code'u Felo API anahtarınızla yapılandırmak için npx feloapi-cli setup komutunu çalıştırın.
Felo modellerini ve Felo Skills'i Codex veya Claude Code için terminalinizden yapılandırın. Felo arama, slaytlar, Web Fetch ve LiveDocs komutlarını da kullanabilirsiniz.
Tek komutla başlayın
Node.js 22 veya daha yenisini kurun, ardından şunu çalıştırın:
npx feloapi-cli setupVarsa npm'in kurulum istemini kabul edin. npm hesabı veya global kurulum gerekmez. Codex veya Claude Code'u ayrı olarak kurun; Codex model yapılandırması Codex CLI 0.134.0+ gerektirir.
API anahtarınızı alın ve kurulumu tamamlayın
- Felo Console API Keys sayfasını açın ve Felo'da oturum açın.
- Bir anahtar oluşturun ve tam anahtarı oluşturma sonucundan kopyalayın. Liste yalnızca maskelenmiş bir anahtar gösterir; tam değeri kurtaramaz. Anahtar artık sizde yoksa yeni bir anahtar oluşturun.
- Terminalinizde
npx feloapi-cli setupkomutunu çalıştırın ve Codex veya Claude Code seçin. - Models + Skills, Skills only veya Models only seçin. İstendiğinde tam anahtarınızı yapıştırın; giriş gizlenir.
- Bir model yapılandırıyorsanız hesabınıza açık bir model seçin. Codex Responses destekleyen bir metin modeli gerektirir; Claude Code Anthropic Messages gerektirir. Model listesinde görünmek, istemci uyumluluğunu garanti etmez.
- Yapılandırma önizlemesini gözden geçirin ve kaydetmek için onaylayın.
CLI, anahtarınızı yerel olarak ~/.feloapi/state.json dosyasına kaydeder. Bu dosya şifrelenmez; Git ve paylaşılan klasörlerin dışında tutun. Anahtarınızı komut bağımsız değişkenlerine veya herkese açık günlüklere yapıştırmayın. Kurulum istemi bir API anahtarı kabul eder; Felo hesap belirteci veya anahtar kimliği değil.
Yapılandırdığınız ajanı başlatın
Kurulumdan sonra yapılandırdığınız ajanı başlatın:
npx feloapi-cli run codexClaude Code için:
npx feloapi-cli run claude-codeBu başlatıcı, kaydedilen anahtarı ve Felo yapılandırmasını ajanına aktarmak için kullanılır. Kurulum ayrı bir Felo yapılandırması oluşturur; varsayılan model sağlayıcınızı değiştirmez. Yeni kurulan Skills'i yüklemek için yeni bir ajan oturumu başlatın.
Global olarak kurun veya yetenekleri seçin
Sık kullanım için feloapi-cli npm paketini global olarak kurun. Kurulan komut feloapi'dir:
npm install -g feloapi-cli
feloapi setup
feloapi run codexYalnızca Felo Skills'i kurmak için:
npx feloapi-cli setup --agent codex --skills-onlyYapılandırmayı kaydetmeden bir bağlantıyı önizlemek için YOUR_MODEL_ID yerine kullanılabilir bir model kimliği koyun:
npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run--no-skills yalnızca bir model yapılandırır. Kurulumu yeniden çalıştırmak, o ajanın Felo bağlantısını yeni seçimlerinizle değiştirir; yalnızca Skills seçmek, daha önce yönettiği model profilini kaldırır.
Felo araçlarını kullanın ve kurulumunuzu kontrol edin
Anahtarınızı kaydettikten sonra mevcut Felo araçlarını kullanın. API istekleri hesabınızın kotasını tüketebilir:
npx feloapi-cli search "AI agent trends" --json
npx feloapi-cli web-fetch --url https://example.com --format markdownYerel kontrolleri çalıştırın veya komut yardımını görüntüleyin:
npx feloapi-cli doctor
npx feloapi-cli --helpdoctor ücretli bir API çağrısı yapmadan yerel yapılandırmayı kontrol eder. doctor --online ayrıca model keşfini kontrol eder; doctor --probe --agent codex onaydan sonra küçük bir model isteği gönderir ve ücrete yol açabilir.
| Sorun | Ne yapmalı |
|---|---|
npx bulunamıyor veya Node çok eski | Node.js 22+ kurun ve terminalinizi yeniden açın. node --version komutunu kontrol edin. |
| Anahtar reddediliyor | Oluşturma sonucundaki tam anahtarı kullanın. npx feloapi-cli auth login ile güncelleyin. |
| Ajan başka bir sağlayıcı kullanıyor | npx feloapi-cli run codex veya run claude-code ile başlatın; proje ayarlarını ve açık geçersiz kılmaları kontrol edin. |
| Mevcut yapılandırma çakışıyor | Bildirilen dosyaları gözden geçirin. CLI, yönetmediği dosyaları ve CLI dışında düzenlenen dosyaları korur. |
| Bir bağlantıyı kaldırma | npx feloapi-cli disconnect codex veya disconnect claude-code çalıştırın. |
npx feloapi-cli auth logout yalnızca yerel anahtarı kaldırır. Bir anahtarı iptal etmek için Felo Console'u kullanın.
Manuel yapılandırma için Codex kılavuzuna ve Claude Code kılavuzuna bakın.