FeloAPI CLI

Cấu hình mô hình Felo và Felo Skills cho Codex hoặc Claude Code ngay từ terminal. Bạn cũng có thể dùng các lệnh Felo search, slides, Web Fetch và LiveDocs.

Bắt đầu với một lệnh

Cài đặt Node.js 22 trở lên, sau đó chạy:

npx feloapi-cli setup

Chấp nhận lời nhắc cài đặt của npm nếu nó xuất hiện. Không cần tài khoản npm hay cài đặt toàn cục. Hãy cài Codex hoặc Claude Code riêng; cấu hình mô hình cho Codex yêu cầu Codex CLI 0.134.0+.

Lấy khóa API và hoàn tất thiết lập

1. Mở trang API Keys trên Felo Console và đăng nhập vào Felo.
2. Tạo khóa và sao chép khóa đầy đủ từ kết quả tạo. Danh sách chỉ hiển thị khóa đã che; không thể khôi phục giá trị đầy đủ. Nếu bạn không còn giữ khóa, hãy tạo khóa mới.
3. Chạy npx feloapi-cli setup trong terminal và chọn Codex hoặc Claude Code.
4. Chọn Models + Skills, Skills only hoặc Models only. Dán khóa đầy đủ khi được nhắc; nội dung nhập được ẩn.
5. Nếu cấu hình mô hình, hãy chọn một mô hình có sẵn cho tài khoản của bạn. Codex cần mô hình văn bản hỗ trợ Responses; Claude Code cần Anthropic Messages. Việc xuất hiện trong danh sách mô hình không bảo đảm tương thích với máy khách.
6. Xem lại bản xem trước cấu hình và xác nhận để lưu.

CLI lưu khóa của bạn cục bộ trong ~/.feloapi/state.json. Tệp này không được mã hóa; hãy giữ nó ngoài Git và các thư mục chia sẻ. Không dán khóa vào tham số lệnh hoặc nhật ký công khai. Lời nhắc thiết lập chấp nhận khóa API, không phải token tài khoản Felo hay key ID.

Khởi chạy agent đã cấu hình

Sau khi thiết lập, hãy khởi chạy agent bạn đã cấu hình:

npx feloapi-cli run codex

Với Claude Code:

npx feloapi-cli run claude-code

Dùng trình khởi chạy này để truyền khóa đã lưu và cấu hình Felo cho agent. Thiết lập tạo một cấu hình Felo riêng; nó không chuyển nhà cung cấp mô hình mặc định của bạn. Hãy bắt đầu một phiên agent mới để tải các Skills vừa cài đặt.

Cài đặt toàn cục hoặc chọn khả năng

Nếu dùng thường xuyên, hãy cài gói npm feloapi-cli toàn cục. Lệnh được cài là feloapi:

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

Để chỉ cài Felo Skills:

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

Để xem trước một kết nối mà không lưu cấu hình, thay YOUR_MODEL_ID bằng một model ID có sẵn:

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

--no-skills chỉ cấu hình mô hình. Chạy lại thiết lập sẽ thay thế kết nối Felo của agent đó bằng các lựa chọn mới của bạn; chọn Skills only sẽ gỡ hồ sơ mô hình do nó quản lý trước đó.

Dùng các công cụ Felo và kiểm tra thiết lập

Sau khi lưu khóa, hãy dùng các công cụ Felo hiện có. Các yêu cầu API có thể tiêu hao hạn mức của tài khoản bạn:

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

Chạy kiểm tra cục bộ hoặc xem trợ giúp lệnh:

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

doctor kiểm tra cấu hình cục bộ mà không thực hiện lệnh gọi API trả phí. doctor --online cũng kiểm tra việc khám phá mô hình; doctor --probe --agent codex gửi một yêu cầu mô hình nhỏ sau khi xác nhận và có thể phát sinh chi phí.

npx feloapi-cli auth logout chỉ xóa khóa cục bộ. Để thu hồi khóa, hãy dùng Felo Console.

Để cấu hình thủ công, hãy xem hướng dẫn Codex và hướng dẫn Claude Code.