# 나만의 에이전트 가져오기 (BYOA) (/ko/docs/verdent-manager/configuration/byoa)
> Codex 또는 Claude Code 같은 자체 에이전트 런타임에서 Manager의 Worker 작업을 실행합니다
## BYOA란? [#byoa란]
BYOA (Bring Your Own Agent)를 사용하면 Manager의 Workers를 구동할 에이전트 런타임을 선택할 수 있습니다. Verdent의 기본 에이전트만 사용하는 대신, Manager가 디스패치한 Worker 작업을 이미 사용 중이거나 라이선스를 보유한 에이전트에서 실행할 수 있습니다.
대신 Verdent의 내장 에이전트에서 자체 제공자 API 키를 사용하려는 경우 [BYOK](/docs/verdent-manager/configuration/byok)를 참고하세요.
## 지원되는 에이전트 유형 [#지원되는-에이전트-유형]
| 에이전트 | 설명 | 사전 요구 사항 |
| ----------- | -------------------------- | ------------------------------ |
| 내장 에이전트 | Verdent에서 제공하는 기본 에이전트 | 없음 |
| Claude Code | Anthropic의 Claude Code CLI | Node.js 설치됨(`npx`용) |
| Codex | OpenAI Codex CLI | Codex CLI 설치 및 OpenAI 환경 구성 완료 |
## 사용 사례 [#사용-사례]
* **특정 모델에 접근** — 모델 선택기를 통해 Verdent의 기본 목록에 포함되지 않은 모델 버전을 노출합니다.
* **팀 표준화** — 공유 엔터프라이즈 라이선스를 사용해 팀 사용량을 중앙에서 청구합니다.
* **익숙한 워크플로** — 기존 Claude Code 또는 Codex 경험을 유지하면서 Manager가 Worker 작업을 해당 환경으로 디스패치하도록 합니다.
## 빠른 접근 [#빠른-접근]
* BYOA 설정: **Settings → Models → CLI Agents**
* Manager 채팅에서 모델 선택: 입력 상자에서 **Auto** 모드를 끄고 Task Model을 선택합니다
* BYOA에 구성된 API 키는 로컬에만 저장되며 Verdent 서버로 업로드되지 않습니다
## Codex [#codex]
Codex는 OpenAI의 코딩 에이전트 CLI입니다. Claude Code와 달리 Codex는 Verdent 안에 API 키가 필요하지 않습니다. 로컬 Codex 환경에 이미 설정된 인증을 사용합니다.
### 사전 요구 사항 [#사전-요구-사항]
* Codex CLI 설치됨(`codex`을 `PATH`에서 사용할 수 있어야 함)
* Codex CLI 인증이 완료되어 터미널에서 사용할 수 있음
### 설정 단계 [#설정-단계]
**Settings → Models → CLI Agents**로 이동합니다.
Codex 카드가 보이지 않으면 **Add CLI Agent**를 선택합니다. Verdent이 시스템 `PATH`에서 `codex` 명령을 스캔합니다.
**Codex** 토글을 켭니다.
Verdent이 사용 가능한 모델을 자동으로 감지합니다. 사용할 모델을 선택합니다.
### 모델 검색 [#모델-검색]
Codex 모델은 동적으로 검색됩니다. Codex를 실행한 후 Verdent이 해당 `/models` API를 통해 사용 가능한 모델을 가져옵니다. Codex 쪽에 새 모델이 추가되면 **Refresh Models**를 선택해 목록을 업데이트합니다.
### 인증 [#인증]
Verdent은 Codex 인증을 관리하지 않습니다. Codex는 로컬 셸 환경(일반적으로 `OPENAI_API_KEY` 또는 내장 로그인 플로)을 사용합니다. 터미널에서 `codex`이 동작하면 연동도 동작합니다.
## Claude Code [#claude-code]
Claude Code은 BYOA에서 가장 기능이 풍부한 에이전트이며 여러 제공자를 지원합니다. Anthropic, OpenRouter, Zhipu GLM 등을 연결하고 모델 선택기에서 전환할 수 있습니다.
### 사전 요구 사항 [#사전-요구-사항-1]
* Node.js 설치됨(`npx`만 필요)
Verdent은 다음 방식으로 Claude Code을 실행합니다.
```bash
npx -y @agentclientprotocol/claude-agent-acp
```
전역 설치는 필요하지 않습니다.
### 설정 단계 [#설정-단계-1]
**Settings → Models → CLI Agents**로 이동합니다.
Claude Code 카드가 보이지 않으면 **Add CLI Agent**를 선택합니다. Verdent이 `npx`을 감지합니다.
**Claude Code** 토글을 켭니다.
**Add provider**를 선택하고 제공자(예: Anthropic)를 선택합니다.
API 키를 입력합니다. 기본값은 자동으로 채워집니다.
선택적으로 **Test Connection**을 선택한 다음 **Save**를 선택합니다.
저장 후 제공자 아래의 모델이 모델 목록에 표시됩니다. 활성화된 모델은 기본적으로 선택되지만 수동으로 토글할 수 있습니다.
### 지원되는 제공자 [#지원되는-제공자]
Claude Code은 여러 제공자를 지원합니다. 여러 제공자를 동시에 구성할 수 있으며, 모든 모델이 선택기에 표시됩니다.
#### Anthropic [#anthropic]
Claude 모델을 위한 공식 Anthropic API입니다.
* **인증:** API 키
* **기본 URL:** `https://api.anthropic.com`
* **모델:** Opus / Sonnet / Haiku
* **키:** [platform.claude.com/settings/keys](https://platform.claude.com/settings/keys)
#### OpenRouter [#openrouter]
여러 모델 제공자에 대한 통합 API 접근입니다.
* **인증:** Token
* **기본 URL:** `https://openrouter.ai/api`
* **모델:** Opus / Sonnet / Haiku
* **키:** [openrouter.ai/workspaces/default/keys](https://openrouter.ai/workspaces/default/keys)
Role Models를 재정의해 다른 OpenRouter 모델(예: `google/gemini-2.5-pro`)로 라우팅할 수 있습니다.
#### Zhipu GLM (China) [#zhipu-glm-china]
* **기본 URL:** `https://open.bigmodel.cn/api/anthropic`
* **모델:** GLM-5
* **키:** [bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
* **문서:** [docs.bigmodel.cn](https://docs.bigmodel.cn)
#### Zhipu GLM (Global) [#zhipu-glm-global]
* **기본 URL:** `https://api.z.ai/api/anthropic`
* **모델:** GLM-5
* **키:** [z.ai/manage-apikey/apikey-list](https://z.ai/manage-apikey/apikey-list)
* **문서:** [docs.z.ai](https://docs.z.ai)
#### Kimi [#kimi]
* **기본 URL:** `https://api.kimi.com/coding/`
* **모델:** Kimi K2.5
* **키:** [kimi.com/code/console](https://kimi.com/code/console)
* **문서:** [kimi.com/code/docs](https://kimi.com/code/docs)
#### Moonshot [#moonshot]
* **기본 URL:** `https://api.moonshot.cn/anthropic`
* **모델:** Kimi K2.5
* **키:** [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys)
* **문서:** [platform.moonshot.cn/docs](https://platform.moonshot.cn/docs)
Kimi와 Moonshot은 모두 Kimi K2.5를 제공하지만 엔드포인트와 인증 방식이 다릅니다. 키를 받은 위치를 기준으로 선택하세요.
#### MiniMax (China) [#minimax-china]
* **기본 URL:** `https://api.minimaxi.com/anthropic`
* **모델:** MiniMax-M2.7
* **키:** [platform.minimaxi.com](https://platform.minimaxi.com)
* **문서:** [platform.minimaxi.com/docs](https://platform.minimaxi.com/docs)
#### MiniMax (Global) [#minimax-global]
* **기본 URL:** `https://api.minimax.io/anthropic`
* **모델:** MiniMax-M2.7
* **키:** [platform.minimax.io](https://platform.minimax.io)
* **문서:** [platform.minimax.io/docs](https://platform.minimax.io/docs)
#### Xiaomi MiMo [#xiaomi-mimo]
* **기본 URL:** `https://api.xiaomimimo.com/anthropic`
* **모델:** MiMo V2 Pro
* **키:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **문서:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Xiaomi MiMo (Token Plan) [#xiaomi-mimo-token-plan]
* **기본 URL:** `https://token-plan-cn.xiaomimimo.com/anthropic`
* **모델:** MiMo V2 Pro
* **키:** [platform.xiaomimimo.com](https://platform.xiaomimimo.com)
* **문서:** [platform.xiaomimimo.com/docs](https://platform.xiaomimimo.com/docs)
#### Anthropic 호환(사용자 지정 엔드포인트) [#anthropic-호환사용자-지정-엔드포인트]
Anthropic API 형식과 호환되는 모든 서비스에 사용합니다.
* **인증:** API 키 또는 Token(전환 가능)
* **기본 URL:** 수동 구성
* **모델:** 수동 지정
제공자가 목록에 없지만 Anthropic 호환 API을 지원하는 경우 이 옵션을 사용합니다.
### 고급 옵션 [#고급-옵션]
제공자 구성 패널에서 **Advanced Options**를 펼치면 JSON 편집기에 접근할 수 있습니다.
* **Role Models 매핑:**
* `ANTHROPIC_DEFAULT_OPUS_MODEL`
* `ANTHROPIC_DEFAULT_SONNET_MODEL`
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`
* `CLAUDE_CODE_SUBAGENT_MODEL`
* **사용자 지정 환경 변수**(예: `API_TIMEOUT_MS`)
대부분의 사용자는 이를 수정할 필요가 없습니다. 기본값만으로도 바로 잘 동작합니다.
## Manager에서 BYOA 모델 사용하기 [#manager에서-byoa-모델-사용하기]
구성 후:
채팅 입력에서 **Auto** 모드를 끕니다.
**Task Model** 드롭다운을 엽니다.
활성화된 BYOA 모델 중 하나를 선택합니다. Worker 작업은 해당 모델을 사용해 실행됩니다.
모델은 다음과 같이 표시됩니다.
* `GPT-5.4 Codex-CLI` (Codex에서 제공)
* `Claude-Opus-4.7 ClaudeCode-CLI` (Claude Code에서 제공)
마우스를 올리면 CLI 소스, 모델 이름, 제공자 같은 세부 정보가 표시됩니다.
## 보안 및 개인정보 [#보안-및-개인정보]
* **로컬 저장만 사용:** API 키는 로컬에 저장되며 업로드되지 않습니다.
* **Claude Code 키:** 안전하게 저장되며 일반 설정 파일에 기록되지 않습니다.
* **Codex 인증:** 로컬 환경에서 완전히 관리됩니다. Verdent은 OpenAI 키에 접근하지 않습니다.
## FAQ [#faq]
### CLI Agent가 감지되지 않나요? [#cli-agent가-감지되지-않나요]
`PATH`에서 명령을 사용할 수 있는지 확인합니다.
* Claude Code에는 `npx`이 필요합니다(Node.js 설치됨)
* Codex에는 `codex` CLI 설치가 필요합니다
실행:
```bash
which npx
which codex
```
### Test Connection에 실패했나요? [#test-connection에-실패했나요]
* API 키를 확인합니다
* 기본 URL을 확인합니다
* API 엔드포인트에 네트워크로 접근할 수 있는지 확인합니다
* 프록시를 사용하는 경우 프록시 구성을 확인합니다
### 제공자를 추가했지만 모델이 보이지 않나요? [#제공자를-추가했지만-모델이-보이지-않나요]
* Claude Code이 활성화되어 있는지 확인합니다
* 제공자 모델이 켜져 있는지 확인합니다
* 필요한 경우 Verdent을 다시 시작합니다