> ## 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. # CC-Switch에서 APIMart 사용하기 > CC-Switch에서 APIMart API 서비스를 설정하고 사용하는 방법을 자세히 안내합니다. 간단한 설정만으로 CC-Switch에서 다양한 AI 모델을 호출하여 프로그래밍을 지원합니다. ## 소개 CC-Switch는 Claude Code, Codex, Gemini CLI 등 여러 AI 코딩 CLI 도구의 API 공급자 설정을 통합 관리하기 위한 오픈 소스 데스크톱 앱입니다. 번거로운 설정 파일 편집을 GUI에서의 몇 번의 클릭으로 대체해 줍니다. 공급자를 추가하기만 하면, 설정 파일을 직접 손볼 필요 없이 API 서비스 간을 원클릭으로 전환할 수 있습니다. CC-Switch를 통해 APIMart에 연결하면 Claude Code와 Codex에서 APIMart 서비스를 손쉽게 구성하고, 여러 공급자 사이를 자유롭게 전환할 수 있습니다. ## 준비 사항 시작하기 전에 다음을 확인하세요: 1. **지원되는 CLI 도구 설치 완료** [Claude Code](/ko/integrations/dev-tool/claude-code) 또는 [Codex CLI](/ko/integrations/dev-tool/codex-cli) 등 지원되는 CLI 도구를 하나 이상 설치하세요 2. **APIMart API 키 획득 완료** [APIMart 콘솔](https://apimart.ai/keys)에 로그인하여 API 키를 받으세요 (`sk-`로 시작) **팁:** APIMart 계정이 없으시다면 먼저 [APIMart](https://apimart.ai)에서 가입하고 API 키를 받으세요. ## 1단계: CC-Switch 설치 운영체제에 맞는 설치 방법을 선택하세요: Homebrew로 설치 (권장): ```bash theme={null} brew tap farion1231/ccswitch brew install --cask cc-switch ``` 또는 [GitHub Releases](https://github.com/farion1231/cc-switch/releases)에서 `.dmg` 설치 파일을 다운로드할 수 있습니다. CC-Switch는 Apple 코드 서명 및 공증을 마쳤으므로 그대로 설치할 수 있습니다 (macOS 12 이상 필요). [GitHub Releases](https://github.com/farion1231/cc-switch/releases)에서 `.msi` 설치 파일 또는 휴대용 `.zip`을 다운로드하세요. Windows 10 이상이 필요합니다. [GitHub Releases](https://github.com/farion1231/cc-switch/releases)에서 해당 형식의 패키지를 다운로드하세요: * Debian / Ubuntu: `.deb` 패키지 * Fedora / RHEL: `.rpm` 패키지 * 범용: `.AppImage` 형식 * Arch Linux: `paru -S cc-switch-bin` CC-Switch를 처음 실행하면 PC에 설치된 CLI 도구를 자동 감지하고, 기존 설정을 기본 공급자로 가져올 수 있습니다. ## 2단계: APIMart 공급자 추가 CC-Switch 메인 화면 상단에서 다양한 CLI 도구 그룹을 전환할 수 있습니다. 구성하려는 도구에 맞춰 아래 단계를 참고해 APIMart 공급자를 추가하세요. **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 네이티브 형식 유지 | CC-Switch 메인 화면 **4. 설정 저장** **추가** 버튼을 클릭해 저장합니다. APIMart가 공급자 목록에 표시됩니다. **1. Codex 그룹으로 전환** 메인 화면 상단에서 **Codex**를 선택합니다. **2. 공급자 추가 패널 열기** 메인 화면 오른쪽 상단의 **+** 버튼을 클릭합니다. **3. 공급자 정보 입력** Codex 공급자는 두 개의 설정 블록으로 구성됩니다: **auth.json** 블록에 API 키 입력: ```json theme={null} { "OPENAI_API_KEY": "sk-xxxxxxxxxxxx" } ``` **config.toml** 블록에 공급자 설정 입력: ```toml theme={null} 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 형식을 자동으로 검사합니다. **엔드포인트 안내:** Claude Code는 Anthropic 네이티브 형식을 사용하며 URL은 `https://api.apimart.ai`입니다 (`/v1` 없음). Codex는 OpenAI 호환 형식을 사용하며 URL은 `https://api.apimart.ai/v1`입니다 (`/v1` 포함). 혼동하지 마세요. ## 3단계: 공급자 전환 추가가 끝나면 APIMart와 다른 공급자 사이를 언제든 전환할 수 있습니다: ### 메인 화면에서 전환 1. 공급자 목록에서 **APIMart** 선택 2. **활성화** (또는 **사용**) 버튼 클릭 3. "전환 성공" 알림이 표시되면 완료 CC-Switch 메인 화면 ### 시스템 트레이로 빠르게 전환 CC-Switch는 시스템 트레이에 상주하므로 메인 화면을 열지 않아도 전환할 수 있습니다: 1. 시스템 트레이의 CC-Switch 아이콘 클릭 2. 메뉴에서 대상 공급자 이름을 바로 클릭 — 즉시 적용 **적용 안내:** Claude Code는 핫 스위칭을 지원해 새 세션에서 자동으로 적용됩니다. Codex는 전환 후 터미널 또는 Codex를 재시작해야 적용됩니다. ## 지원 모델 APIMart 공급자로 전환하면 해당 CLI 도구에서 APIMart가 제공하는 다양한 모델을 사용할 수 있습니다: | 모델 ID | 특징 | 추천 시나리오 | | ------------------- | ---------- | ----------------- | | `claude-opus-4-6` | 종합 성능 최강 | 복잡한 아키텍처, 어려운 디버깅 | | `claude-sonnet-4-6` | 성능과 속도의 균형 | 일상 코딩, 코드 생성 | | `gpt-5.5` | 코딩 능력 우수 | 복잡한 엔지니어링 작업 | | `gpt-4o` | 고성능, 빠른 응답 | 일상 코딩, 빠른 반복 | Claude Code에서는 `/model` 명령으로 모델을 전환할 수 있고, Codex에서도 동일하게 `/model` 명령을 사용합니다. 전체 모델 목록은 [Claude Code 가이드](/ko/integrations/dev-tool/claude-code)와 [Codex CLI 가이드](/ko/integrations/dev-tool/codex-cli)를 참고하세요. ## 자주 묻는 질문 ### Q1: 공급자를 전환했는데 적용되지 않아요? * **Claude Code**: 핫 스위칭을 지원합니다. 새 세션을 시작하세요. 그래도 적용되지 않으면 Claude Code를 재시작하세요 * **Codex**: 전환 후 터미널 또는 Codex를 재시작하세요 ### Q2: API 키가 유효하지 않다고 표시돼요? 1. API 키가 `sk-`로 시작하며 공백 없이 완전하게 복사되었는지 확인 2. [APIMart 콘솔](https://apimart.ai/keys)에서 키 상태가 활성인지 확인 3. 엔드포인트 URL이 올바른지 확인 (Claude Code는 `https://api.apimart.ai`, Codex는 `https://api.apimart.ai/v1`) ### Q3: Codex 공급자 추가 시 형식 오류가 나요? CC-Switch는 `auth.json` (JSON 문법)과 `config.toml` (TOML 문법)을 검사합니다. 다음을 확인하세요: * JSON의 괄호, 따옴표, 쉼표가 완전한지 * 전각 따옴표를 사용하지 않았는지 * TOML의 필드명 철자가 정확한지 ### Q4: CC-Switch는 어떤 파일을 수정하나요? CC-Switch는 각 도구의 설정 파일에 자동으로 기록합니다: * **Claude Code**: `~/.claude/settings.json` * **Codex**: `~/.codex/config.toml` 및 `~/.codex/auth.json` 전환 전 자동으로 백업을 만들기 때문에 이 파일들을 직접 편집할 필요는 없습니다. ### Q5: API 사용량과 비용은 어디서 확인하나요? [APIMart 콘솔](https://apimart.ai/overview)에 로그인하여 API 호출 통계, 토큰 소비 내역, 비용 추이를 확인하세요. ## 지원 사용 중 문제가 발생하면: * 📚 [APIMart 문서 센터](https://docs.apimart.ai) * 📚 [CC-Switch 프로젝트 페이지](https://github.com/farion1231/cc-switch) * 💬 [Discord 커뮤니티](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 기술 지원: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** 지금 바로 APIMart에 가입하고 API 키를 받아, CC-Switch에서 여러 AI 코딩 도구를 손쉽게 관리해 보세요!