클로드 코드 사용법 2026 — 설치부터 첫 커밋까지, 2025년 글은 절반이 틀렸다

URL에는 2025가 남아 있지만 내용은 2026년 8월 기준으로 전면 갱신했습니다. 기존 링크를 깨뜨리지 않으려고 주소는 그대로 둡니다. 최종 업데이트: 2026-08-25

요약: 클로드 코드 사용법, 2026년엔 뭐가 달라졌나?

• 클로드코드는 터미널 전용 CLI가 아니다. 터미널·VS Code·JetBrains·데스크톱 앱·웹·모바일·Slack·Chrome이 같은 설정을 공유한다.
• 설치는 npm install -g가 아니라 네이티브 인스톨러 한 줄이다.
• 모델은 Opus 5, Sonnet 5, Fable 5, Haiku 4.5. 앞 셋은 컨텍스트가 1M 토큰이다.
• 사고 깊이는 토큰 예산이 아니라 effort(low~`max)로 정한다. budget_tokens`는 400 에러다.
• 2026년 8월 14일부터 auto 모드가 Pro·Max·Team의 기본 권한 모드다.

한국어 클로드 코드 입문 글은 대부분 2025년에 쓰였다. 설치 명령도, 모델 이름도, 사고 예산 지정 방식도 그때와 다르다. "터미널에서 실행하는 CLI 도구"라는 첫 문장부터 사실이 아니다. 그래서 설치법보다 어디서 쓸 수 있는가를 먼저 본다.

1. 클로드 코드가 도는 곳

새 기능은 터미널 CLI에 가장 먼저 들어온다. 하지만 지금은 VS Code·Cursor 확장(인라인 diff와 plan 리뷰), JetBrains 플러그인, 데스크톱 앱(시각적 diff·병렬 세션·예약 작업), 웹(claude.ai/code, 설치 불필요), 모바일 앱, Slack의 @Claude 멘션, Chrome까지 문이 여덟 개다.

개수보다 중요한 건 전부 같은 CLAUDE.md와 같은 MCP 설정을 읽는다는 점이다. 세션도 옮겨 다닌다. claude --teleport로 웹 세션을 터미널에 끌어오고 /desktop으로 터미널 세션을 데스크톱 앱에 띄운다.

2. 설치

curl -fsSL https://claude.ai/install.sh | bash   # macOS·리눅스·WSL
irm https://claude.ai/install.ps1 | iex          # 윈도우 PowerShell

패키지 매니저는 brew install --cask claude-code, winget install Anthropic.ClaudeCode. Homebrew의 claude-code는 안정 채널이라 일주일쯤 늦고 claude-code@latest가 최신이다. 네이티브 인스톨러만 자동 업데이트된다.

윈도우에서 Git for Windows는 더 이상 필수가 아니다. 2026년 18주차(v2.1.120)부터 없으면 PowerShell을 셸 툴로 쓴다. 설치 후엔 프로젝트 폴더에서 claude를 치면 되고, 꼬였다 싶으면 /doctor가 셋업을 점검해 고쳐 준다.

3. 첫 작업 30분

/init을 친다. 매 세션 자동으로 읽히는 CLAUDE.md 초안을 만들어 준다. 여기서 욕심내면 안 된다. 공식 문서가 "이 줄을 지우면 클로드가 실수하게 되는가"를 묻고 아니면 지우라고 못을 박아 뒀다. 긴 CLAUDE.md는 절반이 무시된다. 배치와 병합 순서는 클로드 코드 CLAUDE.md 작성법에 있다.

Shift+Tab으로 plan 모드에 들어간다. 파일을 건드리지 않고 계획만 내놓는다. 계획을 고치는 게 코드를 되돌리는 것보다 싸다. 더 형식을 갖춘 방법론은 스펙 주도 개발 쪽이다.

검증 조건을 준다. 여기가 갈린다. "로그인 버그 고쳐줘"보다 "npm test -- auth가 통과할 때까지 고쳐줘"가 낫다. 스스로 채점할 수단이 있어야 한다. 조건을 세션 목표로 고정하려면 /goal을 쓴다. 왜 이 루프가 결정적인지는 에이전트 하네스 엔지니어링에 있다.

커밋한다. "변경사항을 논리 단위로 나눠 커밋해줘"라고 하면 diff를 읽고 메시지까지 쓴다. 아니다 싶으면 Esc 두 번이나 /rewind로 되돌린다.

네 단계를 한 문장으로 붙이면 이렇게 된다. plan 모드에서 "회원가입 폼에 이메일 중복 검사를 붙이고 싶다. npm test -- signup이 통과하는 상태로 끝내줘"라고 던진 뒤, 나온 계획을 읽고 고치고, Shift+Tab으로 빠져나와 실행시키고, 테스트가 초록이 되면 커밋시킨다.

4. 모델과 effort

모델 ID에 날짜를 붙이지 말자. claude-opus-5가 완전한 ID다. Opus 5는 v2.1.219+, Sonnet 5는 v2.1.197+, Fable 5는 v2.1.170+가 필요하고 Fable 5는 /model fable로 직접 고른다.

사고 깊이는 effort로 정한다. low부터 max까지 다섯 단계, 기본은 high, /effort xhigh로 바꾼다. 2025년 글이 자주 틀리는 두 가지가 여기 있다. budget_tokens로 예산을 숫자로 지정하는 방식은 사라져 최신 모델에선 400 에러이고, ultrathink는 살아 있지만 think hard는 키워드가 아니라 그냥 텍스트다.

5. 권한과 컨텍스트

2026년 8월 14일부터 Pro·Max·Team의 대화형 세션은 auto 모드가 기본이다. 별도 분류기 모델이 행동을 검토해 위험한 것만 막는다. 모드는 여섯 가지, Shift+Tab으로 순환한다. 확인 누르기 싫으니 권한 검사를 통째로 끄라던 2025년식 안내가 무의미해진 이유다. 검사를 완전히 우회하는 모드는 격리된 컨테이너나 VM에서 돌릴 때를 위한 물건으로 자리가 내려갔다. 일상 작업이라면 손댈 일이 없다.

컨텍스트 창은 여전히 성능의 근본 제약이다. 작업을 바꿀 땐 /clear, 이어가야 하면 /compact <지시>, 되돌리려면 /rewind, 곁질문은 기록에 안 남는 /btw, 지금 뭐가 로드됐는지는 /context. 범위 없는 "이 코드베이스 조사해줘"가 대표적인 낭비다.

6. 2025년 글에서 지울 것

7. 다음 단계

Claude Code는 Free에 없고 Pro부터 포함된다. Max는 한도가 넓고, Team은 Standard·Premium 두 단계, Enterprise는 시트 단위다. 가격 표기는 결제 통화에 따라 다르니 공식 가격 페이지에서 확인하자. 남은 한도는 /usage가 스킬·서브에이전트·플러그인·MCP별로 쪼개 보여주고, 피크타임 배분 변경은 클로드 코드 사용량 한도에 정리해 뒀다.

맥에서 GUI로 여러 작업을 동시에 굴리려면 클로드 코드 병렬 실행, 외부 이벤트를 실행 중인 세션에 밀어 넣으려면 클로드 코드 Channels로 가면 된다. Channels는 병렬 실행 수단이 아니라 알림 통로다.

출처

• Anthropic Claude Code 공식 문서