CC-Switch에서 APIMart 사용하기

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

소개

​

준비 사항

1. 지원되는 CLI 도구 설치 완료 Claude Code 또는 Codex CLI 등 지원되는 CLI 도구를 하나 이상 설치하세요
2. APIMart API 키 획득 완료 APIMart 콘솔에 로그인하여 API 키를 받으세요 (sk-로 시작)

​

1단계: CC-Switch 설치

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

​

2단계: APIMart 공급자 추가

• Claude Code용 설정
• Codex용 설정

1. Claude Code 그룹으로 전환메인 화면 상단에서 Claude Code를 선택합니다.2. 공급자 추가 패널 열기메인 화면 오른쪽 상단의 + 버튼을 클릭합니다.3. 공급자 정보 입력아래 항목을 입력합니다:

항목	입력 내용	설명
이름	APIMart	식별을 위한 사용자 정의 라벨
엔드포인트	https://api.apimart.ai	APIMart API 베이스 URL
API Key	sk-xxxxxxxxxxxx	본인의 APIMart API 키
API 형식	Anthropic Messages	기본값인 Anthropic 네이티브 형식 유지

4. 설정 저장추가 버튼을 클릭해 저장합니다. APIMart가 공급자 목록에 표시됩니다.

1. Codex 그룹으로 전환메인 화면 상단에서 Codex를 선택합니다.2. 공급자 추가 패널 열기메인 화면 오른쪽 상단의 + 버튼을 클릭합니다.3. 공급자 정보 입력Codex 공급자는 두 개의 설정 블록으로 구성됩니다:auth.json 블록에 API 키 입력:

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

config.toml 블록에 공급자 설정 입력:

model = "gpt-5.5"
model_provider = "apimart"

[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. 설정 저장공급자에 이름을 지정한 후 (예: APIMart), 추가 버튼을 클릭해 저장합니다. CC-Switch가 JSON과 TOML 형식을 자동으로 검사합니다.

​

3단계: 공급자 전환

​

메인 화면에서 전환

1. 공급자 목록에서 APIMart 선택
2. 활성화 (또는 사용) 버튼 클릭
3. “전환 성공” 알림이 표시되면 완료

​

시스템 트레이로 빠르게 전환

1. 시스템 트레이의 CC-Switch 아이콘 클릭
2. 메뉴에서 대상 공급자 이름을 바로 클릭 — 즉시 적용

​

지원 모델

​

자주 묻는 질문

​

Q1: 공급자를 전환했는데 적용되지 않아요?

• Claude Code: 핫 스위칭을 지원합니다. 새 세션을 시작하세요. 그래도 적용되지 않으면 Claude Code를 재시작하세요
• Codex: 전환 후 터미널 또는 Codex를 재시작하세요

​

Q2: API 키가 유효하지 않다고 표시돼요?

1. API 키가 sk-로 시작하며 공백 없이 완전하게 복사되었는지 확인
2. APIMart 콘솔에서 키 상태가 활성인지 확인
3. 엔드포인트 URL이 올바른지 확인 (Claude Code는 https://api.apimart.ai, Codex는 https://api.apimart.ai/v1)

​

Q3: Codex 공급자 추가 시 형식 오류가 나요?

• JSON의 괄호, 따옴표, 쉼표가 완전한지
• 전각 따옴표를 사용하지 않았는지
• TOML의 필드명 철자가 정확한지

​

Q4: CC-Switch는 어떤 파일을 수정하나요?

• Claude Code: ~/.claude/settings.json
• Codex: ~/.codex/config.toml 및 ~/.codex/auth.json

​

Q5: API 사용량과 비용은 어디서 확인하나요?

​

지원

• 📚 APIMart 문서 센터
• 📚 CC-Switch 프로젝트 페이지
• 💬 Discord 커뮤니티
• 🐦 Twitter @APIMart_
• 📧 기술 지원: zhihong@apimart.ai