AI 도구 설정
Claude Code
Anthropic-compatible 모델 호출이 Felo API Platform을 통해 라우팅되도록 Claude Code를 설정하세요.
Claude Code가 모델 공급업체를 직접 호출하지 않고 Felo API Platform을 통해 모델을 호출하도록 설정하려면 이 가이드를 사용하세요. Claude Code는 Anthropic-compatible Messages endpoint를 사용합니다.
시작하기 전에
Felo API Platform key 하나가 필요합니다. 같은 key로 모델 프로토콜, Agent 클라이언트, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page, SuperAgent API를 사용할 수 있습니다.
export FELO_API_KEY="YOUR_API_KEY"권장 설정
| 항목 | 값 |
|---|---|
| 적합한 용도 | 저장소 편집, 코딩 Agent, 긴 컨텍스트 리서치, 터미널 중심 개발 |
| 프로토콜 | Anthropic-compatible Messages API |
| Base URL | https://openapi.felo.ai/api |
| 모델 예시 | claude-sonnet-4-6 |
| API key | 내 FELO_API_KEY |
Claude Code 설정
먼저 환경 변수를 설정하세요.
export FELO_API_KEY="YOUR_API_KEY"
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"선택 설정 파일
Claude Code를 시작할 때마다 같은 Base URL과 모델을 적용하려면 설정 파일을 사용하세요. API key는 shell 또는 secret manager에 보관하세요.
{
"env": {
"ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
"ANTHROPIC_MODEL": "claude-sonnet-4-6"
}
}한 session에만 모델을 지정할 수도 있습니다.
claude --model claude-sonnet-5설정 확인
설정을 저장한 뒤 작은 작업을 실행하세요.
claude도구가 시작되고 선택한 모델로 답변하면 provider 설정이 완료된 것입니다.
문제 해결
| 문제 | 확인할 내용 |
|---|---|
| 인증 실패 | key가 올바르게 복사되었고 FELO_API_KEY로 export 되었는지 확인하세요 |
| 도구가 잘못된 provider를 호출함 | 현재 workspace 또는 session에서 Felo provider가 선택되어 있는지 확인하세요 |
| Base URL 오류 | OpenAI-compatible 클라이언트에는 https://openapi.felo.ai/api/v1, Anthropic-compatible 클라이언트에는 https://openapi.felo.ai/api를 사용하세요 |
| 모델을 찾을 수 없음 | Felo 모델 목록에 표시되는 모델을 선택하세요 |
| 도구가 로컬 설정을 무시함 | 클라이언트가 사용자 수준 설정을 요구한다면 provider 설정을 사용자 수준 설정으로 옮기세요 |