Void × AI Code With
Void 타사 API / 릴레이 설정
이 페이지에서는 오픈소스 에디터인 Void에서 서드파티 API를 연결하여 Chat, Agent, Tab에서 모델을 사용하는 방법을 보여줍니다.
먼저 Void 사이트에서 데스크톱 빌드를 설치한 다음, All Settings에서 제공자 설정을 마치세요. 키는 Void에만 입력하고 이 페이지에는 절대 입력하지 마세요.
- 제공자
- OpenAI-Compatible
- base_url
- https://api.aicodewith.ai/v1
- API Key
- sk-xxxxxxxx
빠른 설정
나중에 사용할 터미널을 위해 이 키를 저장하세요
이 도구는 키를 자체 설정에 저장합니다. 로그인한 후 키를 복사하여 아래 단계의 API 키 필드에 붙여넣으세요.
sk-***로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기
복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법
Void All Settings에서 OpenAI-Compatible를 구성하세요: URL과 API 키를 붙여넣은 다음 모델 ID를 추가하고 켜세요. 약 3분.
Void는 오픈 소스 AI 코드 편집기입니다. 채팅의 톱니바퀴를 클릭하고 모든 설정을 연 다음 OpenAI-Compatible를 찾아 URL과 API 키를 입력하고, 모델을 추가한 뒤 켜세요.
오른쪽 상단 톱니바퀴 클릭
Void를 실행하고 채팅 패널 오른쪽 상단의 톱니바퀴를 클릭하세요. 왼쪽 하단 활동 표시줄의 톱니바퀴는 사용하지 마세요.
Open Void and click the gear in the top right of the Chat panel. Do not use the gear in the bottom-left activity bar. 모든 설정 열기
왼쪽 사이드바에서 모든 설정을 클릭하여 제공자 양식을 여세요.
In the left sidebar, click All Settings to open the provider form. OpenAI-Compatible 입력
OpenAI-Compatible를 찾으세요. 첫 번째 필드에 https://api.aicodewith.ai/v1을 입력하고(끝에 / 없음), 두 번째 필드에 AI Code With API 키를 붙여넣으세요.
Find OpenAI-Compatible. Enter https://api.aicodewith.ai/v1 in the first field (no trailing /), then paste your AI Code With API key in the second. The URL in the screenshot is redacted. 모델 직접 추가
왼쪽에서 모델을 열고 맨 아래로 스크롤한 다음 + 모델 추가를 클릭하세요. OpenAI-Compatible를 선택하고 정확한 게이트웨이 모델 ID를 입력한 다음 추가를 클릭하세요. Void는 전체 모델 목록을 가져오지 않습니다.
모델 ID 복사
Void는 모델 목록을 가져오지 않습니다. + Add a model을 클릭할 때 다음 중 정확한 Model ID를 입력하세요.
패밀리를 선택한 다음 Model ID를 Add a model에 복사하세요. base_url은 모든 모델에서 동일합니다.
현재 선택됨
- 제공자
- Claude
- 모델 ID
- claude-sonnet-5-5
전체 카탈로그는 AI Code With 문서와 가격 페이지를 따릅니다. Void는 모델을 가져오지 않으므로 각 ID를 추가하고 스위치를 켜세요.
전체 모델 목록 보기Open Models on the left, scroll to the bottom, and click + Add a model. Choose OpenAI-Compatible, type the exact gateway Model ID, then click add. 모델 켜기
모델 목록으로 돌아가서 방금 추가한 모델 옆의 스위치를 켜세요. 채팅에는 켜진 모델만 표시됩니다.
Back on the Models list, turn on the switch next to the model you just added. Chat only lists models that are switched on. The name in the screenshot only shows where the toggle is — enable the row you added. 채팅에서 확인
채팅 패널에서 활성화한 모델을 선택하고 테스트 메시지를 보내세요. 정상적인 응답이 오면 설정이 작동하는 것입니다. 그런 다음 AI Code With 사용 기록에서 시간과 모델을 기준으로 호출을 대조하세요.
In Chat, pick the model you enabled and send a test message. A normal reply confirms the connection; match the call by time and model in AI Code With usage records.
Void는 AI Code With에 어떻게 연결하나요?
Void에는 OpenAI-Compatible 제공자가 포함되어 있습니다. All Settings에서 URL과 API 키를 입력한 다음, Models에서 각 게이트웨이 Model ID를 추가하고 스위치를 켜세요:
- 설정 열기
- Chat 패널 오른쪽 상단의 톱니바퀴를 클릭하세요.
- All Settings 열기
- 왼쪽 사이드바에서 All Settings를 클릭하여 제공자 양식을 여세요.
- OpenAI-Compatible 입력
- OpenAI-Compatible를 찾으세요. 첫 번째 필드에 https://api.aicodewith.ai/v1을 입력하고(끝에 / 없이), 두 번째 필드에 AI Code With API 키를 붙여넣으세요.
- 모델 직접 추가
- Models를 열고 맨 아래로 스크롤한 뒤 + Add a model을 클릭하세요. OpenAI-Compatible를 선택하고 정확한 게이트웨이 Model ID를 입력한 다음 add를 클릭하세요.
- 모델 켜기
- Models 목록으로 돌아가 방금 추가한 모델 옆의 스위치를 켜세요. Chat은 스위치가 켜진 모델만 표시합니다.
- Chat에서 확인
- Chat 패널에서 활성화한 모델을 선택하고 테스트 메시지를 보내세요. 정상 응답이 오면 연결이 작동하는 것입니다.
흐름: Void 에디터 → OpenAI-Compatible 제공자 → AI Code With API. Void는 전체 모델 목록을 가져오지 않으므로 Model ID를 수동으로 추가해야 합니다.
자주 묻는 질문
Void가 처음이신가요?
Void는 로컬 개발을 위한 오픈소스 AI IDE입니다. 비공개 에디터 백엔드 없이 OpenAI 호환 엔드포인트와 직접 통신합니다.
Void 웹사이트
Void 사이트를 열고 Beta 데스크톱 빌드를 다운로드한 다음 Void를 실행하세요. 이 사이트는 설치 프로그램을 호스팅하지 않습니다.
Void 다운로드 페이지 열기설치 세부 정보는 Void 사이트를 따르세요. 저장소는 https://github.com/voideditor/void입니다.
일반적인 오류 문제 해결
가장 빈번한 문제는 4가지 범주로 나뉩니다.
401 / Invalid API Key
증상: 메시지를 보내면 401, Unauthorized 또는 Invalid API Key가 반환됩니다.
원인: 보통 API 키가 유효하지 않거나, 잘못 입력되었거나, 여분의 공백과 함께 복사된 경우입니다.
- OpenAI-Compatible로 돌아가 API 키를 다시 붙여넣으세요
- 키가 AI Code With 대시보드에서 발급되었는지 확인하세요
- 저장한 다음 테스트 메시지를 다시 보내세요
추가한 모델이 사라짐
증상: add를 클릭한 후 모델이 잠시 나타났다가 사라집니다.
원인: 이름이 게이트웨이 Model ID가 아니거나, 제공자에 저장된 Base URL / 키가 없습니다.
- 제공자가 OpenAI-Compatible인지 확인하세요
- 표시 이름이 아니라 가격 페이지의 정확한 Model ID를 사용하세요
- 모델을 추가하기 전에 Base URL과 API 키를 저장하세요
Base URL 오류
증상: 메시지 전송이 실패하거나 추가한 모델을 호출할 수 없습니다.
원인: base_url에 /v1이 없거나, 끝에 /가 있거나, 호스트만 있습니다.
- 값이 https://api.aicodewith.ai/v1인지 확인하세요
- 끝의 슬래시를 제거하세요
- /chat/completions 또는 다른 경로를 추가하지 마세요
Chat에서 응답 없음
증상: 모델을 선택하고 테스트 메시지를 보냈지만 스트리밍 응답이 없거나 UI가 계속 로딩 중입니다. 또는 방금 추가한 모델이 Chat 선택기에 전혀 나타나지 않습니다.
원인: 모델 스위치가 꺼져 있거나, 네트워크가 제한되어 있거나, 이 키로 Model ID를 사용할 수 없거나, Chat이 잘못된 제공자 항목을 가리키고 있습니다.
- Models로 돌아가 추가한 행 옆의 스위치가 켜져 있는지 확인하세요
- Chat이 방금 추가한 OpenAI-Compatible 모델을 사용하고 있는지 확인하세요
- 네트워크를 전환하고 다시 시도하세요
- AI Code With 사용 기록에서 호출이 이루어졌는지 확인하세요