AI Code With

Chatbox × AI Code With

Chatbox에서 AI Code With 사용: 타사 API / 릴레이 설정

이 페이지에서는 오픈 소스 데스크톱 클라이언트인 Chatbox에서 타사 API를 연결하여 사용자 지정 공급자로 모델과 채팅을 로컬에서 관리하는 방법을 설명합니다.

먼저 Chatbox를 다운로드해 설치한 다음 설정에서 사용자 지정 공급자를 추가하세요. API 키는 Chatbox에만 입력하며, 이 페이지에는 절대 입력하지 않습니다.

Chatbox 사용 중: 설정하기Chatbox 다운로드
사용자 지정 공급자 빠른 참조/v1 없음
API mode
OpenAI API 호환
API Host
https://api.aicodewith.ai
API Path
/chat/completions
API Key
sk-xxxxxxxx
Model ID
deepseek-flash

빠른 설정

나중에 사용할 터미널을 위해 이 키를 저장하세요

이 도구는 키를 자체 설정에 저장합니다. 로그인한 후 키를 복사하여 아래 단계의 API 키 필드에 붙여넣으세요.

API 키
sk-***

로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기

복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법

공식 사이트에서 Chatbox를 설치하고 사용자 지정 공급자를 추가한 다음 /v1 없이 API 호스트와 API 키를 입력하세요. 약 3분 안에 DeepSeek, Gemini, GLM, Kimi 등을 사용할 수 있습니다.

먼저 공식 Chatbox를 다운로드하여 설치합니다. 설정 → 모델 공급자 → + 추가 → 사용자 지정 공급자 추가를 선택합니다. API 모드를 OpenAI API 호환으로 설정하고 호스트를 https://api.aicodewith.ai(/v1 없음)로 지정한 다음 경로는 /chat/completions로 유지합니다.

  1. 공식 Chatbox 다운로드 및 설치

    Chatbox 웹사이트를 열고 Windows, macOS 또는 Linux용 공식 설치 프로그램을 다운로드합니다. 이 사이트는 설치 프로그램을 호스팅하지 않습니다.

    Chatbox 웹사이트 열기

  2. 사용자 지정 공급자 추가 및 호스트와 키 입력

    설정 → 모델 공급자를 열고 + 추가를 클릭한 다음 사용자 지정 공급자 추가를 클릭합니다. 이름을 AI Code With로 지정합니다. API 모드를 OpenAI API 호환으로 설정합니다. /v1 없이 https://api.aicodewith.ai를 입력합니다. 기본 경로 /chat/completions를 유지합니다. Chatbox가 /v1을 자동으로 삽입합니다. API 키를 붙여넣고 원한다면 확인을 클릭합니다. 확인이 통과해도 연결이 성공했다는 의미는 아닙니다.

    빠른 복사

    API 호스트(/v1 없음)

    https://api.aicodewith.ai

    API 경로(기본값 유지)

    /chat/completions

    모델 ID

    deepseek-flash

    복사한 후 Chatbox로 돌아가 API 호스트를 사용자 지정 공급자에 붙여넣고 경로는 /chat/completions로 유지합니다. API 키는 클라이언트 내부에만 붙여넣으세요. /v1이 포함된 Cherry Studio / Zed URL을 붙여넣지 마세요.

    Open Chatbox Settings, go to Model Providers, and click + Add at the bottom of the list. Do not switch to a built-in OpenAI, Gemini, or Claude provider.
    At the bottom of the picker, choose Add custom provider. Do not import from clipboard, and do not pick built-in OpenAI or OpenRouter.
    Name it AI Code With. Set API mode to OpenAI API compatible. Copy the host from this page: https://api.aicodewith.ai with no /v1. Keep the default path /chat/completions — Chatbox inserts /v1 itself, so the preview should be https://api.aicodewith.ai/v1/chat/completions. Paste the API key, then Fetch models; if the list is empty, New and type the Model ID. A passing Check is not a successful connection.

  3. 모델 가져오기 또는 생성 후 확인

    모델 섹션에서 가져오기를 클릭합니다. 목록이 비어 있으면 새로 만들기를 클릭하고 전체 모델 ID를 입력합니다. 채팅 페이지에서 해당 사용자 지정 공급자와 모델을 선택한 후 테스트 메시지를 보냅니다. 정상적인 응답이 오면 설정이 작동하는 것입니다. 그런 다음 AI Code With 사용 기록에서 시간과 모델로 호출을 대조합니다. 설정을 저장하는 것만으로는 충분하지 않습니다.

    모델 ID 복사

    공급자를 추가한 후 Fetch를 클릭하거나 New를 클릭해 다음 모델 ID 중 하나를 입력하세요:

    패밀리를 선택한 다음 모델 ID를 복사하세요. 목록을 Fetch하거나, 비어 있으면 New에서 붙여넣으세요.

    선택됨

    공급자
    DeepSeek
    모델 ID
    deepseek-flash

    전체 모델 목록은 AI Code With 문서와 가격 페이지를 따릅니다. 이 사이트는 별도의 모델 목록을 유지하지 않습니다. ID 앞에 openai/를 붙이지 마세요. Gemini 모델은 해당 모델에서 Google Gemini API compatible 모드가 필요합니다.

    전체 모델 목록 보기

Chatbox는 AI Code With에 어떻게 연결하나요?

Chatbox는 OpenAI 호환 사용자 지정 공급자를 통해 호환 API를 호출합니다. AI Code With 연결은 설정에서만 하면 됩니다:

사용자 지정 공급자
설정 → Model Providers를 열고 + Add를 클릭한 다음 Add custom provider를 선택하세요. 기본 제공 OpenAI 또는 OpenRouter로 전환하지 마세요.
API 호스트
API 모드를 OpenAI API compatible로 설정하세요. /v1 없이 https://api.aicodewith.ai를 입력하세요. 기본 경로 /chat/completions를 유지하세요. Chatbox가 /v1을 자체적으로 넣습니다.
API 키
AI Code With API 키를 붙여넣으세요. 이 키는 이 기기에만 남습니다. 공개 저장소나 스크린샷에 넣지 마세요.
모델 ID
Fetch를 클릭해 목록을 가져오세요. 목록이 비어 있으면 New를 클릭하고 전체 모델 ID(예: deepseek-flash)를 입력하세요. Gemini 모델은 해당 모델의 API 모드를 Google Gemini API compatible로 변경하세요.

흐름: Chatbox → OpenAI 호환 사용자 지정 공급자 → AI Code With API. 먼저 클라이언트를 설치한 다음 설정에서 공급자를 추가하세요. Check 통과는 성공적인 연결을 의미하지 않습니다.

자주 묻는 질문

Chatbox가 설치되어 있지 않나요?

Chatbox 웹사이트에서 사용하는 OS에 맞는 클라이언트를 다운로드하세요. 이 사이트는 설치 파일을 호스팅하지 않습니다.

Chatbox 웹사이트

chatboxai.app을 열고 Windows, macOS 또는 Linux용 설치 파일을 다운로드하세요. 이 연동에는 해당 클라이언트를 사용하세요.

Chatbox 웹사이트 열기

전체 설치 안내는 Chatbox 사이트를 따릅니다. 타사 튜토리얼에 나온 다른 API 호스트를 붙여넣지 마세요.

자주 발생하는 오류 문제 해결

가장 흔한 문제는 4가지 범주로 나뉩니다.

401 / 잘못된 API 키

증상: 메시지를 보내거나 Check를 클릭하면 401, Unauthorized 또는 Invalid API Key가 반환됩니다.

원인: 보통 API 키가 유효하지 않거나, 잘못 입력되었거나, 불필요한 문자와 함께 복사된 경우입니다.

  • 사용자 지정 공급자를 열고 AI Code With API 키를 다시 붙여넣으세요(공백 없이)
  • 키가 유효한 AI Code With API 키인지, 계정에 잔액이 있는지 확인하세요
  • 이 페이지나 공개 저장소에 키를 넣지 마세요
전체 가이드 읽기 →

Model Not Found / 잘못된 모델 ID

증상: 요청에서 Model Not Found, unknown model 또는 404가 보고되거나, 채팅에서 새 모델이 보이지 않습니다.

원인: 모델 ID를 잘못 입력했거나, Gemini가 아직 OpenAI 호환 모드이거나, 현재 해당 모델을 사용할 수 없습니다.

  • 직접 입력하지 말고 이 페이지에서 정확한 모델 ID(예: deepseek-flash)를 복사하세요
  • Gemini 모델의 경우: 해당 모델 설정을 열고 API 모드를 Google Gemini API compatible로 전환하세요
  • 현재 키로 해당 모델에 접근할 수 있는지 확인하세요
전체 가이드 읽기 →

API 호스트 오류(보통 불필요한 /v1)

증상: 메시지를 보내면 실패하거나, 시간 초과가 발생하거나, 잘못된 엔드포인트 경로 / 404가 보고됩니다.

원인: API 호스트에 /v1이 포함되어 있거나, 기본 API 경로가 변경되었거나, 다른 릴레이 도메인을 사용한 경우입니다.

  • 호스트가 https://api.aicodewith.ai인지 확인하세요(/v1 없음)
  • 경로 /chat/completions를 유지하세요. 미리보기는 https://api.aicodewith.ai/v1/chat/completions여야 합니다.
  • 기본 제공 OpenAI가 아니라 방금 추가한 사용자 지정 공급자를 사용 중인지 확인하세요
전체 가이드 읽기 →

가져온 모델 목록이 비어 있음

증상: Fetch가 빈 목록을 반환하거나, 채팅에서 AI Code With 모델을 선택할 수 없습니다.

원인: 호스트에 연결할 수 없거나, 키가 유효하지 않거나, 업스트림이 전체 목록을 반환하지 않는 경우입니다.

  • 호스트와 키를 확인한 다음 다시 Fetch하세요
  • 목록이 여전히 비어 있으면 New를 클릭하고 전체 모델 ID를 입력하세요
  • 저장한 다음 채팅 페이지에서 해당 모델을 선택하고 메시지를 보내세요
전체 가이드 읽기 →

전체 가이드가 필요하신가요?

모든 구성 매개변수, 전체 모델 목록, 추가 문제 해결 방법은 AI Code With 문서에서 확인할 수 있습니다.

AI Code With 문서 열기

출처

관련 링크

AI Code With API 키 만들기모델 및 가격다른 연동 페이지빠른 설정으로 돌아가기