BYOK 설정 가이드 - AI 제공자 구성하기
31장: BYOK 설정 가이드 — AI 제공자 구성하기
BYOK (Bring Your Own Key)를 에스프레소 머신이 있는 카페에 자신의 커피 원두를 가져오는 것처럼 생각해 보세요 — SeaMeet은 추출 및 분석 엔진을 제공하고, AI 접근 자격 증명은 직접 제공합니다. 이렇게 하면 데이터가 여러분과 선택한 AI 제공자 사이에서 직접 흐르며, 제3자 중계가 없습니다.
이 장에서는 두 가지 필수 구성 요소인 AI 요약 키 (Gemini)와 AI 에이전트 제공자 (GitHub Copilot 또는 Claude Code)를 설정하는 방법을 안내합니다.
장 목표
이 장을 읽고 나면 다음을 할 수 있습니다:
- 필요한 키와 그 이유 이해하기
- Google AI Studio에서 무료 Gemini API 키 얻기
- GitHub Copilot CLI 설치 및 구성하기 (무료 티어)
- 또는 Claude Code CLI 설치 및 구성하기
- 두 구성 요소가 모두 작동하는지 확인하기
- 필요할 때 키 업데이트 또는 제 거하기
개요: 필요한 것
BYOK에는 두 가지 구성 요소가 있습니다:
┌─────────────────────────────────────────────────────────────┐
│ BYOK COMPONENTS │
├──────────────────────┬──────────────────────────────────────┤
│ A. AI Summary │ Gemini API key (required) │
│ (required) │ Powers: transcription, summaries, │
│ │ action items, decisions, chapters │
├──────────────────────┼──────────────────────────────────────┤
│ B. AI Agent │ GitHub Copilot CLI ← OR → │
│ (need at least one) │ Claude Code CLI │
│ │ Powers: screenshot analysis, │
│ │ custom AI queries │
└──────────────────────┴──────────────────────────────────────┘
모든 AI 기능이 작동하려면 A와 B에서 최소한 하나의 옵션을 구성해야 합니다.
A 파트: AI 요약 — Gemini API 키
왜 Gemini인가요?
SeaMeet은 오디오 전사, 회의 요약, 실행 항목 추출 및 관련 AI 출력에 Google의 Gemini 모델을 사용합니다. Gemini API에는 일반적인 회의 작업량을 충당하는 넉넉한 무료 티어가 있습니다.
Gemini API 키 얻기
- 브라우저를 열고 Google AI Studio (aistudio.google.com/apikey)로 이동
- 요청 시 Google 계정으로 로그인
- API 키 만들기 클릭
- 요청 시 Google Cloud 프로젝트 선택 또는 만들기
- 생성된 키 복사 (
AIza…로 시작)
무료 티어: Gemini의 무료 티어는 하루에 상당한 수의 API 호출을 허용합니다. 일반적인 회의 녹음 사용 (주당 몇 시간의 오디오)의 경우 대부분의 사용자에게 무료 티어로 충분합니다.
개인 정보 보호: 오디오는 전사를 위해 Google의 API로 직접 전송됩니다. 사용 사례에 따라 우려되는 경우 Google의 AI 데이터 사용 정책을 검토하세요.
SeaMeet에 키 입력하기
설정 마법사를 통해 (구독 후 처음으로):
- 구독 후 마법사가 자동으로 열립니다
- 1단계에서 AI 요약 섹션이 표시됩니다
- 입력 필드에 Gemini 키 붙여넣기
- 키가 자동으로 검증됩니다 — 다음이 표시됩니다:
- ✅ 녹색 체크마크: 키가 유효함
- ❌ 빨간색 X: 키가 유효하지 않거나 잘못 복사됨 — 확인하고 다시 붙여넣기
- 다음 클릭하여 AI 에이전트 설정으로 진행
나중에 설정을 통해:
- 설정 (⚙️) 열기
- AI → API 키로 이동
- AI 요약 섹션 찾기
- 편집 클릭 또는 Gemini 키 필드에 붙여넣기
- 저장 클릭 — 키가 자동으로 검증됩니다
키 테스트 및 제거
API 키 설정에서:
- 테스트 버튼 — Google의 API에 대해 키 검증
- 제거 버튼 — 저장된 키 삭제; 새 키를 추가할 때까지 AI 요약 기능을 사용할 수 없음
검증에 실패하면 손상된 키가 저장되지 않도록 자동으로 지워집니다. 새 키를 붙여넣으세요.
B 파트: AI 에이전트 제공자
최소한 하나의 AI 에이전트 제공자가 필요합니다. SeaMeet은 현재 두 가지를 지원합니다:
| 제공자 | 비용 | 제한 | 적합한 경우 |
|---|---|---|---|
| GitHub Copilot CLI | 무료 (Copilot Free 플랜) | 월 50회 채팅 | 시작하기, 가벼운 사용 |
| Claude Code CLI | 유료 (Claude Pro 또는 Max) | 더 높은 제한 | 정기적인 사용, 파워 사용자 |
둘 다 설치하고 설정 → AI에서 전환할 수 있습니다.
옵션 1: GitHub Copilot CLI (무료)
GitHub Copilot CLI는 SeaMeet이 AI 에이전트로 사용하는 명령줄 도구입니다. 무료 GitHub Copilot 티어는 월 50개의 에이전트 요청을 포함합니다 — 가끔 스크린샷 분석 및 AI 쿼리에 충분합니다.
1단계: GitHub Copilot CLI 설치
시스템에 맞는 방법 선택:
Windows (winget):
winget install GitHub.cli
macOS (Homebrew):
brew install gh
Linux (apt):
sudo apt install gh
참고: SeaMeet은 설정 UI의 각 명령 옆에 복사 버튼을 표시합니다 — 타이핑 없이 정확한 명령을 복사할 수 있습니다.
2단계: GitHub로 인증
설치 후 터미널을 열고 다음을 실행하세요:
gh auth login
GitHub 계정에 로그인하기 위한 안내를 따르세요. 이것이 CLI를 GitHub 계정에 연결하고 Copilot 기능을 활성화합니다.
3단계: SeaMeet에서 감지
- SeaMeet의 API 키 설정 (또는 설정 → AI → API 키)에서:
- AI 에이전트 섹션 → GitHub Copilot 타일 찾기
- 새로 고침 (🔄) 클릭
- SeaMeet이 설치된 CLI를 검색합니다
- 찾은 경우: ✅ "감지됨" 상태 표시
- 찾지 못한 경우: 설치를 확인하고 다시 시도
월 50회 채팅 제한: 무료 Copilot 플랜은 시작하기에 충분하지만, AI 에이전트를 자주 사용하면 제한에 도달할 수 있습니다. GitHub Copilot Pro로 업그레이드하거나 더 높은 제한을 위해 Claude Code CLI로 전환할 수 있습니다.
옵션 2: Claude Code CLI (유료)
Claude Code는 Anthropic의 CLI 도구입니다. Claude Pro 또는 Max 구독이 필요하지만 무료 Copilot 티어보다 더 높은 사용 제한이 있습니다.
1단계: Claude Code CLI 설치
Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | sh
SeaMeet의 설정 UI는 각 설치 명령에 대한 복사 버튼을 표시합니다.
2단계: 인증
설치 후 터미널을 열고 다음을 실행하세요:
claude auth
Anthropic 계정으로 로그인하세요 (Claude Pro 또는 Max 플랜 필요).
3단계: SeaMeet에서 감지
- 설정 → AI → API 키 → AI 에이전트 → Claude Code 타일에서
- 새로 고침 (🔄)을 클릭하여 설치된 CLI 감지
- 찾으면 ✅ "감지됨" 표시
기본 제공자 선택
Copilot과 Claude가 모두 설치되어 있는 경우 SeaMeet을 사용하면 기본값으로 사용할 항목을 선택할 수 있습니다:
- 설정 → AI → API 키로 이동
- AI 에이전트 섹션에서 두 타일이 모두 감지된 것으로 표시됩니다
- 라디오 버튼 또는 선택기를 사용하여 활성 소스 선택
- 선택한 제공자가 모든 AI 에이전트 요청에 사용됩니다
언제든지 설정에서 제공자를 전환할 수 있습니다.
모든 것이 작동하는지 확인
설정 후 빠른 종단 간 확인을 수행하세요:
AI 요약 테스트:
- 라이브러리에서 아무 녹음본이나 열기
- AI Insights → 요약 자동 생성 클릭
- 오류 없이 완료되면: ✅ Gemini 키가 작동 중
AI 에이전트 테스트:
- SeaMeet을 사용하여 스크린샷 찍기
- 스크린샷 뷰어에서 열기
- AI 분석 탭을 클릭하고 질문하기
- 응답이 오면: ✅ AI 에이전트 제 공자가 작동 중
키 업데이트
Gemini 키를 업데이트하려면:
- 설정 → AI → API 키 → AI 요약 → 편집
- 이전 키를 지우고 새 키 붙여넣기
- 저장 클릭
에이전트 제공자를 업데이트하려면:
- 키가 만료된 경우 CLI 설치/인증 단계를 다시 실행
- SeaMeet에서 새로 고침을 클릭하여 다시 감지
빠른 참조
┌────────────────────────────────────────────────────────────┐
│ BYOK SETUP GUIDE │
│ Quick Reference │
├────────────────────────────────────────────────────────────┤
│ Gemini key source │ aistudio.google.com/apikey (free) │
│ Gemini free tier │ Generous — enough for typical use │
│ Enter key │ Settings → AI → API Keys → AI Summary │
├────────────────────────────────────────────────────────────┤
│ Copilot install │ winget / brew / apt (free) │
│ Copilot auth │ gh auth login │
│ Copilot limit │ 50 chats/month (free tier) │
├────────────────────────────────────────────────────────────┤
│ Claude install │ curl/irm install script (paid) │
│ Claude auth │ claude auth │
│ Claude requires │ Claude Pro or Max subscription │
├────────────────────────────────────────────────────────────┤
│ Detect provider │ Settings → AI → API Keys → Refresh 🔄│
│ Switch provider │ Radio button in AI Agent section │
│ Test AI Summary │ Open recording → Generate Summary │
└────────────────────────────────────────────────────────────┘
Last updated: 2026-03-20
Published: