시작

FeloAPI CLI

FeloAPI CLI를 설치하고 npx feloapi-cli setup으로 Codex, Claude Code, 모델과 Felo Skills를 설정하세요.

터미널에서 Codex 또는 Claude Code에 Felo 모델과 Skills를 설정하세요. Felo 검색, 슬라이드, 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）, Skills only（Skills만）, Models only（모델만） 중 선택하세요. 안내에 따라 전체 키를 붙여넣으세요. 입력 내용은 화면에 표시되지 않습니다.
모델을 설정한다면 계정에서 사용할 수 있는 모델을 선택하세요. Codex에는 Responses, Claude Code에는 Anthropic Messages를 지원하는 텍스트 모델이 필요합니다. 목록에 있다고 해서 호환성이 보장되지는 않습니다.
설정 미리보기를 확인하고 저장을 승인하세요.

키는 로컬 ~/.feloapi/state.json에 저장됩니다. 이 파일은 암호화되지 않으므로 Git이나 공유 폴더에 넣지 마세요. 키를 명령어 인수나 공개 로그에 입력하지 마세요. Felo 계정 토큰이나 키 ID가 아닌 전체 API 키를 사용해야 합니다.

설정한 도구에 맞는 명령을 실행하세요.

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가 관리하던 모델 설정이 삭제됩니다.

키를 저장한 후 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`을 확인하세요.
키가 유효하지 않음	전체 키로 `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 가이드를 참고하세요.