러시아에서 Claude Desktop 사용하기: 추론 게이트웨이 설정

Claude Desktop의 타사 추론이 의미하는 것

일반적으로 Claude Desktop은 Anthropic 계정과 Anthropic 서비스를 사용합니다. 타사 추론은 모델 요청의 경로를 바꿉니다. 애플리케이션이 요청을 구성된 게이트웨이로 보냅니다. 그렇다고 타사 API가 Claude 구독으로 바뀌는 것은 아니며, 설치, 업데이트, 기능 사용 가능 여부에 대한 애플리케이션 자체의 요구 사항도 사라지지 않습니다.

추론 게이트웨이를 Desktop Extensions나 MCP와 혼동하지 마세요. Extensions는 Claude에 로컬 앱과 데이터에 대한 접근을 제공합니다. 게이트웨이는 요청을 모델로 라우팅합니다. 한 계층의 실패가 다른 계층의 고장을 뜻하지는 않습니다.

Anthropic의 현행 문서에 따르면 Claude Desktop은 macOS, Windows 및 Linux beta에서 사용할 수 있습니다. 아래의 Help → Troubleshooting 및 Developer → Configure Third-Party Inference… 메뉴 경로는 macOS용 최신 BetterToken 가이드에서 확인되었습니다. 다른 운영체제에서는 설치된 앱 버전에 동일한 설정이 있는지 먼저 확인하세요.

API Key 그룹에 따라 경로 선택하기

• Claude 그룹: 직접 Anthropic-compatible 게이트웨이. Gateway base URL은 https://www.bettertoken.ai, 인증 방식은 x-api-key입니다.
• Codex 그룹: BetterToken → CC Switch → 로컬 Claude 경로. Gateway base URL은 CC Switch의 Service address, 인증 방식은 bearer입니다.

Codex 그룹에서는 https://www.bettertoken.ai/v1을 Claude Desktop Gateway에 직접 입력하지 마세요. 이는 OpenAI-compatible Base URL이며 Gateway 필드가 기대하는 것은 Anthropic 호환 경로입니다. CC Switch는 OpenAI Responses API를 받고 모델을 매핑한 뒤 Claude Desktop에 로컬 서비스 주소를 제공합니다.

Claude 그룹 직접 설정

1. 최신 Claude Desktop 설치

Claude 공식 페이지에서 앱을 다운로드합니다. Anthropic의 일반 설치 절차에서는 로그인을 요청합니다. BetterToken Gateway 절차는 일반 로그인 이전에 시작되므로 두 모드를 섞지 않도록 게이트웨이 가이드 순서를 따르세요.

2. 개발자 모드 활성화

macOS에서 다음을 엽니다.

Help → Troubleshooting → Enable Developer Mode

Enable을 클릭하고 Claude Desktop을 완전히 종료합니다. 다시 시작하면 Developer 메뉴가 나타나야 합니다.

3. 게이트웨이 설정 열기

다음으로 이동합니다.

Developer → Configure Third-Party Inference…

Gateway를 선택하고 다음을 입력합니다.

Gateway base URL: https://www.bettertoken.ai
Gateway API key: Token management의 내 API Key
Gateway auth scheme: x-api-key

키를 글, 스크린샷, 공개 로그 또는 저장소에 넣지 마세요. x-api-key를 선택한 후 앱은 Claude 그룹에서 사용할 수 있는 모델을 요청해야 합니다.

4. 설정 적용 및 재시작

Apply locally를 클릭한 다음 Relaunch now를 클릭합니다. 시작 후 Continue with Gateway를 선택합니다. 왼쪽 하단의 Cowork 3P | Gateway 표시는 경로가 활성화되었음을 뜻합니다.

Codex 그룹용 로컬 경로

이 경로는 더 깁니다. Claude Desktop이 로컬 CC Switch 주소에 연결하고 CC Switch가 요청을 BetterToken OpenAI Responses API로 보냅니다.

1. CC Switch에 BetterToken을 provider로 추가

Claude Code를 열고 Add Provider를 클릭한 뒤 입력합니다.

Provider Name: BetterToken
Base URL: https://www.bettertoken.ai
API Key: 내 BetterToken API Key

Advanced Options에서 OpenAI Responses API를 선택합니다. 이어서 Fetch Model List를 클릭하고 사용 가능한 mapping 필드에 모델을 명시적으로 할당합니다. Codex 그룹의 현재 ID만 사용하고 오래된 글이나 다른 사람의 스크린샷에서 모델을 복사하지 마세요.

2. 로컬 경로 활성화

provider를 저장하고 In use로 설정한 뒤 proxy를 활성화합니다. Settings → Routing에서 마스터 스위치와 Claude route를 확인합니다. 표시된 Service address를 복사하세요. 이것이 Claude Desktop에 필요한 로컬 주소입니다.

3. Claude Desktop의 Gateway 필드 입력

Developer → Configure Third-Party Inference…로 돌아가 Gateway를 선택하고 입력합니다.

Gateway base URL: CC Switch의 Service address
Gateway API key: 내 BetterToken API Key
Gateway auth scheme: bearer

Model list에서 CC Switch에 설정한 현재 Model ID와 Display name을 추가합니다. Apply locally를 클릭하고 Relaunch now를 승인한 다음 Continue with Gateway를 선택합니다.

요청 및 Dashboard 기록 확인

작업 디렉터리 접근이나 긴 작업으로 시작하지 마세요. 개인정보가 없는 짧은 요청(예: JSON 배열과 객체의 차이를 묻는 질문)을 보낸 뒤 BetterToken Dashboard를 엽니다.

성공적인 확인에는 두 가지 신호가 있습니다.

1. Claude Desktop이 응답과 활성 Cowork 3P | Gateway 모드를 표시합니다.
2. Dashboard가 시간, 모델, status, input/output/cache tokens 및 청구액이 일치하는 기록을 표시합니다.

응답은 있지만 기록이 없으면 앱이 다른 모드가 아니라 실제로 Gateway를 사용 중인지 확인하세요. 오류 status가 있는 기록이 표시되면 경로가 API 계층까지 도달한 것입니다. Key 그룹, 인증 방식, 모델, 잔액을 확인하세요. Dashboard를 전체 prompt나 응답의 저장소로 사용하지 마세요. 지원팀에 연락하기 전에 로그에서 키와 요청 내용을 제거하세요.

Claude Desktop이 연결되지 않을 때 확인할 사항

• Developer 메뉴가 없음: 개발자 모드를 다시 켜고 창만 닫지 말고 Claude Desktop을 완전히 종료합니다.
• Your provider setup needs a fix: Model list, 현재 ID 및 CC Switch의 필수 mapping을 모두 확인합니다.
• 401 또는 403: Claude 그룹에는 x-api-key, Codex 그룹의 로컬 경로에는 bearer를 선택합니다.
• 응답과 Dashboard 기록이 모두 없음: CC Switch에서 proxy, Routing 마스터 스위치 및 Claude route가 활성화되어 있는지 확인합니다.
• 기록은 있지만 요청이 실패함: Key 그룹, 현재 모델, 사용 가능한 잔액 및 키의 불필요한 공백을 확인합니다.
• Apply locally 후 아무 변화가 없음: Relaunch now를 클릭한 뒤 Continue with Gateway를 선택합니다.

하나의 인터페이스 라벨만 보고 Gateway를 진단하지 마세요. Claude Desktop 모드, 로컬 경로 상태, Dashboard 요청 기록을 함께 대조하면 어느 계층에서 연결이 끊겼는지 알 수 있습니다.

이 방법의 제한 사항

BetterToken은 독립 API 제공업체이며 Anthropic 제품도 Claude 구독의 대체품도 아닙니다. BetterToken은 자체 API Endpoint와 설정 문서를 책임집니다. 다운로드 접근, 로그인, 업데이트, Cowork, Code mode 및 다른 Claude Desktop 기능은 현재 앱 버전, 플랜 및 Anthropic 규칙에 따라 달라집니다.

러시아에서 BetterToken API Endpoint에 연결할 때 VPN은 필요하지 않습니다. 이 설명은 Claude 웹사이트, 앱 다운로드, 계정 또는 외부 서비스를 포함하지 않습니다. 메뉴 항목이 이 글과 다르면 중지하고 Claude Desktop 공식 설치 문서와 최신 BetterToken 설정 가이드를 비교하세요.

FAQ

https://www.bettertoken.ai/v1을 Claude Desktop Gateway에 넣을 수 있나요?

여기에서 설명한 워크플로에서는 안 됩니다. 이것은 OpenAI-compatible 주소입니다. Claude 그룹은 직접 Anthropic-compatible endpoint https://www.bettertoken.ai를 사용하고 Codex 그룹은 CC Switch의 로컬 Service address를 통해 연결합니다.

Gateway 모드에 Claude 계정이 필요한가요?

Anthropic의 일반 지침은 설치 후 로그인하도록 안내합니다. 현재 BetterToken Gateway 가이드는 일반 로그인 전에 Continue with Gateway를 진행하도록 안내합니다. 한 모드의 단계를 다른 모드로 옮기지 말고, 설치된 Claude Desktop 버전의 인터페이스를 확인하세요.

올바른 인증 방식을 어떻게 알 수 있나요?

직접 Claude 그룹에는 x-api-key를 사용합니다. CC Switch를 통해 로컬로 라우팅하는 Codex 그룹에는 bearer를 사용합니다. 설정을 적용한 후 Desktop 응답과 새로운 Dashboard 기록을 모두 확인하세요.