Home → Guides → Claude 데스크톱과 Codex를 APICLAN으로 연결하기

Claude 데스크톱과 Codex를 APICLAN으로 연결하기

Q: 입력할 주소와 /v1 규칙

모든 요청은 /v1로 시작하는 경로에 도착해야 합니다. 클라이언트에 /v1을 직접 입력할지는 클라이언트에 따라 다릅니다. 스스로 붙이는 것도 있고 그렇지 않은 것도 있습니다. '연결이 안 된다'는 문의 대부분이 바로 이 한 가지입니다. 거꾸로 넣으면 요청은 엣지에서 404가 납니다. 즉 게이트웨이에 도달하지 못했고 사용 로그에도 남지 않습니다. 로그가 비어 있다는 것 자체가 증상입니다. 주소 끝에 슬래시를 붙이지 마세요.

데스크톱 앱 설정에는 base URL을 입력하는 칸이 없습니다. 그 설정은 CC Switch가 대신 작성합니다. 무엇을 입력해야 하는지, 그리고 설정 실패의 거의 전부를 차지하는 두 가지 원인을 정리했습니다.

시작하기 전에

잔액이 있는 계정과 API 키가 필요합니다. 콘솔의 'API 키'에서 생성하세요. 호출할 벤더 계열을 고르고(Claude 데스크톱은 Anthropic, Codex는 OpenAI), 그다음 비용을 차감할 키 그룹을 선택합니다. 그룹이 단가를 결정하며, 모델별 가격은 가격 페이지에 있습니다.

키 하나는 정확히 한 그룹에만 속합니다. 텍스트 모델용으로 만든 키로는 이미지 모델을 호출할 수 없고 그 반대도 마찬가지이며, 이때는 권한 오류가 아니라 모델 404가 돌아옵니다. 둘 다 필요하면 키를 두 개 만드세요. 특정 키로 무엇을 호출할 수 있는지는 그 키로 GET /v1/models를 보낸 결과가 언제나 정답입니다.

입력할 주소와 /v1 규칙

모든 요청은 /v1로 시작하는 경로에 도착해야 합니다. 클라이언트에 /v1을 직접 입력할지는 클라이언트에 따라 다릅니다. 스스로 붙이는 것도 있고 그렇지 않은 것도 있습니다. '연결이 안 된다'는 문의 대부분이 바로 이 한 가지입니다.

클라이언트	입력할 요청 주소
Claude Desktop (via CC Switch)	`https://apiclan.us/v1`
Codex / ChatGPT desktop app	`https://apiclan.us/v1`
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	`https://apiclan.us/v1`
Cursor, Cline, Roo Code	`https://apiclan.us/v1`
Claude Code	`https://apiclan.us`
Anthropic SDK	`https://apiclan.us`

거꾸로 넣으면 요청은 엣지에서 404가 납니다. 즉 게이트웨이에 도달하지 못했고 사용 로그에도 남지 않습니다. 로그가 비어 있다는 것 자체가 증상입니다. 주소 끝에 슬래시를 붙이지 마세요.

Codex는 이제 ChatGPT 데스크톱 앱에 포함됩니다

Codex는 ChatGPT 데스크톱 애플리케이션에 통합되었습니다. Windows에서는 Microsoft Store에서 ChatGPT를 설치하고, macOS에서는 OpenAI 사이트에서 내려받습니다. 명령줄 Codex도 설정 방식은 같습니다.

CC Switch에서 Codex용 공급자를 추가하고 키를 붙여넣은 뒤 요청 주소에 https://apiclan.us/v1을 입력하세요. 해당 공급자를 활성화한 다음 Codex를 완전히 종료하고(창만 닫는 것으로는 부족합니다) 다시 실행합니다. 설정은 실행 시점에만 읽히므로, 실행 중인 인스턴스는 이전 설정을 계속 사용해 아무 일도 일어나지 않은 것처럼 보입니다.

CC Switch 대신 설정 파일을 직접 수정하고 싶다면, base URL과 키를 넣는 위치는 퀵스타트에 정리되어 있습니다.

Claude 데스크톱 앱

claude.com에서 Claude 데스크톱 앱을 설치한 뒤 CC Switch에서 공급자를 설정합니다.

CC Switch를 열고 Claude 데스크톱을 선택한 다음 새 공급자를 추가합니다.
이름은 자유롭게 정하고, APICLAN 키를 API Key 칸에 붙여넣습니다.
요청 주소에 https://apiclan.us/v1을 입력합니다. 클라이언트가 뒤에 /messages를 붙입니다. 끝에 슬래시는 넣지 않습니다.
저장한 뒤 Claude 데스크톱 앱을 실행하고 모델을 선택합니다.

CC Switch가 '직접 연결'과 '모델 매핑' 중에서 고르라고 하면, 고르기 전에 다음 절을 읽어보세요. 이 설정이 모델 선택의 작동 여부를 결정합니다.

모델 선택에서 게이트웨이 오류가 날 때

연결은 되지만 공급자가 요청을 거부했다는 안내는 거의 항상 키가 아니라 모델 이름 문제입니다. 데스크톱 앱은 자체 내장 모델 식별자를 보내는데, 게이트웨이는 상위 계정이 실제로 제공하는 모델만 서비스할 수 있습니다.

직접 연결 대신 모델 매핑으로 해결합니다. 앱의 항목을 이 게이트웨이가 제공하는 이름에 매핑하세요. 직접 연결은 공급자가 앱이 보내는 식별자를 그대로 받아줄 때만 동작합니다.

키를 붙여 GET /v1/models를 보내면 매핑에 쓸 목록을 받을 수 있습니다. 이 목록은 해당 키가 속한 그룹을 기준으로 생성되므로, 일반 카탈로그가 아니라 당신 계정에 대한 실제 답입니다.

공식 계정으로 되돌리기

영구적으로 덮어써지는 것은 없습니다. CC Switch에서 공식 공급자를 다시 활성화하고 클라이언트를 재시작하면 데스크톱 앱은 구독으로 돌아갑니다. 둘 다 설정해 두고 원할 때 전환할 수 있습니다. 여기 잔액은 선불이고 만료되지 않으므로, 쓰지 않는 설정을 남겨두어도 비용이 들지 않습니다.

그래도 안 될 때

404가 나고 사용 로그에도 아무것도 없다면 주소가 틀린 것입니다. 위 표에서 해당 클라이언트에 /v1이 필요한지 확인하고, 끝의 슬래시를 지우세요.
401이 난다면 키가 요청에 실리지 않은 것입니다. 다시 붙여넣으세요. 긴 문자열이라 일부만 복사되면 잘못된 키와 똑같이 실패합니다.
같은 키로 다른 모델은 되는데 하나만 실패한다면, 그 모델은 다른 그룹에 있습니다. 올바른 그룹을 선택해 키를 하나 더 만드세요. 권한 변경으로는 해결되지 않습니다.

그래도 막힌다면 실패한 모델 이름과 대략적인 시각을 support@apiclan.us로 보내주세요. 사람이 직접 읽습니다.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.