클로드 코드(Claude Code), 서버에 설치하면 뭐가 달라질까? 윈도우 vs 리눅스 비용까지

 

클로드 코드를 며칠 써봤는데, 문득 이런 생각이 들었어요.

"이거 그냥 서버에 올려두면 24시간 돌아가는 거 아닌가?"

맞아요. 가능합니다. 근데 막상 해보려고 하면 막막하거든요. 윈도우랑 뭐가 다른지, 토큰 비용은 차이 나는지, 세션이 중간에 끊기지는 않는지.

오늘은 그 부분을 풀어볼게요.

---

클로드 코드가 뭔지 한 줄로 정리하면

터미널에서 Claude한테 말 걸 수 있는 CLI 도구예요.

채팅창 아니고, 코드 에디터 플러그인도 아니고, 그냥 터미널에서 claude라고 치면 실행되는 도구입니다. 파일 읽고, 코드 고치고, git 커밋까지 알아서 해줘요.

그러니까 서버에 올리면? 이론상 24시간 돌아가는 AI 에이전트가 생기는 거죠.

---

윈도우에서 쓰는 것, 뭐가 불편했냐면

솔직히 저도 처음엔 윈도우에서 시작했어요.

윈도우에서 클로드 코드 설치하려면 WSL(Windows Subsystem for Linux)을 먼저 깔아야 해요. 윈도우 안에 리눅스를 올리는 셈이죠. 이 과정이 은근히 손이 많이 갑니다.

그리고 또 하나.

OAuth 인증 때문에 브라우저가 열려야 해요.

서버처럼 화면이 없는 환경에서는 이게 막혀버려요. 브라우저가 없으니까요.

근데 여기서 중요한 게 있어요. "그럼 API 키로 인증하면 되겠네" 하고 넘어가면 안 돼요.

API 키로 인증하는 순간, Pro 구독이 있어도 토큰 종량제로 과금이 시작됩니다.

Pro 구독자라면 다른 방법을 써야 해요.

---

리눅스 서버에 클로드 코드 설치하는 법

생각보다 간단해요.

공식 권장 방법은 네이티브 설치 스크립트입니다. Node.js 같은 의존성 없이 바로 설치되거든요.

curl -fsSL https://claude.ai/install.sh | bash

한 줄이에요. 이게 끝입니다.

그다음이 포인트예요. 서버에는 브라우저가 없으니까 로그인을 다른 방식으로 해야 해요.

방법은 이렇습니다. 로컬 PC에서 먼저 claude를 실행해서 브라우저 로그인을 완료해요. 그러면 인증 정보가 파일로 저장되거든요. 그걸 서버로 복사하면 끝입니다.

# 로컬 PC에서 먼저 로그인 완료 후
# 생성된 인증 파일을 서버로 복사
scp ~/.claude/.credentials.json user@내서버주소:~/.claude/

이러면 서버에서도 Pro 구독 그대로 동작해요. API 별도 결제 없이요.

주의할 게 하나 있어요.

ANTHROPIC_API_KEY 환경변수가 서버에 설정되어 있으면, Pro 구독이 있어도 무조건 API 키를 우선으로 써버려요. 그러면 토큰 종량제로 과금됩니다. 이 환경변수가 없는지 꼭 확인하세요.

# 혹시 설정되어 있는지 확인
echo $ANTHROPIC_API_KEY
# 아무것도 안 나오면 OK

[이미지 삽입] 키워드: "Claude Code terminal SSH Linux server" / 설명: 리눅스 서버 터미널에서 SSH로 접속해 클로드 코드를 실행하는 화면 예시

---

서버에서 세션이 끊기지 않으려면: tmux

여기서 실제로 가장 중요한 부분입니다.

SSH로 서버에 접속해서 claude를 실행했는데, 인터넷이 잠깐 끊기거나 터미널을 닫으면? 그 세션은 그냥 죽어요. 진행 중이던 작업도 같이요.

이걸 막는 게 tmux입니다.

화면 녹화처럼, 터미널 세션을 서버에 남겨두는 도구예요. 접속 끊어도 안 꺼져요.

# tmux 설치
sudo apt install tmux

# 세션 시작
tmux new -s claude-session

# 여기서 claude 실행
claude

# 나갈 때: Ctrl+B, 그다음 D (세션은 서버에 계속 살아있음)

# 나중에 다시 붙으려면
tmux attach -t claude-session

이렇게 해두면, 서버에서 클로드 코드가 작업을 계속 처리합니다. 장시간 리팩토링, 테스트 수정, 문서화 같은 작업도 끊기지 않고 돌아가요.

---

토큰 비용 차이가 날까? — 이게 진짜 포인트

서버에 올린다고 해서 토큰 비용이 달라지진 않아요.

클로드 코드 비용 구조는 크게 두 가지입니다.

1. 구독 방식 (Pro / Max 플랜) 월 정액을 내고 쓰는 방식이에요. 토큰 단위 과금은 없고 대신 사용량 제한이 있어요.

2. API 종량제 방식 쓴 만큼 내는 방식이에요. 서버 자동화 작업이나 CI/CD 파이프라인에서 호출할 때는 이 방식을 써야 해요. 구독 플랜은 사람이 직접 쓰는 대화형 사용에만 적용되거든요.

---

구독 플랜 실제 결제 금액 (카드 수수료 포함)

기준: 환율 1,500원 / 해외 카드 수수료 1.5% 적용 (실효환율 1,522.5원) 카드사마다 수수료가 다를 수 있어요. 보통 1~2% 사이입니다.

플랜 달러 요금 원화 환산 카드 수수료 (+1.5%) 실제 결제액 사용량 한도

Pro	$20	30,000원	+450원	약 30,450원	5시간마다 10~40개 프롬프트
Max 5x	$100	150,000원	+2,250원	약 152,250원	Pro의 5배
Max 20x	$200	300,000원	+4,500원	약 304,500원	Pro의 20배

---

API 종량제 요금표 (Sonnet 4.6 기준, 2026년 5월)

항목 달러 요금 원화 환산 비고

입력 토큰	$3 / 100만 토큰	약 4,570원	프롬프트, 코드 컨텍스트
출력 토큰	$15 / 100만 토큰	약 22,840원	Claude 응답
프롬프트 캐싱 적용 시	입력의 10%	약 457원	최대 90% 절감
Batch API 적용 시	전체의 50%	—	자동화 배치 작업용

API 결제도 해외 결제라 카드 수수료 1.5% 동일하게 붙어요.

---

실제로 한 달 쓰면 얼마 나올까?

숫자로 직접 비교해볼게요.

공식 문서 기준으로 API 사용 시 개발자 한 명이 하루 평균 $13 수준이에요. 한 달 22일 기준이면 약 $286, 카드 수수료 붙으면 약 43만 5천원입니다.

Pro 구독은 카드 수수료 포함해도 약 3만 450원. 거의 14배 차이예요.

사용 패턴 API 종량제 월 비용 (원화, 수수료 포함) 구독 실제 결제액 절감액

가벼운 사용 (하루 1~2시간)	약 46,000~92,000원	Pro 30,450원	최대 6만원 절감
보통 사용 (하루 3~5시간)	약 152,000~274,000원	Max 5x 152,250원	최대 12만원 절감
헤비 사용 (하루 종일)	약 380,000~609,000원	Max 20x 304,500원	최대 30만원 절감

---

여기서 반전이 있어요.

구독 플랜을 쓰면 Anthropic이 서버 단에서 캐싱을 공격적으로 관리해줘요. 코드베이스를 한 번 읽어들이면 그다음 질문부터는 이미 읽은 코드를 다시 토큰으로 세지 않아요. 근데 API로 직접 쓰면? 캐싱 설정을 해도 input 토큰 비용이 계속 누적됩니다.

실제 사례가 있어요. 한 개발자가 8개월간 Max 구독($100/월)으로 사용한 결과, API 정가로 환산하면 $15,000이 넘는 양을 썼는데 실제 구독료는 $800뿐이었다고 해요. 원화로 따지면 구독료 약 122만원으로 약 2,280만원 어치를 쓴 셈이에요. 94% 절감입니다.

자동화 배치 작업이 아닌, 사람이 직접 작업하면서 서버에 올려두는 거라면 구독 방식이 훨씬 경제적이에요.

Claude Code 구독 API 방식 가격 비교

---

서버에서 헤드리스 모드로 자동 실행도 돼요

대화형이 아니라, 명령어 하나로 작업 지시하고 결과만 받고 싶을 때도 있잖아요.

그럴 땐 -p 옵션을 쓰면 됩니다.

# SSH로 서버 들어가서 바로 실행
ssh user@my-server "cd /opt/myproject && claude -p '테스트 코드 돌리고 실패한 것만 수정해줘'"

이게 가능해지면 얘기가 달라져요. 스케줄러(cron)랑 붙여서 매일 새벽에 코드 리뷰를 자동 실행하거나, 배포 전에 자동으로 테스트 수정을 요청하는 것도 됩니다.

다만 주의할 점이 있어요.

출력이 너무 많으면 잘려요. 수천 줄짜리 로그를 그대로 넘기면 안 되고, tail -n 50이나 grep으로 필요한 부분만 보내줘야 해요.

---

솔직하게 정리하면

서버에 설치했을 때 진짜 달라지는 건 이겁니다.

장시간 작업이 가능해져요. 윈도우 로컬에서 돌리면 PC 끄면 끝이지만, 서버는 계속 돌아가거든요.

토큰 비용 자체는 환경에 따라 달라지지 않아요. 비용 차이는 인증 방식(구독 vs API)에서 납니다.

그리고 서버에 올리는 게 훨씬 안정적이에요. 특히 tmux 조합하면 끊김 없이 오래 돌리는 게 가능합니다.

결국 핵심은 이거예요.

일상적인 코딩 작업에는 구독 + 서버 조합이 가장 경제적이고, 자동화 파이프라인에는 API가 맞다.

서버 하나 있다면 한번 올려보세요. 막혀도 설치 명령어 한 줄에 다 담겨 있으니까요.