SeaMeet Desktop 출시 — 모든 것을 녹음하고, 놓치는 것 없이. 무료 다운로드 →

BYOK 설정 가이드 - AI 공급자 구성

제 36 장: BYOK 설정 가이드 — AI 공급자 구성

BYOK (Bring Your Own Key)는 에스프레소 머신이 있는 카페에 자신의 커피 콩을 가져가는 것과 같다고 생각하세요 — SeaMeet은 추출 및 분석 엔진을 제공하고, 사용자는 AI 액세스 자격 증명을 공급합니다. 이를 통해 데이터는 사용자와 선택한 AI 공급자 사이에서 직접 흐르며, 제3자 중계는 없습니다.

이 장에서는 필요한 두 가지 구성 요소 설정 — AI 요약 키 (Gemini)와 AI 에이전트 공급자 (GitHub Copilot 또는 Claude Code)를 안내합니다. 또한 새 구독자를 종종 놀라게 하는 혜택도 다룹니다 — BYOK Pro 플랜에는 AI 액세스뿐만 아니라 GitHub를 통한 무료 기기 간 동기화도 포함됩니다.

GitHub Sync 포함

v2.1.x부터 모든 BYOK Pro 구독에는 자체 비공개 GitHub 저장소를 통한 메모와 wiki의 기기 간 동기화가 제공됩니다 — 추가 비용 없이, 워크스페이스당 하나의 저장소, 저장 용량 제한 없음. 동기화는 업그레이드 화면에서 보이지 않았지만, 이제 Pre-Subscribe 가치 히어로, 플랜 카드, BYOK 설명 FAQ, Sync 설정 화면에 표시됩니다.

전용 Sync Pro 플랜과 다른 점: BYOK는 자체 GitHub를 통해 경량 텍스트 (메모 + wiki)만 동기화합니다. Sync Pro는 SeaMeet의 인프라를 통해 모든 것 — 메모, 오디오, 비디오 및 스크린샷 — 을 동기화하는 별도 관리되는 서비스입니다. 대부분의 BYOK 사용자에게는 이미 포함된 텍스트 동기화만 필요합니다.

전체 안내는 제 38 장: GitHub Sync를 참조하세요.

장의 목표

이 장을 읽고 나면 다음을 할 수 있습니다:

  • 어떤 키가 필요하고 왜 필요한지 이해
  • Google AI Studio에서 무료 Gemini API 키 받기
  • GitHub Copilot CLI (무료 등급) 설치 및 구성
  • 또는, Claude Code CLI 설치 및 구성
  • 구독에 번들된 GitHub 동기화 설정 (제 38 장)
  • 두 구성 요소가 모두 작동하는지 확인
  • 필요할 때 키 업데이트 또는 제거

개요: 필요한 것

BYOK에는 두 개의 구성 요소가 있습니다 — 그리고 구성할 필요가 없는 하나의 번들된 혜택이 있습니다:

┌─────────────────────────────────────────────────────────────┐
│                    BYOK COMPONENTS                          │
├──────────────────────┬──────────────────────────────────────┤
│  A. AI 요약          │  Gemini API 키 (필수)                │
│  (필수)              │  제공: 전사, 요약, 액션 아이템,       │
│                      │  결정 사항, 챕터                      │
├──────────────────────┼──────────────────────────────────────┤
│  B. AI 에이전트      │  GitHub Copilot CLI  ← 또는 →        │
│  (최소 1개 필요)     │  Claude Code CLI                     │
│                      │  제공: 스크린샷 분석,                 │
│                      │  사용자 지정 AI 쿼리                  │
├──────────────────────┼──────────────────────────────────────┤
│  C. GitHub Sync      │  BYOK Pro에 포함됨                    │
│  (번들, 선택)         │  워크스페이스당 비공개 GitHub 저장소.  │
│                      │  기기 간에 메모 + wiki 동기화.        │
│                      │  설정: 제 38 장.                      │
└──────────────────────┴──────────────────────────────────────┘

모든 AI 기능이 작동하려면 A와 B에서 최소 하나의 옵션을 구성해야 합니다. C는 선택 사항이지만 이미 비용을 지불했습니다 — 기기 간 동기화를 위한 준비가 되면 언제든지 활성화하세요.

가치 제안 요약

월 $4.99 BYOK Pro가 다루는 것:

  • 개인 정보 보호 — 데이터는 기기에서 Google / Anthropic / OpenAI로 직접 이동합니다. SeaMeet 서버는 절대 보지 않습니다.
  • 품질 — 작업별로 최고의 모델을 선택합니다.
  • 비용 통제 — 공급자에게 직접 비용을 지불합니다. 대부분의 사용자는 Gemini의 무료 등급에 머뭅니다.
  • 주권 — 키는 OS 키체인에 있습니다. 언제든지 취소할 수 있습니다.
  • 무료 및 비공개 동기화 — 메모와 wiki를 자체 비공개 GitHub 저장소에 백업합니다.

앱에서 볼 수 있는 위치

이 다섯 가지 혜택은 공유된 BYOK 가치 히어로를 통해 모든 BYOK 업그레이드 접점에서 강화됩니다 — Pre-Subscribe 설명서, 구독 후 영수증, 설정 → AI, 무료 사용자가 AI 게이트 기능 (전사, 요약, 액션 아이템, 메모 합성, wiki 목록, 스크린샷 AI)을 클릭할 때 나타나는 잠긴 기능 카드, Sync 설정 넛지 배너에서.

파트 A: AI 요약 — Gemini API 키

왜 Gemini인가요?

SeaMeet은 오디오 전사, 회의 요약, 액션 아이템 추출 및 관련 AI 출력에 Google의 Gemini 모델을 사용합니다. Gemini API에는 일반적인 회의 워크로드를 다루는 넉넉한 무료 등급이 있습니다.

Gemini API 키 받기

  1. 브라우저를 열고 Google AI Studio (aistudio.google.com/apikey)로 이동
    • 메시지가 표시되면 Google 계정으로 로그인
  2. Create API Key 클릭
  3. 요청 시 Google Cloud 프로젝트를 선택하거나 생성
  4. 생성된 키 복사 (이는 AIza…로 시작)

무료 등급: Gemini의 무료 등급은 하루에 상당한 양의 API 호출을 허용합니다. 일반적인 회의 녹음 사용 (주당 몇 시간의 오디오)의 경우 무료 등급은 대부분의 사용자에게 충분합니다.

개인 정보 보호: 오디오는 전사를 위해 Google의 API로 직접 전송됩니다. 이것이 사용 사례에 우려가 된다면 Google의 AI 데이터 사용 정책을 검토하세요.

SeaMeet에 키 입력

설정 마법사 중 (구독 후 첫 번째):

  1. 구독 후 마법사가 자동으로 열립니다
  2. 1단계는 AI 요약 섹션을 표시합니다
  3. Gemini 키를 입력 필드에 붙여넣습니다
  4. 키는 자동으로 검증됩니다 — 다음과 같이 표시됩니다:
    • ✅ 녹색 체크: 키가 유효합니다
    • ❌ 빨간색 X: 키가 유효하지 않거나 잘못 복사되었습니다 — 확인하고 다시 붙여넣으세요
  5. AI 에이전트 설정으로 진행하려면 Next를 클릭하세요

나중에 설정을 통해:

  1. 설정 (⚙️) 열기
  2. AI → API 키로 이동
  3. AI 요약 섹션 찾기
  4. Edit를 클릭하거나 Gemini 키 필드에 붙여넣기
  5. Save 클릭 — 키가 자동으로 검증됩니다

키 테스트 및 제거

API 키 설정에서:

  • Test 버튼 — Google API에 대해 키 검증
  • Remove 버튼 — 저장된 키 삭제; 새 키를 추가할 때까지 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에서 각 명령 옆에 복사 버튼을 표시합니다 — 입력하지 않고 정확한 명령을 복사할 수 있습니다. 다른 Linux 배포판은 GitHub CLI 설치 문서를 참조하세요.

2 단계: GitHub로 인증

설치 후 터미널을 열고 다음을 실행하세요:

gh auth login

프롬프트에 따라 GitHub 계정에 로그인하세요. 이는 CLI를 GitHub 계정에 연결하고 Copilot 기능을 활성화합니다.

3 단계: SeaMeet에서 감지

  1. SeaMeet의 API 키 설정 (또는 설정 → AI → API 키):
  2. AI 에이전트 섹션 → GitHub Copilot 타일 찾기
  3. Refresh (🔄) 클릭
  4. SeaMeet이 설치된 CLI를 스캔합니다
  5. 발견되면: ✅ "Detected" 상태가 나타납니다
  6. 발견되지 않으면: 설치를 확인하고 반복하세요

월 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에서 감지

  1. 설정 → AI → API 키 → AI 에이전트 → Claude Code 타일
  2. 설치된 CLI를 감지하려면 Refresh (🔄)를 클릭
  3. 발견되면 ✅ "Detected"가 나타납니다

기본 공급자 선택

Copilot과 Claude를 모두 설치한 경우, SeaMeet에서 기본으로 사용할 공급자를 선택할 수 있습니다:

  1. 설정 → AI → API 키로 이동
  2. AI 에이전트 섹션에서 두 타일이 모두 감지된 것으로 표시됩니다
  3. 라디오 버튼이나 선택기를 사용하여 활성 공급자를 선택합니다
  4. 선택한 공급자는 모든 AI 에이전트 요청에 사용됩니다

설정에서 언제든지 공급자를 전환할 수 있습니다.

모든 것이 작동하는지 확인

설정 후 빠른 엔드 투 엔드 검사를 수행하세요:

AI 요약 테스트:

  1. 라이브러리에서 아무 녹음이나 엽니다
  2. "AI Insights" → **"Generate Summary"**를 클릭합니다
  3. 오류 없이 완료되면: ✅ Gemini 키가 작동합니다

AI 에이전트 테스트:

  1. SeaMeet을 사용하여 스크린샷을 찍습니다
  2. 스크린샷 뷰어에서 엽니다
  3. AI 분석 탭을 클릭하고 질문합니다
  4. 응답을 받으면: ✅ AI 에이전트 공급자가 작동합니다

키 업데이트

Gemini 키를 업데이트하려면:

  1. 설정 → AI → API 키 → AI 요약 → Edit
  2. 이전 키를 지우고 새 키를 붙여넣습니다
  3. Save를 클릭합니다

에이전트 공급자를 업데이트하려면:

  • 키가 만료된 경우 CLI 설치/인증 단계를 다시 실행하세요
  • SeaMeet에서 Refresh를 클릭하여 다시 감지하세요

빠른 참조

┌────────────────────────────────────────────────────────────┐
│                  BYOK 설정 가이드                           │
│                  빠른 참조                                  │
├────────────────────────────────────────────────────────────┤
│  Gemini 키 소스    │ aistudio.google.com/apikey (무료)     │
│  Gemini 무료 등급  │ 넉넉함 — 일반 사용에 충분             │
│  키 입력           │ 설정 → AI → API 키 → AI 요약          │
├────────────────────────────────────────────────────────────┤
│  Copilot 설치      │ winget / brew / apt (무료)             │
│  Copilot 인증      │ gh auth login                         │
│  Copilot 한도      │ 월 50 채팅 (무료 등급)                 │
├────────────────────────────────────────────────────────────┤
│  Claude 설치       │ curl/irm 설치 스크립트 (유료)         │
│  Claude 인증       │ claude auth                           │
│  Claude 요구       │ Claude Pro 또는 Max 구독              │
├────────────────────────────────────────────────────────────┤
│  공급자 감지       │ 설정 → AI → API 키 → Refresh 🔄      │
│  공급자 전환       │ AI 에이전트 섹션의 라디오 버튼         │
│  AI 요약 테스트    │ 녹음 열기 → "Generate Summary"        │
└────────────────────────────────────────────────────────────┘

관련 장

  • 제 31 장: 실시간 전사 · 제 32 장: AI 요약 · 제 33 장: AI 요약 템플릿 · 제 34 장: AI 결과 편집 — 모두 Gemini 키로 구동됩니다
  • 제 35 장: 구독 및 결제 — 플랜 관리 및 결제 포털
  • 제 37 장: Copilot — GitHub Copilot CLI를 AI 에이전트로 사용
  • 제 38 장: GitHub Sync — BYOK Pro 플랜에 번들된 기기 간 동기화

Last updated: 2026-06-04

← 제 35 장: 구독 및 결제 | 제 37 장: Copilot →

Published:

Previous
구독 및 결제 - SeaMeet AI 잠금 해제
Next
GitHub Copilot 제공자 - Copilot을 AI 에이전트로 사용하기