---
title: "CC Switch로 연결하기"
description: "CC Switch에서 사용자 지정 구성을 추가하여 1折AI를 연결하고, Claude Code에서 공급자를 원클릭으로 전환하세요. settings.json을 직접 수정할 필요가 없습니다."
headingIds: {"설치":"section-1","Claude Code에 1折AI 추가하기":"section-2","모델 목록 가져오기":"section-3","Codex":"section-4","자주 묻는 질문":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
[CC Switch](https://github.com/farion1231/cc-switch) 은 Claude Code, Codex 등 명령줄 도구의 공급자 구성을 관리하는 데스크톱 도구입니다. 한 번 추가하면 공식 계정, 1折AI 및 다른 공급자 간 전환은 클릭 한 번으로 가능합니다.

## 설치

- macOS: `brew install --cask cc-switch`
- Windows / Linux: [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 에서 설치 패키지를 다운로드합니다.

## Claude Code에 1折AI 추가하기

<Steps>
<Step title="추가 페이지 열기">

사이드바에서 **Claude Code**를 선택하고, 페이지 헤더 오른쪽의 **공급자 추가**(+ 버튼)를 클릭합니다.

</Step>
<Step title="「사용자 지정 구성」 선택">

1折AI는 현재 CC Switch의 사전 설정 목록에 없으므로, 목록 맨 위의 **사용자 지정 구성을** 선택합니다.

</Step>
<Step title="구성 입력">

이름에 `1折AI`을 입력하고, 구성 편집 상자의 `env`을 다음과 같이 작성합니다:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}
```

모델을 동시에 고정하려면 `ANTHROPIC_MODEL` 등의 변수를 추가하세요. 작성 방법은 [Claude Code 연결](/ko/docs/quickstart-claude-code/)의 모델 매핑 절을 참조하세요.

</Step>
<Step title="저장 및 활성화">

페이지 하단의 **추가**를 클릭한 다음, 공급자 목록에서 1折AI를 활성화합니다. CC Switch는 구성을 Claude Code의 `~/.claude/settings.json`에 기록하며, Claude Code는 재시작 없이 새 공급자를 사용합니다.

</Step>
<Step title="확인">

Claude Code에서 `/status`을 실행하면 base URL은 `https://1zheai.com`이어야 합니다. 메시지를 한 번 더 보내고, 콘솔의 [호출 로그](/ko/docs/usage-logs/)에서 기록이 있는지 확인하세요.

</Step>
</Steps>

<Note>

CC Switch 공식 예제는 `ANTHROPIC_API_KEY`을 사용하며, 두 변수 모두 동작합니다. 우리는 `ANTHROPIC_AUTH_TOKEN`을 권장하며, 이유는 [Claude Code 연결](/ko/docs/quickstart-claude-code/)을 참조하세요.

</Note>

## 모델 목록 가져오기

공급자를 편집할 때, 모델 입력 상자 옆의 **모델 목록 가져오기** 버튼은 API 키(API key)를 사용하여 `/v1/models`을 호출하고, 사용 가능한 모델을 나열한 뒤 하나를 선택하여 입력합니다.

## Codex

CC Switch는 Codex의 공급자도 관리할 수 있습니다. 이 사이트의 Base URL, API 키 및 GPT 모델 구성은 [Codex CLI 연결](/ko/docs/quickstart-codex/)을 참조하세요.

## 자주 묻는 질문

<AccordionGroup>
<Accordion title="전환 후에도 Claude Code가 이전 공급자를 사용 중?">

먼저 CC Switch에서 1折AI가 활성화 상태인지 확인하세요. 그다음 터미널에서 `ANTHROPIC_BASE_URL` 또는 `ANTHROPIC_AUTH_TOKEN`를 export한 적이 있는지 확인하세요. Claude Code는 settings.json을 기준으로 하지만, 수동으로 export한 이전 변수는 오인하기 쉬우므로 모두 정리하고 CC Switch에 통일하여 관리하는 것을 권장합니다.

</Accordion>
<Accordion title="모델 목록 가져오기에서 401 오류?">

API 키를 잘못 입력했거나 삭제된 경우입니다. API 키를 다시 복사하되, 공백이 포함되지 않도록 주의하세요.

</Accordion>
</AccordionGroup>