[튜토리얼] Claude Code 무료로 사용하기

이 방법은 Anthropic의 Claude Code를 NVIDIA에서 제공하는 무료 API 키를 사용하여 우회 접속하는 방법입니다.

누군가 Claude Code를 무료로 사용할 수 있는 프로젝트를 공개했는데요, 해당 레포는 여기서 확인할 수 있습니다.

그래서 많은 분들이 쉽게 로컬에 설치하고 실행하실 수 있도록 그 방법을 포스팅하려고 합니다.

그럼 시작할게요!

---

0. 준비물

• NVIDIA Build에 접속하여 개인 계정으로 가입
• API 키 발급 후, 복사하기 (🚨주의: 키는 발급한 뒤 한번만 노출되므로 메모장에 남겨놓기)
• 'Node.js'와 'Python3' 미리 설치해 놓기

1. Claude Code 설치

• 터미널에서 아래 명령어 입력하여 클로드 코드 설치하기

npm install -g @anthropic-ai/claude-code

2. 프록시 프로젝트 설정

• GitHub에서 우회 서버 프로젝트를 클론하고 파이썬 환경 구축하기

# 프로젝트 클론
git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code

# 가상환경(venv) 생성 및 활성화 (macOS/Linux 기준)
python3 -m venv venv
source venv/bin/activate

# 필수 라이브러리 설치
pip install fastapi uvicorn requests python-dotenv loguru

4. 실행하기

이때, 서버와 클로드 코드 실행을 위한 각각의 터미널(2개)가 필요합니다.

Terminal 1: 프록시 서버 실행

• NVIDIA API를 Claude API 형식으로 변환해주는 서버를 먼저 띄워야 합니다.

# 1. 프로젝트 폴더 이동 및 가상환경 활성화
cd ~/free-claude-code
source venv/bin/activate

# 2. NVIDIA API 키를 환경변수에 넣고 서버 실행
NVIDIA_NIM_API_KEY="본인의_nvapi_키_입력" python3 server.py

Terminal 2: Claude Code 접속

• 이제 Claude Code가 공식 서버가 아닌, 방금 만든 우리 로컬 서버를 바라보게 설정합니다.

# 1. API 주소를 로컬 서버(8082 포트)로 리다이렉트
export ANTHROPIC_BASE_URL="http://localhost:8082"

# 2. NVIDIA 모델명을 명시하여 실행
claude --model meta/llama-3.1-405b-instruct

---

위 단계가 모두 끝났다면 이제 터미널로 실행하는 방법만 알면 되겠죠? 그래서 저는 아래 명령어를 메모장에 옮겨놓고 실행하고 있답니다. (저처럼 매번 입력하기 귀찮다면 .zshre 등에 alias를 등록하면 훨씬 편리합니다.)

# terminal 1
cd free-claude-code
source venv/bin/activate
NVIDIA_NIM_API_KEY="본인의_nvapi_키_입력" python3 server.py

# terminal 2
export ANTHROPIC_BASE_URL="http://localhost:8082"
claude --model meta/llama-3.1-405b-instruct