문서

Obsidian용 Copilot

Copilot의 BYOK 탭에서는 세 가지 항목으로 사용자 지정 OpenAI 호환 제공업체를 설정할 수 있습니다. 설정된 모델이 어느 화면에 표시되는지는 문서에 정확히 명시되어 있으며, 이 페이지도 플러그인 전체를 지원한다고 과장하지 않고 그 내용을 그대로 전달합니다.

Settings → Copilot → BYOK → Add a custom provider: 표시 이름, 키, https://api.kunavo.com/v1을 입력합니다 — Quick Chat은 항상 사용 가능하고, 제공자가 표시되는 경우 Agent Chat은 opencode에서 사용할 수 있습니다

Settings → Copilot → BYOK → Add a provider → Add a custom provider

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

여기서는 기본 URL에 /v1 접미사를 유지합니다. 문서는 설명문이 아니라 예시를 통해 이를 뒷받침합니다. "사용자 지정 OpenAI 호환 제공업체에는 Base URL이 있어야 합니다"라고만 설명하지만, 함께 제공되는 두 OpenAI 호환 템플릿의 기본 URL은 모두 /v1로 끝납니다. 각각 http://localhost:11434/v1은 Ollama용이고 http://localhost:1234/v1는 LM Studio용입니다. 또한 "모델 검색은 엔드포인트의 /v1/models 응답을 사용합니다"라고 덧붙입니다. 검색 결과가 비어 있다면 우선 이 두 가지를 다시 확인하세요.

BYOK 제공업체는 플러그인의 모든 영역에서 사용할 수 있는 것은 아니며, 문서도 이를 분명히 설명합니다. "키를 추가해도 Claude Code 또는 Codex에서 제공하는 모델은 바뀌지 않습니다." 자체 표에 따르면 BYOK 모델은 Quick Chat에서 사용할 수 있으며, Agent Chat에서는 opencode 백엔드에서만 "해당 제공업체가 표시되는 경우"에 사용할 수 있습니다. 이는 조건이지 보장 사항이 아닙니다. 또한 "opencode에서 라우팅할 수 없는 모델은 opencode 목록에서 제외되지만, Quick Chat에서는 작동할 수 있습니다." Claude 또는 Codex 백엔드를 사용한다면 대신 해당 CLI 자체 환경을 설정하세요. /docs/integrations/claude-code를 참조하세요.

CORS 사용은 해결책이라기보다 감수해야 할 변경 사항이며, 계속 켜 두는 설정이 아닙니다. 문서에는 다음과 같이 설명되어 있습니다. "Test는 성공하지만 Quick Chat에서 메시지를 보낼 수 없다면 제공업체를 수정하고 Enable CORS를 켜세요. 그러면 토큰 단위로 스트리밍되지 않고 응답이 완료된 뒤 표시됩니다." 또한 이 설정은 opencode 라우팅에 영향을 주지 않는다고 명시합니다. 따라서 Quick Chat을 해결하려고 설정을 켜면 다른 곳이 아닌 opencode에서 토큰 단위 출력을 잃게 됩니다.

Copilot 4.x에서는 임베딩 제공업체를 지정할 필요가 없습니다. 시맨틱 검색이 별도 서비스인 Miyo로 옮겨졌고 BYOK 대화상자에도 해당 항목이 없습니다. Kunavo는 임베딩 모델을 제공하지 않으므로 이 페이지에서도 임베딩 모델을 제공한다고 암시하지 않습니다.

Kunavo는 이 플러그인을 실제 실행 환경에서 테스트하지 않았습니다. 위의 각 항목과 인용문은 아래 날짜에 Copilot 자체 문서를 확인해 작성한 것입니다. 설정 안내 페이지가 공개되어 있다는 사실은 테스트 실행 결과가 아닙니다. 워크플로를 옮기기 전에 Quick Chat에서 실제 작업을 하나 보내 보세요.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Obsidian용 Copilot 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
Obsidian에서 Settings → Copilot → BYOK를 열고 Add a provider를 클릭하세요.
이름이 지정된 제공업체나 Self Host 템플릿 대신 Add a custom provider를 선택하세요.
위와 같이 Display name, API key, Base URL을 입력하세요. 지금은 Enable CORS를 끈 상태로 두세요.
모델을 하나 이상 추가하세요. Model ID → Add에서 ID를 직접 입력하거나 Search available models에서 선택할 수 있습니다. 이 목록은 GET /v1/models에서 채워집니다. Test를 클릭한 다음 Save를 클릭하세요. 모델과 라우팅 가능한 엔드포인트가 모두 있어야 저장할 수 있습니다.
Basic → Agents → Quick Chat 및 Basic → Agents → opencode에서 모델을 표시할 위치를 설정하세요. 각 항목에는 별도의 Default model이 있습니다. 새 채팅 모델은 기본적으로 두 항목 모두에 사용 설정됩니다.

Copilot의 Model Sources 및 BYOK 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 실제로 토큰 비용을 부담하는 Copilot 백엔드에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Obsidian용 Copilot에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Obsidian용 Copilot에서의 위치
`claude-haiku-4-5`	$0.70 / $3.50	하루 종일 노트에 짧은 질문을 던지는 Quick Chat
`claude-sonnet-5`	$1.40 / $7.00	Agent Chat의 opencode 백엔드 — 기본 작업 모델
`claude-opus-5`	$3.50 / $17.50	잘못 해석하면 비용이 큰, 여러 노트에 걸친 긴 종합 작업
`gpt-5-6-sol`	$2.00 / $12.00	같은 키와 제공업체 행을 사용하는 다른 모델군의 두 번째 의견

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Obsidian Copilot에서 API 키는 어디에 입력하나요?

Settings → Copilot → BYOK → Add a provider로 이동한 다음, 기본 제공 목록에 없는 엔드포인트라면 "Add a custom provider"를 선택하세요. 대화상자에서 Display name, API key, Base URL, 선택 항목인 Enable CORS 스위치를 입력하고, 검색된 목록에서 선택하거나 ID를 입력해 모델을 하나 이상 추가한 다음 Save를 클릭합니다. Copilot 문서에 따르면 제공업체 키는 볼트의 data.json이 아니라 해당 기기의 Obsidian Keychain에 저장되므로 볼트를 동기화해도 자격 증명이 다른 컴퓨터로 전달되지 않습니다.

Obsidian Copilot의 기본 URL 끝에 /v1을 붙여야 하나요?

Kunavo의 경우 https://api.kunavo.com/v1처럼 /v1 형식을 사용하세요. 문서는 규칙을 설명문으로 제시하지 않고, 사용자 지정 OpenAI 호환 제공업체에 Base URL이 있어야 한다는 점, 모델 검색이 엔드포인트의 /v1/models 응답을 사용한다는 점, 함께 제공되는 두 OpenAI 호환 템플릿의 기본값이 http://localhost:11434/v1 및 http://localhost:1234/v1이라는 점을 명시합니다. 두 기본값 모두 접미사가 붙어 있는데, 이것이 문서가 제공하는 가장 강한 근거입니다. 기본 URL이 잘못되면 보통 인증 오류가 아니라 모델 목록이 비거나 Test가 실패하는 형태로 나타납니다.

Obsidian Copilot에서 제공업체 키 대신 OpenRouter나 Kunavo 같은 게이트웨이를 사용할 수 있나요?

Quick Chat에서는 사용할 수 있고, Agent Chat에서는 조건부로 사용할 수 있습니다. Copilot 자체 문서에서는 BYOK를 "AI 제공업체, 호환 게이트웨이 또는 컴퓨터에서 실행 중인 모델 서버에 직접 연결하는 기능"으로 설명하며, "Add a custom provider"에서는 OpenAI 호환 기본 URL과 모델 ID를 지정할 수 있습니다. 모델 소스 표에 따르면 BYOK 모델은 Quick Chat에서 사용할 수 있으며, Agent Chat에서는 "해당 제공업체가 표시되는 경우" opencode 백엔드에서만 사용할 수 있습니다. Claude 및 Codex 백엔드는 BYOK 키를 전혀 받지 않습니다. 문서에 따르면 키를 추가해도 해당 백엔드에서 제공하는 모델은 바뀌지 않습니다.

Obsidian Copilot의 볼트 검색에 임베딩 모델이 필요한가요?

채팅 제공업체의 모델은 필요하지 않습니다. Copilot 4.x는 플러그인 자체 색인 기능을 더 이상 실행하지 않습니다. 문서에 따르면 시맨틱 검색과 Relevant Notes는 별도의 로컬 또는 원격 서비스인 Miyo에서 제공되며, BYOK 대화상자에는 해당 유형의 모델을 지정하는 입력란이 없습니다. Kunavo 역시 임베딩 모델을 제공하지 않으므로 여기서 임베딩 모델을 제공한다고 해석해서는 안 됩니다. Copilot에서 채팅 제공업체 행은 채팅 비용만 부담하며 다른 기능에는 사용되지 않습니다.

Kunavo 키가 Copilot Lite 또는 Plus 라이선스를 대체하나요?

아니요. 두 항목은 의도적으로 별도로 처리됩니다. Copilot 문서에서는 라이선스와 BYOK를 서로 다른 모델 소스로 취급합니다. 라이선스는 사용자의 플랜에 따라 Brevilabs가 요금을 청구하는 Copilot 호스팅 모델을 제공하며, BYOK는 청구를 해당 제공업체에 맡긴 채 사용자의 엔드포인트로 요청을 보냅니다. 여기의 키는 라이선스 사용량을 충전하거나, 잠긴 Copilot 호스팅 항목을 잠금 해제하거나, 라이선스가 필요한 서비스를 바꾸지 않습니다. 반대로 라이선스 없이 무료 등급에서 BYOK를 사용할 수 있습니다.