Skip to content

Void Editor ​

Void Editor는 오픈소스·프라이버시 우선 AI 코드 에디터(Cursor의 오픈소스 대안)입니다. OpenAI 호환 프로토콜로 서드파티 API에 연결할 수 있으며, DeepSeek, OpenRouter, OneAPI, Fast-Token 등 OpenAI 호환 엔드포인트를 제공하는 모든 서비스를 사용할 수 있습니다.

사전 준비 ​

시작하기 전에 다음을 준비하세요.

  1. API Key: Fast-Token 플랫폼에서 발급.
  2. Base URL: API 기준 주소(예: https://fast-token.com/v1).
  3. 모델 이름: 사용할 모델 ID(예: deepseek-chat).

설정 방법 ​

1. 설정 화면 열기 ​

  1. Void Editor를 실행합니다.
  2. 화면 왼쪽 하단의 톱니바퀴 아이콘(Settings) 을 클릭합니다.
  3. 첫 번째 항목 Void's Settings 를 선택합니다.

2. OpenAI 호환 프로토콜 설정(가장 일반적) ​

대부분의 서드파티 API 게이트웨이와 국내 모델은 OpenAI 프로토콜을 지원합니다.

  1. Void 설정 페이지에서 Main Providers 목록을 찾습니다.
  2. OpenAI Compatible 을 선택합니다.
  3. Base URL 입력:
    • Base URL 입력란을 찾습니다.
    • 제공업체 URL을 붙여넣습니다. 보통 /v1 로 끝나야 합니다.
  4. API Key 입력:
    • API Key 필드에 키를 입력합니다.

Base URL 및 API Key 설정

  1. 모델 추가:
    • 모델 목록에서 Add Model 을 클릭합니다.
    • API에서 사용하는 실제 모델 ID(예: deepseek-reasoner, claude-3-5-sonnet)를 입력합니다.

모델 추가

채팅에서 사용하기 ​

설정이 끝나면:

  1. Ctrl + L(Windows) 또는 Cmd + L(macOS)로 사이드바 채팅을 엽니다.
  2. 입력창 위 모델 선택 드롭다운에서 추가한 서드파티 모델을 선택합니다.
  3. 코드나 지시문을 입력해 동작을 확인합니다.

문제 해결 ​

증상가능한 원인해결 방법
Authentication Error (401)API Key 오류키가 전체 복사되었는지, 앞뒤 공백이 없는지 확인하세요.
Resource Not Found (404)Base URL 경로 오류URL 끝에 /v1 을 추가하거나 제거해 보세요.
Connection Timeout네트워크 제한프록시 필요 여부를 확인하고, 브라우저에서 API URL 접속을 테스트하세요.
Model Not Supported모델 ID 오류제공업체 문서의 모델 ID 철자가 정확히 일치하는지 확인하세요.

팁

Void의 핵심 장점은 중계 서버 없이 PC에서 직접 제공업체로 요청을 보낸다는 점입니다. 사내 네트워크에서는 Void 네트워크 설정에서 Proxy(프록시) 를 올바르게 구성하지 않으면 연결이 실패할 수 있습니다.