# 내 키 가져오기 (BYOK) (/ko/docs/verdent-manager/configuration/byok)

> Verdent Desktop에서 자체 제공자 API 키를 사용하고, BYOK 모델을 어디에서 사용할 수 있는지 이해합니다



## 개요 [#개요]

BYOK (Bring Your Own Key)를 사용하면 자체 제공자 API 키를 연결하고, 해당 모델을 Verdent의 내장 에이전트 안에서 직접 사용할 수 있습니다.

### BYOK와 BYOA [#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](/docs/verdent-manager/configuration/byoa)를 참고하세요.

## 지원되는 제공자 [#지원되는-제공자]

* Anthropic
* OpenAI
* OpenRouter

## API 키 추가 [#api-키-추가]

<Steps>
  <Step title="모델 설정 열기">
    **Settings → Models → Configure Models**로 이동합니다.
  </Step>

  <Step title="키 추가 시작">
    오른쪽 위의 \*\*Add API Key +\*\*를 선택합니다.
  </Step>

  <Step title="제공자와 모델 선택">
    제공자를 선택하고 활성화할 모델을 고릅니다.
  </Step>

  <Step title="자격 증명 입력">
    API 키를 추가합니다.
  </Step>

  <Step title="저장 및 검증">
    **Save**를 선택합니다. Verdent가 키를 자동으로 검증합니다.
  </Step>
</Steps>

### 검증 결과 [#검증-결과]

* 검증에 성공하면 키가 저장되고 선택한 모델을 사용할 수 있게 됩니다.
* 검증에 실패하면 Verdent가 오류를 표시하므로 키를 업데이트한 뒤 다시 시도할 수 있습니다.

## 기존 API 키 관리 [#기존-api-키-관리]

**Settings → Models → Configure Models**에서 다음을 할 수 있습니다.

* 제공자의 모든 모델 활성화 또는 비활성화
* 개별 모델 활성화 또는 비활성화
* 기존 API 키 편집
* API 키 삭제

## BYOK 모델이 표시되는 위치 [#byok-모델이-표시되는-위치]

유효한 키를 추가하면 BYOK 모델이 다음 위치에 표시됩니다.

* 채팅 모델 선택기
* 프리셋 모델 설정
* 서브에이전트 설정
* 리뷰어 설정

BYOK 모델은 활성화된 뒤에는 내장 모델처럼 동작합니다.

## 제한 사항 [#제한-사항]

* Smart Suggestions 같은 내장 기능은 BYOK API 키를 지원하지 않습니다.
* 자동 압축은 BYOK API 키를 지원하지 않습니다.