나만의 에이전트 가져오기 (BYOA)

BYOA란?

BYOA (Bring Your Own Agent)를 사용하면 Manager의 Workers를 구동할 에이전트 런타임을 선택할 수 있습니다. Verdent의 기본 에이전트만 사용하는 대신, Manager가 디스패치한 Worker 작업을 이미 사용 중이거나 라이선스를 보유한 에이전트에서 실행할 수 있습니다.

대신 Verdent의 내장 에이전트에서 자체 제공자 API 키를 사용하려는 경우 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는 OpenAI의 코딩 에이전트 CLI입니다. Claude Code와 달리 Codex는 Verdent 안에 API 키가 필요하지 않습니다. 로컬 Codex 환경에 이미 설정된 인증을 사용합니다.

사전 요구 사항

Codex CLI 설치됨(codex을 PATH에서 사용할 수 있어야 함)
Codex CLI 인증이 완료되어 터미널에서 사용할 수 있음

설정 단계

CLI Agents 설정 열기

Settings → Models → CLI Agents로 이동합니다.

Codex가 없으면 추가하기

Codex 카드가 보이지 않으면 Add CLI Agent를 선택합니다. Verdent이 시스템 PATH에서 codex 명령을 스캔합니다.

Codex 활성화하기

Codex 토글을 켭니다.

모델 선택하기

Verdent이 사용 가능한 모델을 자동으로 감지합니다. 사용할 모델을 선택합니다.

Node.js 설치됨(npx만 필요)

Verdent은 다음 방식으로 Claude Code을 실행합니다.

npx -y @agentclientprotocol/claude-agent-acp

전역 설치는 필요하지 않습니다.

설정 단계

CLI Agents 설정 열기

Settings → Models → CLI Agents로 이동합니다.

Claude Code가 없으면 추가하기

Claude Code 카드가 보이지 않으면 Add CLI Agent를 선택합니다. Verdent이 npx을 감지합니다.

Claude Code 활성화하기

Claude Code 토글을 켭니다.

제공자 추가하기

Add provider를 선택하고 제공자(예: Anthropic)를 선택합니다.

자격 증명 입력하기

API 키를 입력합니다. 기본값은 자동으로 채워집니다.

테스트하고 저장하기

선택적으로 Test Connection을 선택한 다음 Save를 선택합니다.

저장 후 제공자 아래의 모델이 모델 목록에 표시됩니다. 활성화된 모델은 기본적으로 선택되지만 수동으로 토글할 수 있습니다.

지원되는 제공자

Claude Code은 여러 제공자를 지원합니다. 여러 제공자를 동시에 구성할 수 있으며, 모든 모델이 선택기에 표시됩니다.

Anthropic

Claude 모델을 위한 공식 Anthropic API입니다.

인증: API 키
기본 URL: https://api.anthropic.com
모델: Opus / Sonnet / Haiku
키: platform.claude.com/settings/keys

OpenRouter

여러 모델 제공자에 대한 통합 API 접근입니다.

인증: Token
기본 URL: https://openrouter.ai/api
모델: Opus / Sonnet / Haiku
키: openrouter.ai/workspaces/default/keys

Role Models를 재정의해 다른 OpenRouter 모델(예: google/gemini-2.5-pro)로 라우팅할 수 있습니다.

Zhipu GLM (China)

기본 URL: https://open.bigmodel.cn/api/anthropic
모델: GLM-5
키: bigmodel.cn/usercenter/proj-mgmt/apikeys
문서: docs.bigmodel.cn

Zhipu GLM (Global)

기본 URL: https://api.z.ai/api/anthropic
모델: GLM-5
키: z.ai/manage-apikey/apikey-list
문서: docs.z.ai

Kimi

기본 URL: https://api.kimi.com/coding/
모델: Kimi K2.5
키: kimi.com/code/console
문서: kimi.com/code/docs

Moonshot

기본 URL: https://api.moonshot.cn/anthropic
모델: Kimi K2.5
키: platform.moonshot.cn/console/api-keys
문서: platform.moonshot.cn/docs

Kimi와 Moonshot은 모두 Kimi K2.5를 제공하지만 엔드포인트와 인증 방식이 다릅니다. 키를 받은 위치를 기준으로 선택하세요.

MiniMax (China)

기본 URL: https://api.minimaxi.com/anthropic
모델: MiniMax-M2.7
키: platform.minimaxi.com
문서: platform.minimaxi.com/docs

MiniMax (Global)

기본 URL: https://api.minimax.io/anthropic
모델: MiniMax-M2.7
키: platform.minimax.io
문서: platform.minimax.io/docs

Xiaomi MiMo

기본 URL: https://api.xiaomimimo.com/anthropic
모델: MiMo V2 Pro
키: platform.xiaomimimo.com
문서: platform.xiaomimimo.com/docs

Xiaomi MiMo (Token Plan)

기본 URL: https://token-plan-cn.xiaomimimo.com/anthropic
모델: MiMo V2 Pro
키: platform.xiaomimimo.com
문서: platform.xiaomimimo.com/docs

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)

대부분의 사용자는 이를 수정할 필요가 없습니다. 기본값만으로도 바로 잘 동작합니다.