AI 도구 설정
OpenCode
OpenAI-compatible endpoint를 통해 OpenCode를 Felo에 연결하세요.
OpenCode에서 OpenAI-compatible provider, API key, Base URL, 모델 이름을 입력해야 할 때 이 가이드를 사용하세요.
시작하기 전에
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, OpenAI-compatible 모델 라우팅 |
| 프로토콜 | OpenAI-compatible Chat Completions |
| Base URL | https://openapi.felo.ai/api/v1 |
| 모델 예시 | claude-sonnet-4-6 |
| API key | 내 FELO_API_KEY |
OpenCode 설정
먼저 환경 변수를 설정하세요.
export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"클라이언트 필드
| 필드 | 값 |
|---|---|
| Provider type | OpenAI-compatible |
| API key | 내 FELO_API_KEY |
| Base URL | https://openapi.felo.ai/api/v1 |
| Model | claude-sonnet-4-6 |
Anthropic-compatible provider 모드를 선택한다면 Base URL로 https://openapi.felo.ai/api를 사용하세요.
설정 확인
설정을 저장한 뒤 작은 작업을 실행하세요.
Open OpenCode, select the Felo provider, and send a short test message.도구가 시작되고 선택한 모델로 답변하면 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 설정을 사용자 수준 설정으로 옮기세요 |