AingDesk × AI Code With
AingDesk에서 AI Code With 사용하기: 타사 API / 릴레이 설정
이 페이지에서는 오픈소스 데스크톱 어시스턴트인 AingDesk에서 서드파티 API를 연결하여 사용자 지정 공급자를 통해 모델과 지식 베이스를 로컬에서 사용하는 방법을 보여줍니다.
먼저 AingDesk를 다운로드하고 설치한 다음 앱에서 사용자 지정 공급자를 추가하세요. 키는 클라이언트에만 입력하고 이 페이지에는 절대 입력하지 마세요.
- 공급자 이름
- AI Code With
- API URL
- https://api.aicodewith.ai/v1
- API Key
- sk-xxxxxxxx
- 모델 ID
- claude-sonnet-4-6
빠른 설정
나중에 사용할 터미널을 위해 이 키를 저장하세요
이 도구는 키를 자체 설정에 저장합니다. 로그인한 후 키를 복사하여 아래 단계의 API 키 필드에 붙여넣으세요.
sk-***로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기
복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법
AingDesk에서 모델 공급자를 추가하세요: "공급자 이름", "API URL", "API 키"를 입력한 후 모델을 선택하세요. 약 3분 소요됩니다.
AingDesk는 데스크톱 클라이언트입니다(UI는 중국어이며 아래의 라벨은 영어로 제공됩니다). 시작 페이지 또는 사이드바의 "타사 모델 API"를 열고 모델 공급자를 추가한 다음 "공급자 이름", "API URL", "API 키"를 입력하고 모델을 동기화한 후 테스트 메시지를 보내세요.
"타사 모델 사용" 선택
AingDesk를 처음 열면 시작 페이지가 나타납니다. 빨간색 상자의 "타사 모델 사용"을 클릭하면 "타사 API 설정" 페이지로 이동합니다. 시작 페이지가 이미 닫혀 있다면 사이드바의 "타사 모델 API"를 대신 사용하세요. 진입할 수 없으면 #errors를 참조하세요. 다음: "모델 공급자 추가"를 클릭하세요.
On first launch of AingDesk, click 「使用第三方模型」 on the welcome page. The sidebar 「第三方模型API」 is another way in. "모델 공급자 추가" 클릭
"타사 API 설정" 창 하단에서 "모델 공급자 추가"를 클릭하세요(SiliconFlow 같은 기본 제공 타일은 클릭하지 마세요). "모델 공급자 추가" 양식이 열립니다. 버튼이 보이지 않으면 창을 닫고 타사 API 설정을 다시 여세요. 그래도 안 되면 #errors를 참조하세요. 다음: 세 필드를 입력하고 "확인"을 클릭하세요.
At the bottom of 「第三方API配置」, click 「添加模型服务商」. The built-in supplier on the right (硅基流动) is not this page's path. "공급자 이름", "API URL", "API 키" 입력
"모델 공급자 추가" 대화상자에서 "공급자 이름"(AI Code With로 충분), "API URL" https://api.aicodewith.ai/v1(도움말 텍스트는 OpenAI 호환 엔드포인트를 요구합니다), "API 키"를 입력한 후 "확인"을 클릭하세요. 성공하면 저장된 공급자 페이지로 이동하고 /models를 가져오기 시작합니다. "확인"이 멈추거나 목록이 비어 있으면 #errors를 참조하세요. 다음: 모델 목록을 확인하거나 수동으로 "모델 추가"를 클릭하세요.
Fill 供应商名称, 接口地址 https://api.aicodewith.ai/v1, and 密钥, then click 「确认」. Paste the AI Code With key into the 密钥 field. 모델 동기화 또는 "모델 추가"
저장 후 목록은 기본적으로 /models에서 자동으로 채워집니다. 스크린샷의 chatgpt-4o-latest 같은 ID는 릴레이 카탈로그이지 이 페이지의 모델 ID가 아닙니다. 필요한 모델을 켜세요. 이 페이지의 ID가 없다면 "모델 추가"를 클릭하고 모델 ID를 붙여넣은 다음 모델 별칭을 직접 설정하고 모델 유형을 LLM으로 설정하세요. 목록이 비어 있거나 ID를 찾을 수 없으면 #errors를 참조하세요. 다음: 채팅으로 돌아가 테스트 메시지를 보내세요.
모델 ID 복사
저장 후 AingDesk는 「默认从/models获取所有模型」을 통해 목록을 채웁니다. 아래에서 Model ID를 복사하세요. 없으면 「添加模型」을 클릭해 붙여넣고 模型功能을 LLM으로 설정하세요.
패밀리를 선택한 다음 Model ID를 복사하세요. 接口地址는 모든 모델에서 동일합니다.
선택됨
- 공급자
- Claude
- 모델 ID
- claude-sonnet-5-5
전체 카탈로그는 AI Code With 문서 및 가격 페이지를 따릅니다. 스크린샷의 chatgpt-4o-latest 같은 이름은 자동 동기화만 보여줍니다. 이 페이지의 ID를 사용하세요.
전체 모델 목록 보기IDs in the list such as chatgpt-4o-latest are a relay catalog, not Model IDs from this page. When you enable a model or click 「添加模型」, paste an ID copied here. "모델 선택" 사용 및 테스트 보내기
채팅으로 돌아가 상단 표시줄에서 "모델 선택"을 클릭하고 방금 추가한 모델을 선택한 후 테스트 메시지를 보내세요. 스크린샷은 모델이 선택되지 않고 아직 응답이 없는 상태로 끝납니다. 성공 = 실제 응답이 오는 것이며, 이후 AI Code With 사용 기록에서 시간과 모델을 대조하세요. "확인"을 연결됨으로 간주하지 마세요. 응답이 없으면 #errors를 참조하세요.
Return to chat. The top bar still shows 「请选择模型」 (the screenshot has not sent a message). Click 「请选择模型」, pick the model you just added, and send a test. Success = a real reply + a usage record. Do not treat 「检查」 as success.
AingDesk는 AI Code With에 어떻게 연결하나요?
AingDesk는 사용자 지정 공급자를 통해 OpenAI 호환 엔드포인트와 통신합니다. AI Code With에 연결한다는 것은 모델 공급자를 추가하고 接口地址와 密钥를 입력한 다음 모델을 선택하는 것을 의미합니다:
- 「使用第三方模型」 선택
- 처음 실행하면 시작 페이지가 표시됩니다. 「使用第三方模型」을 클릭하여 「第三方API配置」를 여세요. 시작 페이지가 없다면 사이드바의 「第三方模型API」를 사용하세요.
- 「添加模型服务商」 클릭
- 「第三方API配置」 하단에서 「添加模型服务商」를 클릭하세요(내장 硅基流动 타일이 아님). 「添加模型服务商」 양식이 열립니다.
- 「供应商名称」, 「接口地址」, 「密钥」 입력
- 供应商名称은 AI Code With로 설정할 수 있습니다. 接口地址를 https://api.aicodewith.ai/v1로 설정하세요(도움말 텍스트: 需要兼容openAI格式的接口). AI Code With 키를 密钥에 붙여넣은 다음 「确认」을 클릭하세요. /chat/completions를 추가하지 마세요.
- 모델 동기화 또는 「添加模型」
- 저장 후 목록은 「默认从/models获取所有模型」을 통해 채워집니다. chatgpt-4o-latest 같은 이름은 릴레이 카탈로그이며 이 페이지의 Model ID가 아닙니다. 이 페이지의 ID가 없으면 「添加模型」을 클릭하고 붙여넣은 다음 模型功能을 LLM으로 설정하세요.
- 「请选择模型」 사용 및 테스트 전송
- 채팅으로 돌아가 「请选择模型」을 클릭하고 방금 추가한 모델을 선택한 다음 테스트 메시지를 보내세요. 성공은 실제 응답을 받는 것이며, 그다음 사용량 기록과 대조하세요. 「检查」를 연결됨으로 간주하지 마세요.
흐름: AingDesk → 사용자 지정 공급자(供应商名称 + 接口地址 /v1 + 密钥) → AI Code With API. 모든 작업은 GUI에서 수행합니다. 편집할 파일은 없습니다.
자주 묻는 질문
AingDesk가 처음이신가요?
AingDesk는 Windows 및 macOS용 오픈소스 데스크톱 AI 어시스턴트입니다.
AingDesk 다운로드 페이지
사용 중인 OS용 설치 파일을 AingDesk 다운로드 페이지에서 다운로드하세요. 설치 후 AingDesk를 열고 시작 페이지 또는 사이드바에서 서드파티 모델 설정을 시작하세요.
AingDesk 다운로드 페이지 열기Intel Mac은 더 이상 지원되지 않습니다. Docker :7071은 서버이며 이 페이지의 기본 경로가 아닙니다. 전체 설치 안내는 AingDesk 사이트를 따릅니다. 이 사이트는 설치 파일을 호스팅하지 않습니다.
일반적인 오류 문제 해결
가장 빈번한 문제는 4가지 범주로 나뉩니다.
모델 목록 비어 있음 / Confirm 멈춤
증상: 「确认」이 멈추거나, 저장 후 「默认从/models获取所有模型」이 여전히 비어 있습니다.
원인: AingDesk는 接口地址를 그대로 사용해 {baseUrl}/models를 GET하며 /v1을 자동으로 추가하지 않습니다. /v1 누락, /chat/completions 추가, 잘못된 키, 업스트림 카탈로그 비어 있음은 모두 빈 목록을 만듭니다. 전체 카탈로그를 가져오는 동안 Confirm이 멈출 수 있습니다(#105).
- 接口地址를 https://api.aicodewith.ai/v1로만 설정하세요 — /chat/completions를 추가하지 마세요
- 목록이 비어 있으면 「添加模型」을 클릭하고 이 페이지의 Model ID를 붙여넣으세요
- 模型功能을 LLM으로 설정하세요
채팅 선택기에 새 모델이 없음 / Ollama만 표시됨
증상: 공급자를 추가한 후 「请选择模型」에 해당 모델이 나열되지 않거나 Ollama만 나타납니다.
원인: 공급자 스위치가 꺼져 있음, 모델 추가 후 목록이 새로 고쳐지지 않음(#50), title===""인 가져온 모델이 필터링됨, 다른 공급자가 선택기를 가득 채움(#92)입니다.
- 이 공급자를 활성화하고 다른 공급자는 비활성화하세요
- 목록이 새로 고쳐지도록 「第三方模型API」를 닫았다가 다시 여세요
- 필요하면 模型ID와 模型别名을 직접 입력하세요
「检查」가 성공이라고 해도 전송 실패
증상: 저장된 공급자 패널에서 「检查」가 구성이 올바르다고 표시하지만, 전송 시 401, 응답 없음 또는 예기치 않은 중단이 발생합니다.
원인: 「检查」와 「保存API」는 이미 저장된 공급자 패널에만 나타납니다. 「检查」는 스텁으로, 네트워크에 요청하지 않고 항상 성공을 반환합니다. 실제 검증은 채팅 응답과 AI Code With 사용량 기록입니다.
- AI Code With 키를 다시 붙여넣으세요. 检查成功을 接入成功으로 간주하지 마세요
- 接口地址에 /v1이 포함되어 있는지 확인하세요
- 테스트 메시지를 보낸 다음 사용량 기록에서 시간과 모델로 호출을 대조하세요
동기화된 목록이 릴레이 카탈로그임 / 모델을 찾을 수 없음
증상: 저장 후 긴 목록이 보이지만 이 페이지의 Model ID가 없거나, 전송 시 모델이 존재하지 않는다고 표시됩니다.
원인: /models는 이 키의 ID가 아니라 업스트림 카탈로그를 반환합니다. 토글은 채팅에서 모델을 제거하지 않습니다(#92). 직접 삭제해야 합니다. 스크린샷 4는 이를 보여줍니다. chatgpt-4o-latest 같은 이름은 릴레이 카탈로그입니다.
- 「添加模型」을 클릭하고 이 페이지의 Model ID를 붙여넣으세요
- 接口地址에 /chat/completions를 추가하지 마세요
- 해당 키로 그 모델에 접근할 수 있는지 확인하세요