Claude Code용 CC Switch: 계정, 제공업체 및 구성 관리

CC Switch의 Claude Code 관리 기능이 실제로 하는 일

CC Switch는 코딩 에이전트용 오픈 소스 데스크톱 구성 관리자입니다. 지원하는 연동 대상은 시간이 지나면서 늘어났으므로, 고정된 목록을 기준으로 표준화하기 전에 현재 저장소와 릴리스 노트를 확인하세요. Claude Code는 주요 연동 대상이며, 현재 버전은 Codex와 Gemini CLI 같은 다른 명령줄 코딩 에이전트도 지원 대상으로 삼고 있습니다.

Claude Code용 제공업체 프로필에는 일반적으로 다음 항목이 함께 포함됩니다.

• Anthropic 호환 API 엔드포인트
• API 키 또는 인증 토큰
• 모델 매핑 또는 모델 관련 환경 변수 값
• 추가 환경 변수
• MCP 서버 정의
• 프로필에 따라 적용되어야 하는 Claude Code 설정

이는 ‘계정’이 단순히 Anthropic 로그인을 의미하지 않을 때 유용합니다. 실제 배포 환경에서 개발자는 다음 항목 사이를 오가며 사용할 수 있습니다.

• Anthropic API 직접 액세스
• 조직의 인증된 API 게이트웨이
• Anthropic 호환 타사 제공업체
• 개인용, 스테이징용, 프로덕션용으로 분리된 청구 계정
• 호환되는 요청 의미 체계를 제공하는 로컬 또는 원격 프록시

CC Switch는 이러한 선택지를 한곳에서 관리하고 선택한 구성을 활성화합니다. 그렇다고 모든 호환 엔드포인트가 동일하게 동작하도록 만드는 것은 아닙니다. 모델 이름, 인증 헤더, 요청 제한, 프롬프트 캐싱, 지원하지 않는 API 필드의 차이는 여전히 제공업체의 책임입니다.

이 표는 절충점을 보여 줍니다. CC Switch는 운영자의 실수를 줄여 주지만, 높은 권한을 가진 로컬 애플리케이션이 하나 더 추가됩니다.

설치 및 플랫폼 지원

CC Switch는 프로젝트의 GitHub Releases 페이지를 통해 배포됩니다. 현재 저장소에는 macOS, Windows, Linux 데스크톱 지원이 명시되어 있으며, 릴리스 배포 파일은 플랫폼과 버전에 따라 다릅니다. 배포하려는 릴리스에 첨부된 파일을 확인하세요. 소스 코드가 존재한다고 해서 모든 릴리스에서 모든 운영 체제 버전, CPU 아키텍처 또는 패키지 형식에 대한 빌드가 제공되는 것은 아닙니다.

macOS에서는 프로젝트가 Homebrew cask를 사용하는 설치 절차를 제공합니다.

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

관리형 환경에서 다운로드한 바이너리를 사용하기 전에 Homebrew가 무엇을 설치했는지 확인하세요.

brew info --cask cc-switch
brew list --cask cc-switch
codesign -dv --verbose=4 "/Applications/CC Switch.app" 2>&1

Windows와 Linux 사용자는 릴리스에 게시된 배포 파일에서 설치 프로그램이나 패키지를 받아야 합니다. 패키지 이름과 배포 채널은 바뀔 수 있으므로, 저는 정확한 릴리스를 고정하고 테스트하지 않은 상태에서 오래되었을 수 있는 winget, Scoop, .deb 또는 AppImage 명령을 워크스테이션 초기 설정 스크립트에 넣지 않습니다.

통제된 배포를 위해서는 다음을 수행하세요.

1. CC Switch 버전을 고정하세요.
2. 릴리스의 예상 체크섬을 기록하세요.
3. 테스트 후 폐기할 수 있는 Claude Code 구성으로 테스트하세요.
4. 프로필 활성화 중 변경되는 모든 파일의 목록을 작성하세요.
5. 최신 릴리스를 자동으로 따라가기보다는 업그레이드 절차를 정의하세요.

설치 전에 간단한 스냅샷을 만들어 두면 도움이 됩니다.

mkdir -p /tmp/claude-config-before
cp -R ~/.claude /tmp/claude-config-before/ 2>/dev/null || true

# Install CC Switch, create a test profile, and activate it.

diff -ru /tmp/claude-config-before/.claude ~/.claude || true

이렇게 하면 서식 재작성, 필드 삭제, 예상치 못한 범위에서 병합된 MCP 항목 등 문서에서 놓칠 수 있는 동작을 발견할 수 있습니다.

제공업체 프로필 생성 및 전환

프로필은 일관된 하나의 보안 및 청구 맥락을 나타내야 합니다. 저는 다음과 같이 사용 시 영향을 알 수 있는 이름을 사용합니다.

• anthropic-personal
• company-gateway-dev
• customer-a-restricted
• local-proxy-test

다음과 같은 이름은 피하세요. default-2. 프로덕션 장애가 발생했을 때 활성 프로필 이름만으로도 편집기를 열지 않고 ‘이 요청은 어디로 전송되는가?’에 답할 수 있어야 합니다.

Anthropic 호환 게이트웨이를 사용하는 Claude Code 프로필은 개념적으로 다음과 비슷한 설정을 생성할 수 있습니다.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "${TOKEN_MANAGED_BY_PROFILE}",
    "ANTHROPIC_MODEL": "company-claude-default"
  },
  "permissions": {
    "defaultMode": "default"
  }
}

정확히 어떤 변수가 필요한지는 제공업체와 Claude Code 버전에 따라 다릅니다. 일부 서비스는 다음을 요구합니다. ANTHROPIC_API_KEY; 일부 게이트웨이 연동에서는 다음을 사용합니다. ANTHROPIC_AUTH_TOKEN. 단지 인증이 성공할 ‘가능성을 높이기’ 위해 둘 다 설정하지 마세요. 오래된 값의 우선순위가 더 높으면 잘못된 계정으로 요청이 라우팅될 수 있으므로, Claude Code가 어떤 자격 증명을 우선 사용할지 확인하세요.

전환한 후에는 새 Claude Code 프로세스를 시작하세요.

claude

Claude Code가 이미 실행 중일 때 전환하면 실제로 어떤 일이 일어나는지 오해하기 쉽습니다. 이 유틸리티는 디스크의 파일을 업데이트할 수 있지만, 실행 중인 프로세스가 이미 상속받은 환경 변수 값을 확실하게 교체할 수는 없습니다. 따라서 기존 세션은 재시작할 때까지 원래 제공업체를 계속 사용할 수 있습니다.

비밀 정보를 출력하지 않고 실제 적용된 구성을 검증하세요.

python3 - <<'PY'
import json
from pathlib import Path

path = Path.home() / ".claude" / "settings.json"
data = json.loads(path.read_text())
env = data.get("env", {})

for key, value in sorted(env.items()):
    if "KEY" in key or "TOKEN" in key or "SECRET" in key:
        value = "<redacted>"
    print(f"{key}={value}")
PY

흔히 놓치는 부분은 Claude가 응답하는지만 테스트하는 것입니다. 호환 프록시는 요청한 모델을 다른 모델에 알리지 않고 매핑하면서도 유효한 응답을 반환할 수 있습니다. 어떤 모델이 사용되는지가 중요하다면 제공업체의 요청 로그나 게이트웨이 감사 기록을 확인하세요.

에이전트 간 MCP 설정

MCP 구성에서 중앙 관리는 단순한 토큰 선택 도구보다 더 큰 효용을 발휘합니다. 개발자는 여러 에이전트에 파일 시스템, 이슈 추적기, 데이터베이스, 브라우저 서버를 구성해 둘 수 있으며, 각 에이전트는 고유한 스키마나 저장 위치를 사용합니다.

일반적인 MCP 서버 정의에는 명령과 인수가 포함됩니다.

{
  "mcpServers": {
    "project-files": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/alex/work/customer-a"
      ]
    }
  }
}

이를 실행 가능한 구성으로 취급하세요. 프로필을 활성화하면 에이전트가 다음을 실행하고 npx, 패키지를 실행하며, 지정된 디렉터리를 모델이 사용하는 도구 계층에 노출할 수 있게 됩니다.

실제로 저는 저장소의 민감도에 따라 MCP 프로필을 분리합니다.

• 일반 프로필은 문서와 위험도가 낮은 도구를 노출합니다.
• 고객 프로필은 해당 고객의 작업 디렉터리만 노출합니다.
• 데이터베이스 서버와 프로덕션 제어 서버는 전역으로 활성화하지 않습니다.
• MCP 서버에서 사용하는 토큰의 범위는 모델 제공업체 토큰과 별도로 지정합니다.

또한 에이전트의 기본 MCP 명령을 사용할 수 있다면 CC Switch가 생성한 결과와 비교하세요. Claude Code에서는 전환 후 활성 서버를 확인하세요.

claude mcp list

하나의 MCP JSON 객체를 모든 코딩 에이전트에 변경 없이 복사할 수 있다고 가정하지 마세요. CC Switch는 UI에서 관리 방식을 통일할 수 있지만, 각 하위 에이전트에는 여전히 고유한 스키마, 범위 규칙, 수명 주기 동작이 있습니다.

자격 증명이 저장되는 위치

감사해야 할 저장 계층은 두 가지입니다.

1. CC Switch의 애플리케이션 데이터: 프로필을 보관하는 데 사용됩니다.
2. 코딩 에이전트의 기본 구성: 프로필이 활성화될 때 작성되거나 업데이트됩니다.

CC Switch는 호스팅된 계정 서비스 대신 로컬 애플리케이션 저장소를 사용합니다. 정확한 경로는 플랫폼에 따라 다르고 애플리케이션이 발전하면서 변경되어 왔으므로, 과거 이슈에서 복사한 경로에 의존하지 말고 설치된 빌드에서 확인하세요. 일반적인 OS 애플리케이션 데이터 루트 경로는 다음과 같습니다.

macOS:   ~/Library/Application Support/
Windows: %APPDATA%
Linux:   ~/.local/share/ or an XDG data directory

자격 증명 내용을 출력하지 않고 검색하세요.

find "$HOME/Library/Application Support" \
  -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null

find "${XDG_DATA_HOME:-$HOME/.local/share}" \
  -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null

Claude Code의 경우 다음을 검토하세요. ~/.claude/, 특히 settings.json을 검토하고, 해당하는 경우 프로젝트 수준의 Claude 구성도 확인하세요. 다른 에이전트는 일반적으로 다음과 같은 별도 디렉터리를 사용합니다. ~/.codex/ 또는 ~/.gemini/, 다만 파일 이름과 자격 증명 형식은 에이전트 버전에 따라 다릅니다.

“로컬에 저장됨”이 “암호화됨”을 의미한다고 가정하지 마세요. 설치한 CC Switch 버전이 해당 비밀 정보를 운영체제의 자격 증명 저장소에 명시적으로 저장하지 않는 한, 애플리케이션 데이터베이스와 생성된 에이전트 파일은 사용자 계정에서 평문으로 읽을 수 있는 것으로 취급하세요. 파일 검사와 저장소 코드 검토를 통해 확인하되, 비밀 정보를 터미널, 티켓 또는 채팅 세션에 붙여 넣지 않도록 주의하세요.

데스크톱 토큰 접근의 보안상 영향

CC Switch는 필연적으로 데스크톱 사용자 권한으로 작동합니다. 해당 계정이 토큰을 읽을 수 있다면, 같은 사용자 권한으로 실행되는 악성코드나 다른 프로세스도 토큰을 읽을 수 있습니다. CC Switch를 사용하더라도 엔드포인트 보안 요건은 여전히 필요합니다.

주요 위험은 다음과 같습니다:

• 자격 증명 집중: 여러 공급자의 토큰이 하나의 로컬 프로필 저장소에 함께 보관될 수 있습니다.
• 설정 덮어쓰기: 프로필을 활성화하면 에이전트가 사용하는 파일을 교체하거나 병합할 수 있습니다.
• 백업을 통한 유출: 애플리케이션 데이터와 도트파일이 암호화되지 않은 백업에 포함될 수 있습니다.
• 프로세스 상속: 기존 터미널과 실행 중인 에이전트에 이전 자격 증명이 남아 있을 수 있습니다.
• MCP 실행: 프로필이 파일 시스템이나 네트워크에 접근하는 명령을 활성화할 수 있습니다.
• 공급망 위험: 업데이트를 설치하면 새로운 데스크톱 코드가 저장된 토큰에 접근할 수 있게 됩니다.
• 화면과 로그를 통한 노출: UI 진단 정보나 버그 보고서에 엔드포인트 및 자격 증명 데이터가 노출될 수 있습니다.

이 유틸리티에 최소 권한 원칙에 따른 통제를 적용하세요:

chmod 700 ~/.claude
chmod 600 ~/.claude/settings.json

공급자가 지원한다면 유효 기간이 짧거나 폐기할 수 있는 게이트웨이 토큰을 우선 사용하세요. 편의용 프로필에 프로덕션 관리자 자격 증명을 절대 넣지 마세요. 기기를 더 이상 사용하지 않게 되면 토큰을 교체하세요. 프로필을 삭제했다는 사실만으로 자격 증명이 다른 곳에 복사된 적이 없다고 입증할 수는 없습니다.

기업에 배포한다면 저는 다음을 요구하겠습니다:

• 검토를 거친 릴리스로 버전 고정
• 전체 디스크 암호화
• 백업 취급 제한
• 공급자 측 지출 한도와 감사 로그
• 개발자 및 환경별 별도 토큰
• 문서화된 토큰 폐기 절차
• MCP 명령과 노출된 경로의 정기 검토

CC Switch는 로컬에서 여러 공급자를 사용하는 워크플로에 실용적입니다. 하지만 정책상 하드웨어 기반 비밀 정보 보호, 단기 자격 증명 또는 중앙에서 강제하는 설정이 필요한 환경에 자동으로 적합해지는 것은 아닙니다. 이런 경우에는 회사 게이트웨이와 비밀 정보 관리자에 연동된 실행 도구가 더 타당한 설계일 수 있습니다.

실무 핵심 요점

• 반복적인 수동 편집으로 계정, 엔드포인트 또는 MCP 관련 실수가 발생한다면 CC Switch를 사용하세요.
• 배포 전에 프로젝트의 최신 GitHub 릴리스에서 플랫폼별 배포 파일을 확인하세요.
• 각 프로필에는 공급자, 소유자, 환경을 식별할 수 있는 이름을 지정하세요.
• 실행 중인 프로세스에 이전 값이 남아 있을 수 있으므로 전환 후 Claude Code를 재시작하세요.
• 생성된 파일을 검사하고 claude mcp list 를 사용해 실제 적용 상태를 확인하세요.
• CC Switch의 로컬 데이터와 하위 에이전트 설정을 민감한 자격 증명 저장소로 취급하세요.
• MCP 서버는 명령을 실행하고 파일을 노출할 수 있으므로 API 토큰만큼 신중하게 권한 범위를 설정하세요.
• 릴리스 버전을 고정하고, 설정 변경 사항을 테스트하며, 토큰을 폐기할 수 있는 수단을 유지하세요.
• 관련 통제 체계가 그 위험을 명시적으로 감당할 수 있는 경우가 아니라면, 영향력이 큰 프로덕션 자격 증명은 데스크톱 전환 도구에 넣지 마세요.