구성
내 키 가져오기 (BYOK)
Verdent Desktop에서 자체 제공자 API 키를 사용하고, BYOK 모델을 어디에서 사용할 수 있는지 이해합니다
개요
BYOK (Bring Your Own Key)를 사용하면 자체 제공자 API 키를 연결하고, 해당 모델을 Verdent의 내장 에이전트 안에서 직접 사용할 수 있습니다.
BYOK와 BYOA
Verdent에는 두 가지 "bring your own" 방식이 있습니다. 혼동하지 마세요.
| BYOK | BYOA | |
|---|---|---|
| 가져오는 것 | 제공자 API 키 | 에이전트 런타임(Codex / Claude Code) |
| 작업을 실행하는 것 | 키 뒤의 제공자를 사용하는 Verdent의 내장 에이전트 | 사용자의 머신에서 실행되는 외부 CLI 에이전트 |
| 일반적인 사용 사례 | 자체 청구로 모델에 접근하거나, 기본 번들에 포함되지 않은 제공자를 사용 | 기존 Codex / Claude Code 워크플로를 유지하면서 Manager가 Worker 작업을 여기에 디스패치하도록 설정 |
| 설정 위치 | Settings → Models → Configure Models | Settings → Models → CLI Agents |
외부 에이전트 런타임에서 Worker 작업을 실행하려면 BYOA를 참고하세요.
지원되는 제공자
- Anthropic
- OpenAI
- OpenRouter
API 키 추가
모델 설정 열기
Settings → Models → Configure Models로 이동합니다.
키 추가 시작
오른쪽 위의 **Add API Key +**를 선택합니다.
제공자와 모델 선택
제공자를 선택하고 활성화할 모델을 고릅니다.
자격 증명 입력
API 키를 추가합니다.
저장 및 검증
Save를 선택합니다. Verdent가 키를 자동으로 검증합니다.
검증 결과
- 검증에 성공하면 키가 저장되고 선택한 모델을 사용할 수 있게 됩니다.
- 검증에 실패하면 Verdent가 오류를 표시하므로 키를 업데이트한 뒤 다시 시도할 수 있습니다.
기존 API 키 관리
Settings → Models → Configure Models에서 다음을 할 수 있습니다.
- 제공자의 모든 모델 활성화 또는 비활성화
- 개별 모델 활성화 또는 비활성화
- 기존 API 키 편집
- API 키 삭제
BYOK 모델이 표시되는 위치
유효한 키를 추가하면 BYOK 모델이 다음 위치에 표시됩니다.
- 채팅 모델 선택기
- 프리셋 모델 설정
- 서브에이전트 설정
- 리뷰어 설정
BYOK 모델은 활성화된 뒤에는 내장 모델처럼 동작합니다.
제한 사항
- Smart Suggestions 같은 내장 기능은 BYOK API 키를 지원하지 않습니다.
- 자동 압축은 BYOK API 키를 지원하지 않습니다.