Notice

Recent Posts

250x250

« 2026/04 »
일	월	화	수	목	금	토
			1	2	3	4
5	6	7	8	9	10	11
12	13	14	15	16	17	18
19	20	21	22	23	24	25
26	27	28	29	30

관리 메뉴

일상 코딩

[윈도우 개발 환경 설정] 12편: Claude Code 설치 & 활용 본문

Windows 개발환경 세팅

[윈도우 개발 환경 설정] 12편: Claude Code 설치 & 활용

polarcompass 2026. 3. 31. 22:30

728x90

Now I have enough information to write a comprehensive 12th article. Let me compile it.

12편: Claude Code 설치 & 활용

시리즈: 윈도우 네이티브 개발 환경 구축부터 클라우드 배포까지 (12/14)
환경: 로컬 — Windows 10/11 (PowerShell 7) · 원격 — Ubuntu/Debian (클라우드 리눅스 서버)
이전 편 전제: 1~11편까지 로컬 개발 환경 + 클라우드 서버 Caddy 구성 완료

서론

11편까지 로컬 개발 환경과 클라우드 서버를 모두 세팅했습니다. 이제 이 모든 환경 위에서 AI 코딩 어시스턴트를 얹을 차례입니다.

Claude Code는 Anthropic이 만든 CLI 기반 에이전틱 코딩 도구입니다. 터미널에서 자연어로 코드를 생성하고, 파일을 수정하고, 테스트를 실행하고, Git 커밋까지 해주는 "개발자 옆자리의 시니어 동료" 같은 존재입니다. 일반적인 AI 챗봇과 다른 점은 프로젝트 파일을 직접 읽고 쓸 수 있다는 것입니다. 질문에 답하는 데 그치지 않고, 실제로 코드를 변경합니다.

이번 편에서는 두 가지를 다룹니다. 첫째, 윈도우 로컬 환경에서 Claude Code를 설치하고 Antigravity IDE와 함께 사용하는 워크플로우. 둘째, 클라우드 리눅스 서버에 Claude Code를 설치하여 SSH로 접속한 뒤 Caddy 설정, Docker 관리 등 서버 운영 작업을 맡기는 방법입니다.

1. 사전 준비

1-1. 필수 요건

Claude Code를 사용하려면 다음이 필요합니다.

계정: Claude Pro($20/월), Max($100 또는 $200/월), Team, 또는 Enterprise 구독. 무료 플랜에서는 Claude Code를 사용할 수 없습니다. 또는 Anthropic Console(API 크레딧 선불 충전) 계정으로도 사용할 수 있습니다.

Git for Windows: Claude Code는 내부적으로 Git Bash를 사용하여 명령어를 실행합니다. 2편에서 이미 설치했으므로 별도 작업은 필요 없습니다.

시스템 요건: Windows 10 1809+ 또는 Windows 11, 4GB 이상 RAM, 인터넷 연결.

1-2. Git for Windows 확인

git --version

git version 2.47.1.windows.2

정상적으로 출력되면 준비 완료입니다.

2. 윈도우에 Claude Code 설치

설치 방법은 세 가지입니다. 상황에 맞는 것을 선택합니다.

2-1. 네이티브 인스톨러 (권장)

PowerShell 7에서 실행합니다.

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

설치가 완료되면 새 터미널 창을 열고 확인합니다.

claude --version

네이티브 인스톨러는 자동 업데이트를 지원합니다. 백그라운드에서 새 버전을 감지하면 자동으로 다운로드하고, 다음 실행 시 적용됩니다.

2-2. WinGet으로 설치

1편에서 설치한 WinGet을 사용합니다.

winget install Anthropic.ClaudeCode

WinGet으로 설치한 경우 자동 업데이트가 되지 않으므로, 수동으로 업데이트해야 합니다.

winget upgrade Anthropic.ClaudeCode

2-3. 설치 확인

# 버전 확인
claude --version

# 전체 환경 진단
claude doctor

claude doctor는 설치 상태, Git Bash 경로, 네트워크 연결 등을 종합적으로 점검해 줍니다. 문제가 있으면 원인과 해결 방법을 알려 줍니다.

2-4. Git Bash 경로 문제 해결

Claude Code가 Git Bash를 찾지 못하는 경우, 설정 파일에 경로를 명시합니다.

# 설정 파일 위치: ~/.claude/settings.json
notepad $env:USERPROFILE\.claude\settings.json

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

3. 로그인 & 인증

3-1. 첫 로그인

프로젝트 디렉토리에서 Claude Code를 시작합니다.

cd C:\Projects\my-react-app
claude

첫 실행 시 브라우저가 열리면서 로그인 화면이 나타납니다. Claude Pro/Max 구독 계정 또는 Anthropic Console 계정으로 로그인합니다. 인증이 완료되면 자격 증명이 로컬에 저장되어 이후에는 다시 로그인할 필요가 없습니다.

3-2. Anthropic Console (API 키) 사용

구독 대신 API 크레딧으로 사용하려면 Console 계정으로 로그인합니다. 첫 로그인 시 Claude Code 전용 워크스페이스가 자동 생성되어 비용을 추적할 수 있습니다.

3-3. 계정 전환

이미 로그인한 상태에서 다른 계정으로 전환하려면 세션 안에서 /login 명령을 실행합니다.

/login

4. 기본 사용법

4-1. 인터랙티브 모드

가장 기본적인 사용 방식입니다. 프로젝트 디렉토리에서 claude를 실행하면 대화형 세션이 시작됩니다.

cd C:\Projects\my-react-app
claude

자연어로 요청하면 Claude가 파일을 읽고, 코드를 수정하고, 명령어를 실행합니다.

> 이 프로젝트의 구조를 설명해줘

> src/components/Header.tsx에 다크모드 토글 버튼을 추가해줘

> 변경사항을 커밋해줘

Claude가 파일을 수정하거나 명령어를 실행할 때는 사전에 승인을 요청합니다. y를 눌러 승인하거나 n으로 거부할 수 있습니다.

4-2. 원샷 모드

짧은 질문이나 단일 작업은 -p 플래그로 세션 없이 실행할 수 있습니다.

# 질문하고 바로 종료
claude -p "이 프로젝트에서 사용하는 기술 스택을 알려줘"

# 빌드 에러 해결
claude -p "빌드 에러를 분석하고 수정해줘"

4-3. 원샷 명령 (세션 없이)

세션을 시작하지 않고 단일 작업을 실행합니다.

# 인용 부호 안에 작업을 지정
claude "lint 에러를 모두 수정해줘"

4-4. 이전 세션 이어서 하기

# 가장 최근 대화 이어서 하기
claude --continue
# 또는 짧게
claude -c

# 이전 대화 목록에서 선택
claude --resume
# 또는 짧게
claude -r

4-5. 핵심 명령어 정리

명령어	설명
`claude`	인터랙티브 세션 시작
`claude "작업"`	원샷 작업 실행
`claude -p "질문"`	질문 후 즉시 종료
`claude -c`	최근 대화 이어서 하기
`claude -r`	이전 대화 선택해서 이어서 하기
`claude commit`	Git 커밋 생성
`/clear`	대화 컨텍스트 초기화
`/compact`	컨텍스트 압축
`/help`	사용 가능한 명령어 보기
`/model`	모델 변경
`Esc`	현재 작업 중단
`Esc` + `Esc`	되감기 메뉴 열기
`Shift+Tab`	권한 모드 전환 (Normal → Auto → Plan)
`exit` 또는 `Ctrl+C`	세션 종료

5. 코드 생성 · 리팩토링 · 디버깅

5-1. 코드 생성

이 시리즈에서 구축한 기술 스택 기반으로 실제 예시를 살펴봅니다.

> React에서 사용자 프로필 페이지 컴포넌트를 만들어줘.
  TypeScript + Tailwind CSS로 작성하고,
  /api/v1/users/:id에서 데이터를 fetch해서 보여줘.
  로딩 상태와 에러 상태도 처리해줘.

> Go Gin에서 /api/v1/users/:id GET 엔드포인트를 만들어줘.
  PostgreSQL에서 사용자 정보를 조회하고,
  JSON으로 응답해줘. 에러 핸들링도 포함해줘.

> FastAPI에서 이미지 업로드 엔드포인트를 만들어줘.
  MinIO에 파일을 저장하고, 업로드된 파일의 URL을 반환해줘.

Claude는 프로젝트의 기존 파일을 읽고 패턴을 파악한 뒤, 일관된 스타일로 코드를 생성합니다.

5-2. 리팩토링

> src/api/handlers.go 파일이 500줄이 넘어.
  관련 기능별로 파일을 분리하고,
  공통 에러 핸들링을 미들웨어로 추출해줘.

> 콜백 패턴으로 작성된 src/services/auth.ts를
  async/await 패턴으로 리팩토링해줘.

5-3. 디버깅

> npm run build 하면 이런 에러가 나와:
  [에러 메시지 붙여넣기]
  원인을 분석하고 수정해줘.

또는 파이프로 에러 로그를 직접 전달할 수도 있습니다.

npm run build 2>&1 | claude -p "이 빌드 에러의 원인을 분석하고 수정해줘"

5-4. 테스트 작성

> src/utils/validation.ts에 대한 단위 테스트를 작성해줘.
  정상 케이스뿐 아니라 엣지 케이스도 포함해줘.
  기존 테스트 파일의 패턴을 따라줘.

Claude는 기존 테스트 파일의 프레임워크와 스타일을 분석하여 일관된 테스트를 생성합니다.

5-5. Plan Mode 활용

복잡한 작업은 먼저 계획을 세운 뒤 실행하는 것이 효과적입니다.

# Plan Mode로 시작
claude --permission-mode plan

> OAuth2 인증 시스템을 구현하려고 해.
  현재 코드베이스를 분석하고 구현 계획을 세워줘.

Plan Mode에서 Claude는 파일을 읽기만 하고 수정하지 않습니다. 계획이 만족스러우면 승인하고, Normal Mode로 전환하여 실행합니다. 세션 중에 Shift+Tab을 두 번 누르면 Plan Mode로 전환할 수 있습니다.

6. CLAUDE.md로 프로젝트 컨텍스트 설정

CLAUDE.md는 Claude Code가 세션을 시작할 때 자동으로 읽는 특수 파일입니다. 프로젝트의 규칙과 관례를 여기에 적어 두면, 매번 설명할 필요 없이 Claude가 이를 따릅니다.

6-1. 프로젝트 루트에 CLAUDE.md 생성

# 프로젝트: MyApp

## 기술 스택
- 프론트엔드: React 19 + TypeScript + Tailwind CSS + Vite
- 백엔드 API (Go): Go 1.23 + Gin
- 백엔드 API (Python): Python 3.12 + FastAPI
- DB: PostgreSQL 16 (Docker)
- 오브젝트 스토리지: MinIO (Docker)
- 웹 서버: Caddy (프로덕션 리눅스 서버)

## 코드 스타일
- TypeScript: ES modules (import/export), 절대 경로 import 사용 (@/ 접두사)
- Go: 표준 프로젝트 레이아웃, 에러는 반드시 처리 (_ 사용 금지)
- Python: Black 포맷터, type hints 필수, docstring은 Google 스타일

## 명령어
- 프론트엔드 개발 서버: `cd frontend && npm run dev`
- 프론트엔드 빌드: `cd frontend && npm run build`
- Go 서버 실행: `cd backend-go && go run cmd/server/main.go`
- Python 서버 실행: `cd backend-py && uvicorn app.main:app --reload`
- 전체 Docker 서비스: `docker compose up -d`
- Go 테스트: `cd backend-go && go test ./...`
- Python 테스트: `cd backend-py && pytest`

## 규칙
- 커밋 메시지는 Conventional Commits 형식 (feat:, fix:, docs: 등)
- 새 API 엔드포인트를 만들면 반드시 테스트도 작성
- IMPORTANT: 프론트엔드에서 pnpm 사용하지 않음. 반드시 npm 사용

6-2. CLAUDE.md 작성 팁

포함해야 할 것: Claude가 코드만 봐서는 알 수 없는 프로젝트 고유의 규칙과 명령어를 적습니다. 빌드 명령어, 테스트 실행 방법, 코드 스타일 규칙, 아키텍처 결정 사항이 대표적입니다.

제외해야 할 것: Claude가 코드를 읽으면 알 수 있는 것은 적지 않습니다. 파일별 설명이나 표준적인 언어 관례 같은 것은 불필요합니다. CLAUDE.md가 너무 길어지면 Claude가 중요한 지시를 놓칠 수 있습니다.

강조: 특히 중요한 규칙은 IMPORTANT나 YOU MUST 같은 강조 표현을 사용하면 Claude의 준수율이 높아집니다.

6-3. /init으로 자동 생성

프로젝트에 아직 CLAUDE.md가 없다면, Claude Code가 자동으로 분석하여 초안을 만들어 줍니다.

/init

이 명령은 빌드 시스템, 테스트 프레임워크, 코드 패턴을 감지하여 CLAUDE.md 초안을 생성합니다. 이를 기반으로 수정하면 됩니다.

7. Antigravity IDE와 함께 사용하기

Google Antigravity는 VS Code 포크이므로, Claude Code의 VS Code 확장을 그대로 사용할 수 있습니다.

7-1. 확장 설치

Antigravity에서 Ctrl+Shift+X를 눌러 Extensions 뷰를 열고, Claude Code를 검색하여 설치합니다. Anthropic 공식 확장(anthropic.claude-code)을 선택합니다.

7-2. GUI 패널에서 사용하기

확장을 설치하면 에디터 오른쪽에 Claude Code 패널이 나타납니다. 이 패널에서 대화형으로 Claude를 사용할 수 있습니다.

파일 참조: 프롬프트에 @파일명을 입력하면 해당 파일의 내용을 Claude에게 전달합니다. 퍼지 매칭을 지원하므로 @auth라고 입력하면 auth.js, AuthService.ts 등을 찾아줍니다.

선택 영역 참조: 에디터에서 코드를 선택한 상태로 Claude에게 질문하면, 선택한 코드가 자동으로 컨텍스트에 포함됩니다. Alt+K를 누르면 현재 파일 경로와 줄 번호가 프롬프트에 삽입됩니다.

권한 모드 전환: 프롬프트 입력창 하단의 모드 표시를 클릭하여 Normal, Plan, Auto-accept 모드를 전환할 수 있습니다.

7-3. 통합 터미널에서 CLI 사용하기

GUI 패널 대신 터미널에서 CLI를 사용하고 싶다면, Antigravity의 통합 터미널(Ctrl+``)을 열고claude`를 실행합니다.

claude

CLI는 자동으로 Antigravity와 연결되어 diff 뷰어, 진단 정보 공유 등 IDE 통합 기능을 활용합니다. 외부 터미널에서 Claude Code를 실행한 경우에는 세션 안에서 /ide를 입력하면 Antigravity와 연결됩니다.

7-4. 추천 워크플로우

일상적인 개발에서 Antigravity + Claude Code를 함께 사용하는 패턴입니다.

패턴 1 — GUI 패널로 대화하며 코딩: Antigravity 오른쪽 패널에서 Claude와 대화하며 코드를 작성합니다. 에디터에서 코드를 선택하고 "이 부분을 리팩토링해줘"라고 요청하면, Claude가 제안한 변경을 diff로 보여주고 승인하면 적용됩니다.

패턴 2 — 터미널에서 복잡한 작업 위임: 통합 터미널에서 claude를 실행하고, "전체 인증 시스템을 구현해줘"처럼 큰 작업을 위임합니다. Claude가 여러 파일을 읽고, 수정하고, 테스트까지 실행하는 동안 다른 작업을 할 수 있습니다.

패턴 3 — Git 워크플로우 통합: 작업이 끝나면 터미널에서 claude commit을 실행합니다. Claude가 변경사항을 분석하여 Conventional Commits 형식의 커밋 메시지를 생성하고, PR 생성까지 도와줍니다.

8. 클라우드 리눅스 서버에서 Claude Code 사용하기

여기서부터가 이번 편의 핵심입니다. 로컬 개발뿐 아니라, 원격 서버에 SSH로 접속하여 Caddy 설정, Docker 관리, 배포 작업 등을 Claude Code에 맡길 수 있습니다.

8-1. 접근 방식: 서버에 직접 설치

가장 직관적인 방법은 클라우드 서버에 Claude Code를 직접 설치하고, SSH 세션 안에서 Claude를 실행하는 것입니다. Claude가 서버의 파일 시스템에 직접 접근하므로 Caddyfile 수정, Docker Compose 관리, 로그 확인 등을 자연어로 처리할 수 있습니다.

8-2. 서버에 Claude Code 설치

SSH로 서버에 접속합니다.

# 윈도우 PowerShell에서
ssh user@your-server-ip

서버에서 Claude Code를 설치합니다.

# Git 설치 확인 (없으면 설치)
sudo apt update && sudo apt install -y git curl

# Claude Code 설치
curl -fsSL https://claude.ai/install.sh | bash

# 설치 확인
claude --version

8-3. tmux와 함께 사용하기 (필수)

SSH 연결이 끊어지면 Claude Code 세션도 종료됩니다. tmux를 사용하면 세션을 유지할 수 있습니다.

# tmux 설치
sudo apt install -y tmux

# 새 세션 생성
tmux new -s claude-server

# Claude Code 실행
cd /etc/caddy
claude

SSH 연결이 끊어져도 tmux 세션은 유지됩니다. 재접속 후 세션에 다시 붙습니다.

# SSH 재접속 후
tmux attach -t claude-server

8-4. Caddy 설정 맡기기

서버에서 Claude Code를 실행한 뒤, Caddy 관련 작업을 자연어로 요청합니다.

> /etc/caddy/Caddyfile을 확인하고 현재 설정을 설명해줘

> myapp.example.com에 대한 리버스 프록시를 추가해줘.
  Go 백엔드가 localhost:8080에서 돌아가고 있어.
  보안 헤더도 추가하고, 로그도 설정해줘.

> Caddyfile 문법이 맞는지 검증하고,
  문제없으면 caddy reload를 실행해줘.

Claude는 caddy validate로 문법을 검증한 뒤, sudo systemctl reload caddy로 적용합니다. 변경 전에 항상 승인을 요청하므로 안전합니다.

8-5. Docker 컨테이너 관리 맡기기

> docker compose ps로 현재 실행 중인 컨테이너 상태를 확인해줘

> PostgreSQL 컨테이너의 최근 로그를 확인해줘.
  에러가 있으면 원인을 분석해줘.

> docker-compose.yml에 MinIO 서비스를 추가해줘.
  9편에서 만든 설정을 기반으로 하되,
  프로덕션 환경에 맞게 리소스 제한도 설정해줘.

8-6. 서버 모니터링 & 트러블슈팅

> 디스크 사용량을 확인해줘. 80% 넘는 파티션이 있으면 알려줘.

> 최근 1시간 동안 Caddy 액세스 로그에서
  4xx, 5xx 에러를 분석해줘.

> systemctl status로 caddy, docker 서비스 상태를 확인하고,
  비정상인 게 있으면 알려줘.

8-7. 서버용 CLAUDE.md 작성

서버 프로젝트 디렉토리(예: /opt/myapp)에도 CLAUDE.md를 만들어 두면 서버 환경에 특화된 지시를 줄 수 있습니다.

sudo mkdir -p /opt/myapp
sudo tee /opt/myapp/CLAUDE.md > /dev/null <<'EOF'
# 서버: MyApp Production

## 환경 정보
- OS: Ubuntu 22.04 LTS
- IP: 203.0.113.10
- 도메인: myapp.example.com, go-api.example.com, py-api.example.com

## 서비스 구성
- Caddy: systemd 서비스 (/etc/caddy/Caddyfile)
- Docker Compose: /opt/myapp/docker-compose.yml
  - PostgreSQL (포트 5432)
  - MinIO (포트 9000, 9001)
  - n8n (포트 5678)
  - Go API (포트 8080)
  - Python API (포트 8000)

## 주요 명령어
- Caddy 설정 검증: `caddy validate --config /etc/caddy/Caddyfile`
- Caddy 리로드: `sudo systemctl reload caddy`
- Docker 서비스 상태: `docker compose -f /opt/myapp/docker-compose.yml ps`
- Docker 로그: `docker compose -f /opt/myapp/docker-compose.yml logs -f [서비스명]`

## 규칙
- IMPORTANT: Caddyfile 수정 전 반드시 caddy validate 실행
- IMPORTANT: docker-compose.yml 수정 시 기존 볼륨 데이터 보존 확인
- 방화벽 규칙 변경 시 반드시 사용자에게 확인 요청
- 인증서 관련 작업 시 Let's Encrypt 레이트 리밋 주의
EOF

이후 이 디렉토리에서 Claude Code를 실행하면 서버 컨텍스트가 자동으로 로드됩니다.

cd /opt/myapp
claude

9. 로컬에서 SSH 명령을 Claude Code에 맡기기 (대안)

서버에 Claude Code를 설치하지 않고, 로컬 Claude Code 세션에서 SSH 명령을 실행하는 방식도 있습니다. Claude Code는 Bash 도구를 통해 ssh 명령을 실행할 수 있으므로, 로컬에서 원격 서버를 제어할 수 있습니다.

9-1. SSH 키 기반 인증 설정

먼저 비밀번호 없이 SSH에 접속할 수 있도록 키를 설정합니다. (2편에서 SSH 키를 이미 생성했다면 해당 키를 사용합니다.)

# 공개 키를 서버에 복사
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh user@your-server-ip "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

비밀번호 프롬프트 없이 접속되는지 확인합니다.

ssh user@your-server-ip "hostname"

9-2. SSH 설정 간소화

~/.ssh/config에 서버 별칭을 등록합니다.

notepad $env:USERPROFILE\.ssh\config

Host myserver
    HostName 203.0.113.10
    User deploy
    IdentityFile ~/.ssh/id_ed25519

이제 ssh myserver로 간단히 접속할 수 있습니다.

9-3. 로컬 Claude Code에서 원격 명령 실행

로컬 프로젝트에서 Claude Code를 실행한 뒤, SSH 명령을 요청합니다.

> ssh myserver로 접속해서 Caddy 서비스 상태를 확인해줘

> ssh myserver에서 /etc/caddy/Caddyfile을 읽어서 보여줘.
  go-api.example.com에 CORS 헤더를 추가하고 적용해줘.

> ssh myserver에서 docker compose ps를 실행해서
  모든 컨테이너가 정상인지 확인해줘.

Claude는 내부적으로 ssh myserver "caddy validate --config /etc/caddy/Caddyfile" 같은 명령을 생성하여 실행합니다. 각 명령 실행 전에 승인을 요청하므로 안전합니다.

9-4. 두 방식 비교

서버에 직접 설치 방식은 Claude가 서버 파일 시스템에 직접 접근하므로 파일 읽기/쓰기가 자연스럽고, 복잡한 작업(여러 파일을 동시에 수정, 로그 분석 등)에 적합합니다. 장시간 작업 시 tmux로 세션을 유지할 수 있습니다.

로컬에서 SSH로 원격 실행 방식은 서버에 별도 설치가 필요 없고, 로컬 프로젝트 작업과 서버 관리를 하나의 세션에서 전환하며 할 수 있습니다. 다만 모든 명령이 SSH를 경유하므로 파일을 한 번에 여러 개 수정하는 작업은 다소 번거롭습니다.

간단한 확인이나 설정 변경은 로컬 SSH 방식으로, Caddy 설정을 대폭 변경하거나 Docker Compose를 재구성하는 등의 복잡한 서버 작업은 서버에 직접 접속하여 Claude Code를 실행하는 것을 권장합니다.

10. 실전 시나리오: 배포 워크플로우

지금까지 배운 내용을 종합하여, 프론트엔드 빌드 → 서버 배포 → Caddy 설정까지의 워크플로우를 Claude Code로 처리하는 예시입니다.

10-1. 로컬: 프론트엔드 빌드 & 전송

cd C:\Projects\my-react-app\frontend
claude

> npm run build를 실행하고,
  빌드가 성공하면 dist 폴더를 scp로 myserver:/var/www/myapp에 전송해줘.

10-2. 서버: Caddy 설정 & 서비스 확인

# 서버에 SSH 접속 후
tmux attach -t claude-server
cd /opt/myapp
claude

> /var/www/myapp에 새 빌드 파일이 잘 올라왔는지 확인해줘.

> Caddyfile에서 myapp.example.com 설정이
  11편에서 만든 프로덕션 설정과 일치하는지 확인해줘.
  SPA 폴백, 캐시 헤더, 보안 헤더가 모두 포함되어 있어야 해.

> 모든 Docker 서비스가 정상 동작하는지 확인하고,
  curl로 각 엔드포인트가 응답하는지 테스트해줘.

10-3. 검증

> 다음 항목을 순서대로 확인해줘:
  1. https://myapp.example.com 접속 시 React 앱이 로드되는지
  2. https://myapp.example.com/any/path 접속 시 SPA 폴백이 동작하는지
  3. https://go-api.example.com/health 응답이 200인지
  4. https://py-api.example.com/health 응답이 200인지
  5. SSL 인증서가 유효한지

11. 유용한 팁

11-1. 컨텍스트 관리

Claude Code의 성능은 컨텍스트 윈도우 사용량에 영향을 받습니다. 관련 없는 작업을 전환할 때는 /clear로 컨텍스트를 초기화하고, 긴 세션에서는 /compact로 요약하여 정리합니다.

11-2. 서브에이전트 활용

큰 코드베이스를 탐색할 때는 서브에이전트를 사용하면 메인 컨텍스트를 오염시키지 않습니다.

> 서브에이전트를 사용해서 인증 시스템의 토큰 갱신 로직을 조사해줘.

11-3. Git Worktree로 병렬 작업

여러 기능을 동시에 개발할 때 Worktree를 사용하면 각 세션이 독립된 파일 시스템을 가집니다.

# 기능 A를 위한 Worktree에서 Claude 시작
claude --worktree feature-auth

# 별도 터미널에서 기능 B 작업
claude --worktree bugfix-login

11-4. 업데이트 채널 설정

안정적인 버전을 사용하고 싶다면 stable 채널로 설정합니다.

// ~/.claude/settings.json
{
  "autoUpdatesChannel": "stable"
}

12. 확인 체크리스트

윈도우 로컬 환경

# 1. Claude Code 설치 확인
claude --version

# 2. 환경 진단
claude doctor

# 3. 인터랙티브 세션 시작 & 로그인 확인
cd C:\Projects\my-react-app
claude
# 세션 내에서:
#   > 이 프로젝트의 구조를 설명해줘
#   정상 응답 확인 후 exit

Antigravity 확장

Claude Code 확장 설치 완료
에디터 사이드 패널에서 대화 가능
@파일명으로 파일 참조 동작 확인
통합 터미널에서 claude CLI 실행 가능

클라우드 리눅스 서버

# 서버 SSH 접속 후
# 1. Claude Code 설치 확인
claude --version

# 2. tmux 세션에서 실행
tmux new -s claude-server
claude

# 3. 서버 작업 테스트
#   > 현재 서버의 디스크 사용량과 메모리 상태를 확인해줘
#   정상 응답 확인 후 exit

체크리스트 요약

윈도우에 Claude Code 설치 완료 & 버전 확인
claude doctor 진단 통과
Claude 계정 로그인 완료
인터랙티브 세션에서 코드 생성 · 수정 동작 확인
Antigravity에 Claude Code 확장 설치 & 동작 확인
프로젝트 루트에 CLAUDE.md 작성 완료
클라우드 서버에 Claude Code 설치 완료 (선택)
SSH를 통한 원격 서버 작업 가능 확인
tmux로 서버 세션 유지 가능 확인

다음 편 예고

12편에서 Claude Code를 로컬 개발과 원격 서버 관리 양쪽에 모두 활용하는 방법을 다뤘습니다. 이제 AI 어시스턴트가 코딩과 서버 운영 모두를 도와주는 환경이 갖춰졌습니다.

13편: 클라우드 서버 비교 & 선택 가이드에서는 AWS, GCP, Azure, 그리고 Vultr, Hetzner 같은 대안까지 비교하여, 이 시리즈의 기술 스택을 실제로 올릴 서버를 선택하는 기준을 제시합니다.