開始

FeloAPI CLI

安裝 FeloAPI CLI，用 npx feloapi-cli setup 設定 Codex、Claude Code、模型與 Felo Skills。

在終端機為 Codex 或 Claude Code 設定 Felo 模型與 Felo Skills，也能使用 Felo 搜尋、簡報、網頁擷取與 LiveDocs 等指令。

一行指令開始設定

安裝 Node.js 22 或更新版本，然後執行：

npx feloapi-cli setup

若 npm 提示安裝套件，確認即可。無需 npm 帳號或全域安裝。Codex 或 Claude Code 需另行安裝；設定 Codex 模型需要 Codex CLI 0.134.0+。

開啟 Felo 控制台 API Keys 頁面，登入 Felo 帳號。
建立 Key，從建立成功的結果中複製完整 Key。清單只顯示遮蔽值，無法還原完整內容；若未保存原本的 Key，請建立新的 Key。
執行 npx feloapi-cli setup，選擇 Codex 或 Claude Code。
選擇 Models + Skills（模型與技能）、Skills only（僅技能） 或 Models only（僅模型）。依提示貼上完整 Key，輸入內容不會顯示。
設定模型時，選擇帳號可用的模型。Codex 需要支援 Responses 的文字模型；Claude Code 需要 Anthropic Messages。出現在模型清單中不代表一定相容。
檢查設定預覽，確認後儲存。

Key 儲存在本機 ~/.feloapi/state.json，此檔案未加密，請勿提交到 Git 或同步至共用資料夾。不要把 Key 寫入指令參數或公開記錄。請使用完整 API Key，而非帳號 Token 或 Key ID。

依照你設定的工具，執行其中一條指令：

npx feloapi-cli run codex

npx feloapi-cli run claude-code

使用此啟動方式，CLI 才會傳入保存的 Key 與 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 連線；選擇「僅技能」會移除先前由 CLI 管理的模型設定。

保存 Key 後即可使用 Felo 工具；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`。
Key 無效	用完整 Key 執行 `npx feloapi-cli auth login` 更新。
使用了其他供應商	透過 `run codex` 或 `run claude-code` 啟動，檢查專案設定與覆寫參數。
設定檔衝突	檢查提示的檔案；CLI 會保留非其管理或被外部修改的檔案。
解除連線	執行 `npx feloapi-cli disconnect codex` 或 `disconnect claude-code`。

npx feloapi-cli auth logout 僅刪除本機 Key；撤銷 Key 請至 Felo 控制台操作。