開始

FeloAPI CLI

FeloAPI CLI をインストールし、npx feloapi-cli setup で Codex、Claude Code、モデル、Felo Skills を設定します。

ターミナルから Codex や Claude Code に Felo のモデルと Skills を設定できます。検索、スライド作成、Web Fetch、LiveDocs などのコマンドも利用できます。

コマンドで設定を開始

Node.js 22 以降をインストールして実行します。

npx feloapi-cli setup

npm のインストール確認が表示されたら承認してください。npm アカウントやグローバルインストールは不要です。Codex または Claude Code は別途インストールしてください。Codex のモデル設定には Codex CLI 0.134.0+ が必要です。

Felo コンソールの API Keys を開き、Felo にログインします。
キーを作成し、作成結果に表示される完全なキーをコピーします。一覧にはマスク済みの値しか表示されず、完全な値は復元できません。保存していない場合は新しいキーを作成してください。
npx feloapi-cli setup を実行し、Codex または Claude Code を選びます。
Models + Skills（両方）、Skills only（Skills のみ）、Models only（モデルのみ）を選びます。案内に従ってキーを貼り付けてください。入力内容は表示されません。
モデルを設定する場合は、アカウントで利用できるモデルを選びます。Codex には Responses、Claude Code には Anthropic Messages 対応のテキストモデルが必要です。一覧への掲載だけでは互換性は保証されません。
設定内容を確認し、保存を承認します。

キーはローカルの ~/.feloapi/state.json に保存されます。このファイルは暗号化されません。Git や共有フォルダに保存しないでください。キーをコマンド引数や公開ログに書かないでください。必要なのは完全な API キーであり、アカウントトークンやキー ID ではありません。

設定したツールに応じて、どちらかを実行します。

npx feloapi-cli run codex

npx feloapi-cli run claude-code

この起動方法で保存済みのキーと Felo 設定が渡されます。設定は独立して作成され、既定のモデルプロバイダーは切り替わりません。Skills を読み込むには新しいセッションを開始してください。

feloapi-cli npm パッケージをグローバルにインストールすると、feloapi コマンドを使用できます。

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

Skills のみをインストールする場合：

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

モデル一覧を確認し、設定を保存せずにプレビューする場合。YOUR_MODEL_ID は利用可能なモデル ID に置き換えてください。

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

--no-skills はモデルのみを設定します。再設定すると、そのツールの Felo 接続が新しい選択に置き換わります。Skills のみを選ぶと、以前 CLI が管理していたモデル設定は削除されます。

キーの保存後に実行できます。API リクエストはアカウントの利用枠を消費する場合があります。

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

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

doctor はローカルのみを確認し、有料 API を呼び出しません。doctor --online はモデル一覧へのアクセスも確認します。doctor --probe --agent codex は承認後にモデルリクエストを送信し、料金が発生する場合があります。

問題	対処
`npx` が見つからない	Node.js 22+ をインストールし、ターミナルを開き直して `node --version` を確認します。
キーが無効	完全なキーを使い、`npx feloapi-cli auth login` で更新します。
別のプロバイダーが使われる	`run codex` または `run claude-code` で起動し、プロジェクト設定や上書き指定を確認します。
設定ファイルの競合	表示されたファイルを確認します。CLI の管理外や外部で編集されたファイルは保持されます。
接続の解除	`npx feloapi-cli disconnect codex` または `disconnect claude-code` を実行します。

npx feloapi-cli auth logout はローカルのキーのみを削除します。キーの失効は Felo コンソールで行ってください。

手動設定は Codex ガイドと Claude Code ガイドを参照してください。