Claude Code

Claude Code 실전 가이드. CLI 설치와 설정, Pro·Max 요금제 한도와 API 과금, 일상 개발 워크플로, 자주 발생하는 오류의 해결 방법을 정리했습니다.

글 66개
최근 업데이트 2026년 11월 5일

Claude Code 터미널의 API Error 403 본인인증 요청 메시지와 portal.anthropic.com 링크, 재실행과 /login으로는 같은 403이 반복된다는 안내

최신 글

Claude Code "can't receive replies from Claude" 오류: 본인인증 요청

Your account can't receive replies from Claude right now는 Claude Code 버그가 아닌 계정 본인인증 요청이라 /login으로 풀리지 않습니다.

2026년 11월 5일9 분

Claude Code 이미지 생성 방법 표지: SVG 코드 렌더링은 추가 요금 없음, 스크립트·스킬은 이미지 API 호출, MCP 서버는 모델을 바꿔 쓰는 세 경로

Claude Code 이미지 생성 방법: 코드 렌더링·스크립트·MCP 고르기

Claude Code는 픽셀을 직접 만들지 않습니다. 도표와 글자 커버는 SVG를 렌더링하고, 사진과 일러스트는 스크립트나 MCP로 외부 이미지 모델을 호출하며 요금은 호출마다 붙습니다.

2026년 11월 5일10 분

Claude Code Dynamic Workflows 적용 판단, 연구 미리보기 상태, 작은 범위 시작 규칙을 보여주는 route board

Claude Code Dynamic Workflows: 언제 쓰고, ultracode가 무엇을 바꾸며, 어떻게 안전하게 시작할까

Claude Code Dynamic Workflows 실무 가이드. 계획이 스크립트가 되어야 하는 순간, ultracode가 바꾸는 점, 더 작은 Claude Code 표면으로 돌아가야 하는 경우, 사용량과 권한 리스크를 다룹니다.

2026년 11월 3일7 분

Claude Code Ultracode 의사결정 보드: 명령, 사용 사례, 피해야 할 작업, 비용 중단 규칙

Claude Code Ultracode란: /effort ultracode 사용법, xhigh·동적 워크플로우

Claude Code Ultracode는 동적 워크플로우 스위치로, v2.1.284부터 켜도 effort는 그대로입니다. --effort ultracode로 시작할 때만 xhigh도 설정됩니다.

2026년 11월 3일12 분

Claude Code effort 기본값: Opus·Sonnet·Haiku 5.5는 medium, Fable 5.1·Opus 5는 high, Opus 4.7은 xhigh

Claude Code effort 설정과 차이: Opus 5.5 기본값 medium, 안 먹힐 때 해결

Claude Code effort는 한 요청의 작업량입니다. 5.5 계열 기본값은 medium이며, 사용자 설정 최상위 effortLevel은 Opus 5.5가 무시하니 /effort로 저장하세요.

2026년 11월 2일12 분

Claude Code LSP를 플래그 없이 켜는 구성: 직접 설치한 언어 서버와 공식 플러그인을 더하면 편집 후 진단 줄이 표시됨

Claude Code LSP 설정: 플래그 없이 플러그인과 언어 서버, 안 될 때 해결법

Claude Code LSP는 플래그가 아니라 직접 설치한 언어 서버와 공식 코드 인텔리전스 플러그인으로 켭니다. 진단 줄이 안 뜨면 대개 공식 마켓플레이스 미등록이나 PATH 문제입니다.

2026년 11월 2일14 분

Claude Code Max 결제 후 계정 정지 상태를 구분하고 이의 제기와 환불 절차로 이어지는 흐름을 보여주는 표지

Claude Code Max 결제 후 즉시 계정 차단? 계정 정지 해제·환불 방법

Claude Max 결제 직후 계정 정지·보류가 떴다면 claude.ai/restricted에서 이의 제기하고 환불은 메신저로 요청합니다. 한국은 지원 국가라 VPN 없이 본인 카드로 결제합니다.

2026년 11월 2일17 분

Pro를 기본 선택으로 두고 Max 5x와 Max 20x 가격 및 중단 비용 기준을 보여주는 비교 이미지

Claude Pro vs Max vs Ultra 2026: 가격, Claude Code 제한, Max 손익분기점

10월 30일부터 Max 5x는 Max($100), Max 20x는 Ultra($200)이고 인증된 Ultra는 5시간 한도가 없습니다. Pro 크레딧이 월 $80를 넘으면 Max가 쌉니다.

2026년 11월 1일17 분

Claude Code cache miss 경로, write/read 비율, cache fields, stop rule 확인 보드

Claude Code 캐시 미스 토큰 비용: 한 turn 이 갑자기 비싸지는 이유

Claude Code 캐시 미스는 별도 벌금 항목이 아닙니다. 경로, cache creation, cache read, 직전 무효화 행동, 해당 청구 화면을 먼저 맞춰 봐야 합니다.

2026년 10월 30일8 분

Claude Code의 Opus·Sonnet·Haiku 슬롯에 모두 GLM-5.3-Flash를 지정한 설정과 슬롯별로 처리하는 요청

GLM-5.3-Flash Claude Code 설정: Flash로 도는 슬롯 매핑과 effort

Claude Code에서 GLM-5.3-Flash를 쓰려면 Opus 슬롯까지 Flash로 지정해야 메인 대화가 Flash로 돕니다. 기본 effort는 Z.ai 권장 max가 아닌 high입니다.

2026년 10월 30일10 분

Gemini 4 Carbon AA 지수 59.4점과 Opus 5.5 max 58.4점, 한국어 입력 토큰 1.94배, Opus는 지금 사용 가능하고 Carbon은 일반 공개 전임을 보여 주는 표지

Gemini 4 Carbon vs Opus 5.5 비교: 단가 같아도 한국어는 Opus 토큰 1.94배

Gemini 4 Carbon은 추론·사실 확인에서, Claude Opus 5.5는 문서 업무와 Claude Code에서 앞섭니다. 2026년 10월 29일 기준 일반에 열린 건 Opus뿐입니다.

2026년 10월 29일11 분

Claude Haiku 5.5와 Sonnet 5.5 비교: 토큰 단가 1/20, 같은 41점 기준 작업 1건 비용 $0.12 대 $0.48, 시간 291초 대 126초(AA v4.3.2 수치)

Claude Haiku 5.5 vs Sonnet 5.5 차이: 단가는 20배, 어떤 작업을 옮길까

Haiku 5.5는 10만 토큰 이하에서 Sonnet 5.5 단가의 1/20입니다. 분류·요약·서브에이전트는 Haiku, 에이전트 코딩은 Sonnet, 자동 검증되는 작업은 Haiku부터 쓰세요.

2026년 10월 28일15 분

Claude Opus 5.5 vs GPT-6.1 Sol 표지: 272K 이하 단가 2배, 같은 effort 과제당 비용 4.2~8.9배, 272K 초과 요청은 출력 단가 1.33배, 기본 모델은 GPT-6.1 Sol

Claude Opus 5.5 vs GPT-6 Sol·6.1 Sol 비용

GPT-6.1 Sol 기준 272K 이하 요청에서 Opus 5.5는 캐시 읽기까지 모든 단가가 2배, 과제당 비용은 6~8배입니다. 기본은 6.1 Sol, Opus는 실패하는 작업에만 시험합니다.

2026년 10월 28일15 분

추론 강도 max에서 Claude Sonnet 5.5와 GPT-6 Astra를 비교한 표지, AA v4.3.2 점수 56점 대 53점과 작업당 비용 $7.60 대 $3.26

소넷 5.5 vs GPT-6 Astra: 추론 강도별 성능과 작업당 비용

AA 지수 v5.0에서는 모든 추론 강도에서 GPT-6 Astra가 소넷 5.5보다 점수가 높습니다. 소넷 5.5는 low~high에서만 작업당 비용이 Astra의 29~51%로 더 쌉니다.

2026년 10월 28일17 분

Sonnet 5.5와 Opus 5.5 비교 표지: 단가는 Sonnet이 절반이지만 max effort 작업당 비용은 Sonnet 7.60달러, Opus 5.98달러(AA v4.3.2)이고 캐시 읽기는 두 모델 모두 0.20달러(2026년 10월 7일 인하 이전 가격)

Sonnet 5.5 vs Opus 5.5 차이: 작업당 비용과 선택 기준

Sonnet 5.5는 캐시 읽기까지 Opus 5.5의 반값이지만 AA v5.0 max effort에선 작업당 비용이 같습니다. 명확한 작업은 Sonnet, 판단이 필요한 긴 작업은 Opus입니다.

2026년 10월 28일19 분

Claude Code 공식 연간 결제와 사용량 번들, 공유 계정, API 과금 소유권을 구분한 지도

Claude Code 할인 2026년 10월: 연간 결제·사용량 번들·7일 체험·쿠폰 검증

2026년 10월 27일 기준 Claude Code 비용은 Pro 연간 결제로 연 $40, 사용 크레딧 번들로 최대 30% 줄일 수 있습니다. 7일 게스트패스는 첫 유료 구독자 대상이며, 10월 15일까지였던 아티팩트 행사는 현재 혜택에 포함되지 않습니다.

2026년 10월 27일13 분

코딩과 문서 작업을 위한 Opus 5.5와 복잡한 문제를 검토할 Fable 5.1의 선택을 표현한 그림

Claude Fable 5.1 vs Opus 5.5: 코딩·업무용으로 무엇을 선택할까?

코딩과 문서 작업은 Opus 5.5부터 시작하고, 해결되지 않는 어려운 작업에 Fable 5.1을 비교하세요. Pro·Team Standard에서 Fable은 첫 요청부터 사용 크레딧으로 과금되고, Max·Team Premium에서는 정해진 주간 한도까지 포함됩니다.

2026년 10월 27일8 분

Claude Sonnet 5.5 대 Gemini 3.8 Flash: 출력 단가 $3.75 대 $10, 같은 8문제 실측 비용은 Flash가 2.4배, 답까지 걸린 시간은 8.2배

Claude Sonnet 5.5 vs Gemini 3.8 Flash 비교: 실측 비용은 Flash가 2.4배

Gemini 3.8 Flash는 토큰 단가가 2.67배 싸지만, 2026년 10월 26일 같은 8문제를 high로 돌리자 비용이 Sonnet 5.5의 2.4배였습니다. 긴 문서 요약만 예외입니다.

2026년 10월 26일15 분

Claude 데스크톱 로컬 세션 Git 오류를 Windows 앱 1.49585.0, Worktree, bash.exe 경로 세 가지로 요약한 표지

Claude Code '로컬 세션에는 Git이 필요합니다' 해결: 버전·Worktree부터

Windows 앱 1.49585.0 미만은 Git 재설치 대신 업데이트로 풀립니다. 최신 앱은 Worktree 세션만 Git이 필요하고, 그래도 뜨면 bash.exe 경로와 완전 종료를 봅니다.

2026년 10월 23일10 분

Claude Code 팀의 코드 리뷰 방식: 위험도가 낮은 변경 0명, 중간 1명, 높은 경로 2명의 사람 승인과 모든 PR의 AI 리뷰

Claude Code 팀의 코드 리뷰 방식: 위험도별 승인 0~2명과 우리 팀 도입법

Claude Code 팀은 리뷰 대부분을 자동화하고 사람 승인은 위험도에 따라 0~2명으로 정합니다. 로컬 /code-review는 모든 플랜에서 쓸 수 있지만 CLAUDE.md만 따릅니다.

2026년 10월 23일13 분

Claude in Chrome 확장과 Claude Code를 함께 쓰는 공식 경로, 잘 맞는 일, 안전한 기본값, 사람이 맡을 단계를 네 칸으로 요약한 표지

Claude in Chrome 설치와 사용법: Claude Code 연결, API 키로 안 되는 이유

웹 스토어에서 확장을 설치하고 Claude Code에서 claude --chrome이나 /chrome으로 연결합니다. 유료 플랜과 /login 로그인이 필요하고, API 키로는 켜지지 않습니다.

2026년 10월 22일15 분

Claude Code yoga.wasm 에러 해결 3단계: which -a claude로 실행 중인 복사본 찾기, 2.0.25 이하 npm 복사본 삭제, ~/.local/bin/claude 설치 하나만 남기기

Claude Code Cannot find module yoga.wasm 해결: 2.0.25 이하 복사본 정리

Claude Code의 yoga.wasm 에러는 2.0.25 이하 npm 빌드가 실행될 때만 납니다. which -a claude로 그 복사본을 찾아 지우고 설치를 하나만 남기세요.

2026년 10월 16일10 분

Claude Code 터미널의 빨간 Error compacting conversation 알림 아래 함께 뜬 Error during compaction 줄을 원인으로 짚고, claude update를 먼저 실행하라고 안내하는 표지

Claude Code compact 오류: Error compacting conversation 메시지별 해결

클로드 코드의 Error compacting conversation 알림은 겉포장이고 원인은 함께 뜬 줄에 있습니다. 업데이트 후 원문에 맞춰 되감기, /compact, /clear를 고릅니다.

2026년 10월 16일11 분

Claude Code의 Error writing file 요약 줄에서 Ctrl+O로 원문을 열어 환경 문제, 쓰는 방식 문제, 표시 버그로 나누는 흐름

Claude Code Error writing file 오류 해결: Ctrl+O로 실제 메시지부터 확인

Claude Code의 Error writing file은 요약 표시입니다. Ctrl+O 트랜스크립트 보기의 실제 메시지로 권한, 파일 변경 감지, 출력 잘림, 알려진 버그 중 원인을 가릅니다.

2026년 10월 16일11 분