Claude Code란 무엇인가요?

Claude Code는 Anthropic에서 개발한 소프트웨어 개발용 AI 도구입니다.

이를 통해 터미널(terminal)에서 프로젝트와 상호작용하고, 파일을 분석하며, 코드를 이해하고, 개선 사항을 제안하며, 개발자의 일상적인 업무를 도울 수 있습니다.

어떻게 작동하나요?

Claude Code Free는 Claude Code와 다른 AI/LLM(대규모 언어 모델) 사이에서 프록시(proxy)/게이트웨이(gateway) 역할을 합니다.

실제로 Claude Code는 계속 터미널을 통해 사용되지만, 요청(requests)은 프록시에 설정된 다른 AI 제공업체로 리다이렉션(redirection)됩니다.

즉, 프록시가 Claude Code와 선택한 모델 사이에 "다리" 역할을 하여, Claude Code의 공식 인증 방식 외에 다른 옵션들을 사용할 수 있게 해줍니다.

설치

이 단계에서는 도구 설치를 구성하고 PATH 설정을 진행하겠습니다.

참고: 이 글에서는 Windows를 기준으로 단계를 진행합니다.

Claude Code 다운로드

먼저 공식 사이트에서 Claude Code 도구를 설치합니다. 프록시 설치 및 설정은 그 이후에 진행합니다.

사전 요구 사항:

• uv
• Python
• Claude Code Free

https://claude.com/product/claude-code

또는 PowerShell에서 Claude Code의 공식 스크립트를 실행하세요:

irm https://claude.ai/install.ps1 | iex

PATH 설정

컴퓨터에 도구의 PATH를 수동으로 설정해야 할 경우 Claude Code가 터미널에 직접 안내합니다.

따라서 다음 지침을 따르세요:

System Properties → Environment Variables → Edit User PATH → New → Add the path above

1) 다음 주소를 복사하세요:

1) 다음 주소를 복사하세요:

이것은 Claude Code가 컴퓨터에 설치된 경로입니다.

2) 시스템 환경 변수의 path에 붙여넣으세요:

이 경로를 Path에 추가하면 Windows가 모든 터미널에서 claude 명령을 인식하게 됩니다.

3) 터미널을 닫았다가 다시 여세요.

PATH를 변경한 후에는 현재 터미널을 닫고 다시 열어야 합니다.

이는 새로운 설정이 로드되도록 하기 위해 필요합니다.

4) PATH 설정 테스트:

터미널에 복사하여 붙여넣으세요:

claude --version

모든 것이 올바르다면, 터미널에 설치된 Claude Code의 버전이 표시됩니다.

Claude Code 실행하기

프록시를 설정하기 전에 CLI에서 몇 가지 간단한 테스트를 수행하며 실행해 보겠습니다.

터미널에 다음 명령을 실행하세요:

claude

결과:

이 명령은 Claude Code를 터미널에서 직접 시작합니다.

첫 실행 시에는 로그인하거나 도구 접근 권한을 승인해야 할 수 있습니다.

Claude Code가 기본적으로 지원하는 인증 방식은 무엇인가요?

기본적으로 Claude Code는 몇 가지 공식적인 인증 방식을 제공합니다.

그렇다고 해서 아무 AI의 API Key나 사용할 수 있다는 뜻은 아닙니다.

"Claude Code Free" 설정하기

이제 이 글의 핵심 주제인 Claude Code에서 다른 AI/LLM (Large Language Models)을 사용할 수 있게 해주는 프록시/게이트웨이 (proxy/gateway)를 설정하는 단계에 도달했습니다.

Claude Code 외에도 Claude Code Free를 실행하기 위해 Python이 필요하지만, 걱정하지 마세요. 자동으로 설치되거나 업데이트될 것입니다.

"Claude Code Free" 리포지토리 통합하기

첫 번째 단계는 Claude Code CLI (Command Line Interface)가 다른 LLM과 호환되도록 해주는 오픈 소스 (open source) 리포지토리를 다운로드하거나 클론 (clone)하는 것입니다.

공식 리포지토리로 이동하여 지침을 따르세요:

https://github.com/Alishahryar1/free-claude-code

또는 PowerShell에서 다음 명령어를 실행하세요:

irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex

프록시 실행하기

마지막으로 프록시를 테스트하겠습니다. 터미널에서 다음 명령어를 실행하세요:

fcc-server

결과:

참고: 빨간색 화살표가 가리키는 로컬 링크에 접속하여 프록시의 "admin" 패널을 여세요.

프록시 대시보드 (dashboard) 초기 화면:

free claude code의 "server control" 이해하기

여러 제공업체(Providers)에서 API 키를 생성하기 전에, 방금 다운로드한 프록시(Proxy)의 "제어판(control panel)"에 대해 좀 더 자세히 알아보겠습니다.

주요 섹션은 다음 3가지입니다:

• Providers (제공업체)
• Model Config (모델 설정)
• Messaging (메시징)

Providers

리셋 버튼 (Reset Buttons)

이 패널은 API 키를 관리 및 인증하고, 사용자의 PC에서 로컬로 작동하는 AI를 다루는 데 사용됩니다.

말 그대로 API 키와의 연결을 리셋하거나 시작하는 버튼입니다. 하지만 상태(Status)를 주의 깊게 확인하세요:

• Missing Key: 제공업체에 키가 누락되었습니다.
• Offline: 로컬 AI 서버가 활성화되어 있지 않습니다.
• AuthenticationError: 연결에 실패했습니다.

키 필드 (Key Fields)

여기에는 사용할 AI의 API 키를 붙여넣기만 하면 됩니다. 주의할 점은, 각 필드에 올바른 API 키를 붙여넣어야 한다는 것입니다. 그렇지 않으면 "엔진"을 잘못된 "섀시"에 장착하게 될 수도 있습니다.

또한 로컬 AI 서버의 주소를 호스팅하는 필드도 있습니다. 예를 들어 http://localhost:1234/v1과 같은 형식입니다.

런타임 (Runtime)

요약하자면:

이 부분은 프록시 서버가 어떻게 작동할지를 설정합니다.

다음 사항들을 제어합니다:

• 액세스 토큰 (Token de acesso): Claude Code가 프록시와 통신할 수 있도록 하는 내부 비밀번호입니다.
• 속도 제한 (Rate limit): 프록시가 제공자(provider)에게 보낼 수 있는 요청의 횟수입니다.
• 동시성 (Concorrência): 동시에 처리할 수 있는 응답/호출의 수입니다.
• 타임아웃 (Timeouts): 응답을 기다리다가 포기하기 전까지의 시간입니다.
• 호스트 및 포트 (Host e porta): 프록시가 사용자의 머신 어디에서 실행될지를 결정합니다.

모델 설정 (Model Config)

모델 설정과 관련된 섹션입니다.

모델 라우팅 (Model Routing)

이 부분은 모델 라우팅 (Model Routing) 섹션으로, 즉: Claude Code가 Claude 모델을 요청할 때 실제로 어떤 모델이 사용될지를 정의합니다.

각 필드 요약:

기본 모델 (Default Model)
기본 모델입니다. 다른 설정을 하지 않으면 모든 요청이 이 모델로 전달됩니다.

Opus 오버라이드 (Opus Override)
Claude Code가 Claude Opus에 상응하는 것을 요청할 때 사용할 특정 모델입니다.

Sonnet 오버라이드 (Sonnet Override)
Claude Code가 Claude Sonnet에 상응하는 것을 요청할 때 사용할 특정 모델입니다.

Haiku 오버라이드 (Haiku Override)
Claude Code가 Claude Haiku에 상응하는 것을 요청할 때 사용할 특정 모델입니다.

사고 (Thinking)

이 부분은 사고 (Thinking) 모드, 즉 모델의 "확장된 추론 (extended reasoning)" 동작을 제어합니다.

요약하자면:

Thinking = 모델이 응답하기 전에 더 많이 생각하도록 만드는 것입니다.

웹 도구 (Web Tools)

이 부분은 프록시의 웹 도구 (web tools)를 제어하며, 즉 Claude Code/모델이 다음과 유사한 기능을 사용할 수 있는지 여부를 결정합니다:

web_search
web_fetch

요약하자면:

Web Tools = 프록시를 통해 모델이 인터넷을 검색하거나 콘텐츠를 가져올 수 있도록 허용합니다.

메시징 (Messaging)

메시징 및 입력(inputs)을 담당하는 섹션입니다.

메시징 (Messaging)

이 부분은 메시징 (Messaging) 영역으로, 즉 Discord 또는 Telegram과 통합된 프록시/Claude Code를 사용하기 위한 설정입니다.

요약하자면:

메시징 (Messaging) = Discord 또는 Telegram의 봇처럼 메시지를 통해 Claude Code를 제어하거나 사용할 수 있게 해줍니다.

음성 (Voice)