Coding Agent 설정

Claude Desktop의 BetterToken 연결

Gateway 엔드포인트, BetterToken API Key, Claude 모델로 Claude Desktop을 연결하세요. 인증, 모델 선택, 재시작과 오류 해결 방법을 확인하세요.

Claude Desktop은 Claude 모델만 지원합니다. 이는 Claude Desktop 클라이언트의 제한입니다.

모델 광장에서 사용 가능한 Claude Model ID를 복사하고 저장한 뒤 Claude Desktop을 다시 시작하세요.

주요 설정

필드	값
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
모델	모델 광장에서 사용 가능한 Claude Model ID를 복사하고 저장한 뒤 Claude Desktop을 다시 시작하세요.

사전 요구 사항

BetterToken API Key를 만들고 복사
모델 광장에서 정확한 Model ID를 복사하세요.

구독과 API 결제를 분리하기

Gateway 요청은 BetterToken API Key와 BetterToken 잔액을 사용합니다. Claude 구독 한도를 사용하거나 연장하지 않습니다. 구독과 API를 별도의 액세스 및 결제 경로로 취급하세요.

실제 작업에 사용하기 전에 다음을 확인하세요.

Claude Desktop 전용 BetterToken API Key를 만듭니다.
Gateway를 통해 민감한 정보가 없는 짧은 테스트 메시지를 보냅니다.
BetterToken Dashboard를 열고 모델, 상태, input, output, cache Token, 청구액을 확인합니다.
Key가 스크린샷, 저장소 또는 공개 로그에 노출되었다면 폐기하고 새 Key를 만듭니다.

설치

Claude Desktop website에서 최신 version을 설치하거나 업데이트한 다음 Claude Desktop을 시작하세요.

수동 설정

developer mode 활성화

Claude Desktop에서 macOS menu bar의 Help → Troubleshooting → Enable Developer Mode를 선택하세요.

Claude Desktop Help menu에서 Enable Developer Mode를 선택합니다.

confirmation window에서 Enable을 클릭한 다음 Claude Desktop을 다시 시작하세요.

third-party inference settings 열기

restart 후 macOS menu bar에서 Developer → Configure Third-Party Inference…를 선택하세요.

Developer menu에서 Configure Third-Party Inference를 선택합니다.

BetterToken API settings 입력

Gateway를 선택한 다음 다음을 입력하세요.

필드	값
Gateway base URL	`https://bettertoken.ai`
Credential kind	`Static API key`
Gateway API key	BetterToken API Key
Gateway auth scheme	`x-api-key`

인증 방식을 선택하면 Claude Desktop이 사용 가능한 Claude 모델을 가져옵니다. Apply Changes를 클릭해 이 기기에 설정을 저장하고 Claude Desktop을 다시 시작하세요. 이전 버전에서는 Apply locally 다음에 Save & Restart가 표시될 수 있습니다.

Claude Desktop에서 BetterToken Gateway Base URL, API Key 및 authentication scheme를 입력합니다.

연결 확인

Claude Desktop이 다시 시작되면 Continue with Gateway를 선택하고 짧은 메시지를 보내세요. 왼쪽 아래에 Gateway가 표시되고 메시지에 정상적으로 응답하면 설정이 적용된 것입니다.

Claude Desktop이 BetterToken Gateway를 통해 열려 사용 가능한 상태입니다.

모델 전환

모델 선택기를 열고 Gateway가 반환한 다른 Claude 모델을 선택하세요. 모델이 없다면 **Configure Third-Party Inference…**를 다시 열고 Apply Changes를 클릭해 저장하고 Claude Desktop을 다시 시작하세요.

일반적인 오류

문제	해결 방법
Gateway가 연결할 수 없음	Gateway base URL에는 정확히 `https://bettertoken.ai`을 사용하세요. `/v1`을 추가하지 마세요.
Request가 `401`을 반환함	BetterToken API Key를 다시 복사하고 auth scheme가 `x-api-key`인지 확인하세요.
Claude models가 표시되지 않음	모델 광장에서 사용 가능한 Claude Model ID를 복사하고 저장한 뒤 Claude Desktop을 다시 시작하세요.
Configuration이 적용되지 않음	Claude Desktop을 완전히 종료하고 다시 연 다음 Continue with Gateway를 선택하세요.