계정 바꿀 때마다 설정 파일 고치는 일 없애는 CC Switch 가이드

추석 AI 부트캠프 하루 6시간 만에
AI 기초부터 나만의
서비스까지 완성 이번 연휴를 기회로 삼으세요일정 보기 ↗

역할: CC Switch 도입을 처음부터 끝까지 맡는 담당

맥락: 이 컴퓨터에는 클로드 코드나 코덱스 같은 도구가 이미 깔려 있고,
계정이나 업체를 바꿀 때마다 설정 파일을 손으로 고쳐 온 상태입니다.
CC Switch 는 아직 깔려 있지 않을 수 있습니다.

입력: <운영체제, 예: macOS 15 / Windows 11 / Ubuntu 24.04>,
<지금 쓰는 도구, 예: 클로드 코드만>, <바꿔 쓰고 싶은 것, 예: 회사 계정과 개인 계정>

작업: 아래 네 단계를 순서대로 진행하세요.
1. 현재 상태 확인: 지금 깔려 있는 도구와, 그 도구가 읽는 설정 파일의 경로만
   보고하세요. 파일 안의 값은 출력하지 마세요.
2. 설치 방법 확정: github.com/farion1231/cc-switch 의 README 에서 내 운영체제에
   해당하는 설치 명령만 그대로 인용하세요. 기억으로 쓰지 말고 문서에서 가져오세요.
3. 충돌 점검: ANTHROPIC_API_KEY, ANTHROPIC_BASE_URL, OPENAI_API_KEY,
   GEMINI_API_KEY 가 셸 설정 파일에 적혀 있는지 확인하고, 있으면 파일 이름과
   줄 번호만 알려 주세요. 값은 가린 채로 보고하세요.
4. 바꾼 뒤 반영되는 방식을 도구별로 정리하세요. 어떤 도구가 터미널을 다시 열어야
   하는지 README 와 공식 사용 설명서에서 확인한 대로만 적으세요.

제약: 열쇠(키)와 자격 증명 파일의 내용을 읽거나 출력하지 마세요.
설치 명령을 지어내지 마세요. 확인하지 못한 항목은 "확인 못 함" 으로 남기세요.
지금 쓰던 설정을 지우거나 덮어쓰지 마세요.

출력: 확인한 도구 목록, 설정 파일 경로, 내 운영체제용 설치 명령 한 줄,
충돌 후보 변수 목록, 도구별 반영 방식을 정리해 주세요.

검증: 설치 명령이 README 원문과 글자까지 같아야 하고, 충돌 후보 변수는 파일 이름과
줄 번호가 함께 있어야 합니다. 하나라도 확인 못 했으면 완료로 보고하지 말고
어디서 막혔는지 알려 주세요.

이걸 깔면 무엇이 달라지나

지금까지 계정이나 업체를 바꾸는 일은 계산대에서 카드 번호를 손으로 적어 넣는 방식이었습니다. 바꿀 때마다 다시 적었고, 한 자리만 틀려도 통째로 안 먹었습니다. CC Switch 는 그 카드들을 지갑에 넣어 두고 쓸 때 한 장을 골라 끼우게 만듭니다.

저장소 README 는 지금 상태를 이렇게 적어 두었습니다.

> 업체를 바꾸려면 JSON·TOML·.env 파일을 손으로 고쳐야 하고, 여러 도구에 걸쳐 설정을 한꺼번에 관리할 방법이 없습니다.

앱이 대신해 주는 것은 네 가지입니다.

• 도구 여덟 개를 창 하나에서 — 클로드 코드, Claude Desktop, 코덱스, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes
• 주소를 안 외워도 됩니다 — README 기준 업체 프리셋이 50개 넘게 들어 있어, 목록에서 고르면 주소가 자동으로 채워지고 내가 넣을 것은 열쇠 하나입니다
• 바꾸는 건 버튼 하나 — 카드의 Enable 을 누르면 설정 파일이 대신 고쳐집니다
• 되돌릴 자리가 남습니다 — 바꾸기 전 백업이 자동으로 쌓이고 최근 10개가 보관됩니다

개발을 안 해 본 사람일수록 크게 갈립니다

설정 파일은 쉼표 하나만 빠져도 통째로 안 읽힙니다. 코드를 읽을 줄 알면 그 자리를 눈으로 찾지만, 그렇지 않으면 파일이 깨졌는지 아닌지부터 판단이 안 됩니다. 그래서 한 번 성공한 설정을 무서워서 못 건드리고, 결국 계정 하나만 쓰게 됩니다.

이 앱은 그 파일을 사람이 열지 않게 만드는 것이 전부입니다. 새 기능을 붙이는 도구가 아니라, 이미 쓰던 것을 안 무섭게 만드는 도구입니다.

Quick Start

공식 저장소: CC Switch 공식 저장소 · MIT 무료 · 최신 판 v3.20.1

맥이면 한 줄입니다.

brew install --cask cc-switch

앱을 열면 위쪽 가운데에 Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes 를 고르는 자리가 있고, 오른쪽 위에 + 버튼이 있습니다. 업체는 한 줄짜리 카드로 늘어섭니다.

진짜 바뀌는지 확인

앱에서 공식 계정이 아닌 업체 카드를 하나 켠 다음, 설정 파일이 실제로 고쳐졌는지 눈으로 봅니다.

grep ANTHROPIC_BASE_URL ~/.claude/settings.json

STEP 1 · 3분무엇을 바꿔 주는 도구인지 먼저 알기

이 단계에서는 명령을 치기 전에 이게 무엇을 대신해 주는 물건인지부터 잡습니다. AI 를 더 똑똑하게 만드는 도구로 착각하면 깔아 놓고 실망하기 때문입니다.

CC Switch 는 설정 파일을 대신 써 주는 데스크톱 앱입니다. AI 의 성능에는 관여하지 않습니다. 내가 어느 계정, 어느 업체로 붙을지를 고르는 부분만 화면으로 옮겨 놓은 것입니다.

숫자부터 봅니다.

위 값은 2026년 8월 30일에 깃허브 API 로 직접 확인한 값입니다. 내려받은 횟수는 공개된 배포 파일 438개의 값을 더한 것이고, 스타 수와 달리 실제로 받아 간 횟수라 판단에 쓸 만합니다. 같은 날 홈브루 등록 정보도 직접 읽었는데, 최근 30일 설치가 10,634건이었습니다.

STEP 2 · 3분내 컴퓨터에 맞게 설치하기

이 단계에서는 실제로 깝니다. 운영체제마다 방법이 다르고, 아래 명령은 저장소 README 에 적힌 것을 그대로 옮긴 것입니다.

맥은 홈브루가 있으면 한 줄입니다.

brew install --cask cc-switch

나중에 새 판이 나오면 같은 자리에서 올립니다.

brew upgrade --cask cc-switch

아치 리눅스는 별도 명령이 있습니다.

paru -S cc-switch-bin

나머지는 배포 페이지에서 파일을 받습니다. 요구 사양은 윈도우 10 이상, macOS 12 (Monterey) 이상, 우분투 22.04·데비안 11·페도라 34 이상입니다.

• 윈도우 — CC-Switch-v{판}-Windows.msi 또는 설치가 필요 없는 -Windows-Portable.zip
• 맥 — CC-Switch-v{판}-macOS.dmg (저장소가 권하는 쪽)
• 리눅스 — .deb · .rpm · .AppImage

STEP 3 · 4분지금 쓰던 설정을 그대로 들여오기

이 단계에서는 처음 켰을 때 나오는 안내를 처리합니다. 여기를 건너뛰면 지금 잘 돌아가던 설정이 목록에 안 잡혀서, 앱에서 뭘 눌러도 원래 자리로 못 돌아오기 때문입니다.

처음 실행할 때 지금 쓰고 있는 설정을 기본 업체로 들여올 수 있습니다. 이걸 하면 원래 쓰던 것이 카드 한 장으로 목록에 들어오고, 그때부터는 언제든 그 카드로 되돌아올 수 있습니다.

들여왔는지는 화면에서 바로 보입니다. 지금 쓰는 카드에는 파란 테두리와 Currently Active 표시가 붙습니다.

지우기 버튼이 흐리게 죽어 있어도 고장이 아닙니다. 지금 쓰는 업체는 지울 수 없게 막아 두었습니다. 저장소는 그 이유를 「앱을 지워도 원래 도구는 그대로 돌아가야 한다」는 원칙 때문이라고 적었습니다. 설정을 전부 지워 버리면 그 도구 자체가 못 쓰게 되기 때문입니다. 안 쓰는 도구는 지우는 대신 설정에서 숨기면 됩니다.

STEP 4 · 4분계정이나 업체 하나 더 등록하기

이 단계에서는 바꿔 낄 두 번째 카드를 만듭니다. 한 장만 있으면 바꿀 것이 없어서 이 앱을 깐 의미가 없기 때문입니다.

오른쪽 위 + 를 누르면 등록 창이 열립니다. 순서는 이렇습니다.

오른쪽 위   [ + ]   누름
              ↓
Preset      Claude Official / OpenAI Official / DeepSeek / Kimi / MiniMax …
              ↓
Name        자동으로 채워짐
Endpoint    자동으로 채워짐          ← 주소를 외울 필요가 없는 자리
API Key     내가 받은 열쇠를 붙여넣음
              ↓
            [ Add ]  누름  →  목록에 카드 한 장이 새로 생김

여기서 공식 계정도 카드 한 장이라는 점이 중요합니다. Claude Official 은 앤트로픽 공식 계정으로 로그인하는 프리셋이고, OpenAI Official 은 OpenAI 공식 계정입니다. 다른 업체를 쓰다가 공식으로 돌아오고 싶으면 이 카드로 바꾼 뒤 해당 도구에서 로그아웃·로그인을 한 번 하면 됩니다.

계정을 여러 개 쓰는 경우는 저장소 FAQ 에 이렇게 적혀 있습니다. 코덱스는 공식 계정끼리도 바꿔 낄 수 있어서, Plus 나 Team 계정이 여러 개일 때 오가기 쉽습니다.

같은 업체를 조건만 바꿔서 두 장 두고 싶으면 카드의 Duplicate 를 누릅니다. 이름 뒤에 copy 가 붙은 사본이 생깁니다.

STEP 5 · 2분바꾸고 나서 반영시키기

이 단계에서는 「눌렀는데 그대로다」가 왜 생기는지를 없앱니다. 카드를 바꾸는 것과 도구가 그걸 읽는 것은 별개이기 때문입니다.

바꾸는 방법은 두 가지입니다. 카드 위의 Enable 을 누르거나, 화면 위쪽 메뉴 막대의 CC Switch 아이콘을 눌러 도구 이름 아래에서 업체를 바로 고르는 것입니다. 앱을 열지 않고 바꾸는 쪽이 뒤쪽입니다.

문제는 그다음입니다. 도구마다 새 설정을 언제 읽는지가 다릅니다.

이미 켜져 있던 터미널은 켜질 때 읽은 값을 그대로 들고 있습니다. 설정 파일이 바뀌어도 그 창은 모릅니다. 「안 바뀐다」의 대부분이 여기서 끝납니다.

바뀌었는지 확인하는 가장 빠른 방법은 도구를 열어 한 마디 걸어 보는 것입니다.

claude

STEP 6 · 3분바꿨는데 그대로일 때 제일 먼저 볼 곳

이 단계에서는 터미널을 다시 열어도 안 바뀌는 경우를 처리합니다. 이때는 설정 파일이 아니라 그보다 먼저 읽히는 값이 남아 있는 것이기 때문입니다.

CC Switch 는 이 상황을 스스로 찾아 화면 맨 위에 노란 띠로 알려 줍니다. 띠의 Expand 를 누르면 어떤 값이 어느 파일에서 왔는지 목록이 나오고, 지울 것을 골라 Remove Selected 를 누르면 됩니다. 지우기 전에 백업이 ~/.cc-switch/env-backups/ 에 JSON 파일로 남으니 되돌릴 수 있습니다.

직접 확인하고 싶으면 두 줄이면 됩니다.

echo "$ANTHROPIC_BASE_URL"

어느 파일에 적혀 있는지까지 찾으려면 아래를 씁니다. 결과에 열쇠가 그대로 보일 수 있으니 그 출력은 어디에도 붙여 넣지 마세요.

grep -n "ANTHROPIC_BASE_URL\|ANTHROPIC_API_KEY\|OPENAI_API_KEY\|GEMINI_API_KEY" ~/.zshrc

지운 뒤에는 터미널을 닫았다 다시 열어야 합니다. 열려 있던 창은 아직 옛 쪽지를 들고 있습니다.

STEP 7 · 2분내 설정이 어디에 쌓이는지 알아 두기

이 단계에서는 이 앱이 만든 것들이 어느 폴더에 모이는지 확인합니다. 컴퓨터를 옮기거나 앱을 지울 때 챙길 자리가 여기 하나로 정해져 있기 때문입니다.

ls ~/.cc-switch

저장소 FAQ 가 밝힌 자리는 다음과 같습니다.

• ~/.cc-switch/cc-switch.db — 등록한 업체와 딸린 설정이 모두 여기 들어갑니다
• ~/.cc-switch/settings.json — 이 컴퓨터에서만 쓰는 화면 설정입니다
• ~/.cc-switch/backups/ — 자동 백업이고 최근 10개가 남습니다
• ~/.cc-switch/env-backups/ — STEP 6 에서 지운 값의 백업입니다

이 폴더를 드롭박스·원드라이브·아이클라우드 같은 동기화 폴더로 지정하면 다른 컴퓨터에서도 같은 목록을 봅니다. 다만 여기에는 열쇠가 그대로 들어 있으니 공유 폴더로는 두지 마세요.

자주 막히는 곳

FAQ

지금 잘 돌아가는 설정이 날아가지 않습니까

처음 켤 때 지금 쓰던 설정을 기본 업체로 들여오는 안내가 나옵니다. 그걸 하면 원래 상태가 카드 한 장으로 남아 언제든 되돌아갈 수 있습니다. 바꾸기 전 백업도 ~/.cc-switch/backups/ 에 최근 10개까지 자동으로 쌓입니다.

계정 두 개를 왔다 갔다 할 수 있습니까

코덱스는 됩니다. 저장소 FAQ 에 공식 계정끼리도 바꿔 낄 수 있어 Plus 나 Team 계정을 여러 개 쓸 때 편하다고 적혀 있습니다. 클로드 쪽은 Claude Official 프리셋을 카드로 두고, 바꾼 뒤 해당 도구에서 로그아웃·로그인을 한 번 거치는 방식입니다.

화면이 한국어로 나옵니까

아닙니다. 2026년 8월 30일에 저장소를 직접 확인했는데 화면 언어가 영어·일본어·중국어 간체·중국어 번체 네 가지뿐이었습니다. 그래서 이 글은 버튼 이름을 영어 그대로 적었습니다. 실제로 누를 자리는 +, Enable, Edit, Add 정도라 개수는 많지 않습니다.

별이 13만 개면 안전합니까

아닙니다. 별은 관심도 신호일 뿐 내 컴퓨터에서 안전하다는 뜻이 아닙니다. 이 앱은 열쇠를 다루기 때문에 더 조심해야 합니다. 저장소 설명서가 직접 못을 박아 둔 문장이 있습니다 — 돈을 요구하거나 로그인 정보를 물어보는 「CC Switch」 사이트는 공식이 아닙니다. 받는 곳은 아래 「공식 자료」에 적은 공식 홈페이지와 깃허브 배포 페이지입니다.

프리셋에 있는 업체는 검증된 곳입니까

아닙니다. 목록에 있다는 것은 주소 형식을 미리 넣어 뒀다는 뜻이지 품질 보증이 아닙니다. 저장소 README 의 윗부분은 후원사 광고 영역이고 링크마다 추천 코드가 붙어 있습니다. 어디에 돈을 낼지는 따로 알아보고 정하세요.

업체 말고 다른 것도 관리합니까

합니다. 화면 위쪽에 Skills · Prompts · MCP 버튼이 따로 있습니다. 각각 작업 절차 묶음, 도구에 공통으로 넣는 지시문(CLAUDE.md · AGENTS.md 같은 파일), AI 에 외부 도구를 연결하는 설정을 뜻합니다. 이 글은 업체·계정 바꾸기까지만 다루니 나머지는 아래 공식 사용 설명서를 보세요.

앱을 지우면 클로드 코드도 못 쓰게 됩니까

아닙니다. 이 앱은 원래 도구가 읽는 설정 파일을 고쳐 줄 뿐이라, 앱을 지워도 마지막으로 고른 설정 그대로 계속 돌아갑니다. 저장소가 「앱이 없어져도 원래 도구는 그대로 돌아가야 한다」를 설계 원칙으로 적어 두었습니다.

알아 둘 한계

프로젝트마다 다른 설정을 물려 주는 도구가 아닙니다. 이 앱이 고치는 것은 ~/.claude/settings.json 처럼 컴퓨터 전체가 쓰는 설정 파일 한 벌입니다. 폴더 A 에서는 이 업체, 폴더 B 에서는 저 업체 식으로 자동으로 갈리지 않습니다. 바꾸면 그 컴퓨터의 해당 도구 전체가 같이 바뀝니다.

환경 변수를 이기지 못합니다. 찾아서 알려 주고 지우는 것을 도와주기까지가 전부이고, 지울지는 사람이 정합니다. 경고 띠를 닫아 두면 다음에 앱을 열 때 다시 검사합니다.

열쇠를 대신 주지 않습니다. 계정 가입과 결제는 각자 합니다. 프리셋은 주소를 채워 줄 뿐이라 열쇠는 내가 붙여 넣습니다.

바꿨다고 바로 도는 도구가 아닙니다. 클로드 코드와 Gemini CLI 는 바로 반영되지만 코덱스·OpenCode·OpenClaw 는 터미널을 다시 열어야 합니다. 이 한 줄을 모르면 「고장 났다」로 끝납니다.

한국어 화면이 없습니다. 앞서 적은 대로 영어·일본어·중국어만 있습니다.

바꿔 낄 카드가 하나뿐이라면 아직 깔 이유가 없습니다. 계정이 둘 이상이거나, 공식 계정과 다른 업체를 오갈 일이 생겼을 때가 이 앱이 값을 하는 지점입니다.

이 글의 화면 이름과 절차는 저장소 README 와 공식 사용 설명서를 2026년 8월 30일에 읽어 옮긴 것이고, 숫자는 같은 날 깃허브 API 와 홈브루 등록 정보에서 직접 확인했습니다. 설치해서 돌려 본 결과가 아니라는 점은 밝혀 둡니다.

공식 자료

• 저장소 — CC Switch 공식 저장소 · MIT
• 홈페이지 — ccswitch.io 공식 홈페이지
• 내려받기 — 공식 배포 페이지 · 최신 v3.20.1
• 사용 설명서 — 공식 사용 설명서(영문)
• 맥 설치 — Homebrew cc-switch 등록 정보
• 도구 쪽 문서 — Claude Code 공식 문서