CC Switch에서 BetterToken 설정

CC Switch는 Claude Code, Claude Desktop, Codex CLI, OpenCode, OpenClaw의 API Key, 엔드포인트, 모델 설정을 관리하는 선택적 데스크톱 앱입니다.

CC Switch 설치

macOS

Homebrew가 가장 쉬운 방법입니다. GitHub Releases에서 최신 .dmg 또는 .zip을 다운로드할 수도 있습니다.

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

GitHub Releases에서 최신 CC-Switch-v{version}-Windows.msi installer 또는 portable .zip build를 다운로드하세요.

Linux

GitHub Releases에서 최신 .deb, .rpm 또는 .AppImage build를 다운로드하세요.

준비할 항목

• BetterToken API Key(여기에서 등록)
• Claude Code는 Anthropic protocol을 사용하므로 Base URL은 https://bettertoken.ai입니다
• Codex, OpenCode 및 OpenClaw는 OpenAI-compatible protocol을 사용하므로 Base URL은 https://bettertoken.ai/v1입니다
• Codex, OpenCode 및 OpenClaw용 현재 모델 ID 하나를 준비하세요. BetterToken 모델 광장에서 복사하거나 CC Switch가 /v1/models에서 가져오게 할 수 있습니다

처음 실행하면 CC Switch가 기기에서 찾은 기존 configs를 자동으로 가져옵니다. official provider를 fallback으로 유지하고 BetterToken을 함께 추가할 수 있습니다.

BetterToken은 Anthropic과 OpenAI-compatible의 두 access modes를 사용합니다. https://bettertoken.ai과 https://bettertoken.ai/v1이 섞이지 않도록 Claude Code와 OpenAI-compatible tools를 하나의 universal provider에 억지로 넣기보다 app별 provider를 만드는 편이 좋습니다.

BetterToken provider 추가

Claude Code

CC Switch에서 Claude Code를 선택하고 Add Provider를 클릭하세요.

BetterToken API Key, Base URL https://bettertoken.ai, 사용할 Model ID를 설정해 Claude Code를 연결하세요.

• Provider Name: BetterToken
• API Key: YOUR_API_KEY
• API Endpoint: https://bettertoken.ai

Anthropic Messages API 형식을 사용하세요. Model Mapping에 선택한 Model ID를 입력하고 저장하세요.

모델 광장에서 정확한 Model ID를 복사하세요.

설정을 저장하고 BetterToken을 활성화한 뒤 클라이언트를 완전히 다시 시작하세요.

Claude Desktop

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

CC Switch의 별도 Claude Desktop 페이지에서 provider를 추가하거나 기존 Claude Code provider를 가져오세요. 활성화하기 전에 가져온 Claude Model ID와 연결 모드를 확인하세요. 공식 Claude Desktop 매뉴얼을 참고하세요.

Claude Desktop에서 직접 설정하려면 Claude Desktop 가이드에 따라 Gateway, Base URL https://bettertoken.ai, BetterToken API Key, Gateway auth scheme x-api-key를 설정하세요. Apply Changes를 클릭해 저장하고 Claude Desktop을 다시 시작하세요.

Codex

현재 CC Switch에서 공식 로그인을 유지하려면 먼저 공식 계정으로 로그인합니다. 설정 → 앱 설정 → Codex에서 인계 없이 전환할 때 공식 로그인 유지를 켜고 BetterToken을 추가하거나 활성화합니다. 공식 로그인 파일을 타사 Key로 덮어쓰지 마세요.

CC Switch에서 Codex를 열고 provider 추가

CC Switch를 열고 Codex로 전환한 다음 Add Provider를 클릭하세요. CC Switch가 먼저 preset 선택을 요구하면 OpenAI Compatible 또는 Custom을 우선 선택하세요.

스크린샷의 번호 표시는 다음 작업과 일치합니다.

1. Codex로 전환
2. 오른쪽 위의 Add Provider 클릭

기본 필드 입력

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: BetterToken API Key

custom config view로 전환하면 underlying config가 wire_api = "responses"를 사용하는지 확인하세요.

스크린샷의 번호 표시는 다음 필드와 일치합니다.

1. Provider Name
2. API Key
3. Base URL

model 가져오기 및 mapping

Fetch Models를 클릭하고 모델 광장에서 현재 Model ID를 선택하세요. Codex에는 CC Switch proxy가 필요하지 않습니다.

저장 및 전환

저장 후 BetterToken을 활성화합니다. 타사 API Key는 config.toml의 provider 설정에 저장되며 로그인 유지 스위치가 공식 auth.json의 보존을 제어합니다.

저장 후 list로 돌아가 BetterToken entry가 In Use로 표시되는지 확인하세요.

OpenCode

CC Switch에서 OpenCode를 열고 provider 추가

CC Switch를 열고 OpenCode로 전환한 다음 Add Provider를 클릭하세요. CC Switch가 먼저 preset을 요구하면 OpenAI Compatible 또는 Custom을 우선 선택하세요.

기본 필드 입력

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: BetterToken API Key
• API Format: OpenAI Compatible

default model 선택

가능하면 Fetch Models를 사용하세요. model을 직접 입력해야 하면 BetterToken 모델 광장의 현재 모델 ID를 사용하세요.

OpenCode는 저장된 provider configuration을 직접 읽으며 CC Switch proxy가 필요하지 않습니다.

저장 및 전환

CC Switch에서 provider를 추가한 다음 OpenCode 안에서 BetterToken provider와 모델을 선택하세요. CC Switch는 기존 OpenCode provider와 함께 이 provider를 설정에 추가합니다.

OpenClaw

CC Switch에서 OpenClaw를 열고 provider 추가

CC Switch를 열고 OpenClaw로 전환한 다음 Add Provider를 클릭하세요. CC Switch가 먼저 preset을 요구하면 OpenAI Compatible 또는 Custom을 우선 선택하세요.

기본 필드 입력

• Provider Name: BetterToken
• Base URL: https://bettertoken.ai/v1
• API Key: BetterToken API Key
• API Format: OpenAI Responses API

custom OpenClaw provider config를 수정하는 경우 api가 openai-responses로 설정되었는지 확인하세요.

default model 선택

가능하면 Fetch Models를 사용하세요. model을 직접 입력해야 하면 현재 모델 ID를 사용하세요.

OpenClaw는 저장된 provider configuration을 직접 사용하며 CC Switch proxy가 필요하지 않습니다.

저장 및 전환

CC Switch에서 provider를 추가한 다음 OpenClaw 안에서 BetterToken provider와 모델을 선택하세요. CC Switch는 기존 OpenClaw provider와 함께 이 provider를 설정에 추가합니다.

저장한 변경 사항 적용

provider를 저장하고 전환한 후 설정을 확인하기 전에 영향을 받는 client 또는 gateway를 다시 시작하세요.

• Claude Code: 현재 Claude Code session을 완전히 종료한 다음 다시 시작합니다.
• Claude Desktop: app을 완전히 종료하고 다시 열어 왼쪽 아래에 Gateway가 표시되는지 확인합니다.
• Codex: 현재 Codex process를 다시 시작하거나 새 terminal session을 엽니다.
• OpenCode: 현재 OpenCode session을 종료하고 다시 시작합니다.
• OpenClaw: openclaw gateway restart를 실행한 후 Discord에서 /new, /status 및 /model을 사용합니다.

CC Switch 전용 고급 기능

CC Switch는 직접 전환 시 Codex 공식 로그인을 유지할 수 있습니다. Codex 세션 기록 통합은 선택 사항이며 CLI의 resume 목록에만 영향을 줍니다. 현재 데스크톱만 사용한다면 필요하지 않습니다. 다른 provider에서 이전 세션을 이어 가면 실패할 수 있으므로 전환 후 새 세션을 시작하세요. 공식 로그인과 세션 기록을 참고하세요.

일반적인 문제

• /v1을 Claude Code Base URL에 추가하지 마세요

• Codex, OpenCode 및 OpenClaw는 https://bettertoken.ai/v1을 사용해야 합니다

• Codex, OpenCode 또는 OpenClaw가 model을 요청하면 모델 ID를 사용하세요

• Fetch Models가 실패하면 API Key와 Base URL을 확인한 뒤 model ID를 수동으로 붙여넣으세요

• 변경 사항이 적용되지 않으면 Codex의 경우 CC Switch에서 BetterToken이 활성화되어 있는지, OpenCode/OpenClaw의 경우 해당 앱 안에서 BetterToken을 선택했는지 확인한 뒤 위 안내에 따라 클라이언트나 게이트웨이를 다시 시작하세요

• 공식 사용량을 모두 소진한 뒤 Codex가 전송을 차단한다면 공식 로그인을 유지하는 동안 차단도 유지될 수 있습니다. 공식 릴리스 안내에 따라 직접 연결 모드로 전환하고 설정 → 앱 설정 → Codex에서 인계 없이 전환할 때 공식 로그인 유지를 끈 다음 BetterToken을 활성화하고 Codex를 완전히 다시 시작하세요. API Key 모드로 전환되므로 공식 로그인이 필요한 기능은 사용할 수 없습니다. 사용량이 초기화되면 로그인 유지 설정을 복원하세요.

관련 페이지

• Claude Code 세부 정보: Claude Code

• Claude Desktop용 직접 Claude 설정: Claude Desktop

• Codex 세부 정보: Codex

• OpenCode 세부 정보: OpenCode

• OpenClaw 세부 정보: OpenClaw

• 지원 도구 전체 비교

• API 오류, 상태 코드 및 요청 제한

관련 FAQ

• Claude Desktop 사용자 지정 연결
• OpenAI-compatible API와 Anthropic-compatible API 비교
• MCP와 API Key 및 Base URL 비교
• model_provider, base_url 및 wire_api란 무엇인가요?
• Cline에서 OpenAI-compatible API 구성