Claude Code

어떤 작업에 적합한가

기존 저장소를 유지보수하는 개발자, 낯선 프로젝트를 인수한 담당자, 반복적인 테스트·문서 작업을 줄이려는 팀이 주요 대상이다. 관련 파일을 찾아 수정하고 명령을 실행하는 작업 흐름이 중심이다. 요구 사항과 완료 조건을 구체적으로 제시하고, 사람이 변경 내용과 테스트 결과를 검토할 수 있을 때 활용하기 좋다.

지원 OS와 버전 검토

입력 정보의 macOS 전용 표기는 보강이 필요하다. 공식 CLI 문서는 macOS 13 이상, Windows 10 1809 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine Linux 3.19 이상을 안내한다. x64·ARM64 프로세서, RAM 4GB 이상과 인터넷 연결이 필요하다.

제공된 2.1.286은 공식 릴리스에서 확인되지만, 확인 시점의 릴리스 목록은 2.1.295를 Latest로 표시한다. 지원 종료 제품으로 볼 근거는 없으며 업데이트가 계속되고 있다.

설치와 첫 작업 순서

macOS에서는 공식 네이티브 설치 명령인 curl -fsSL https://claude.ai/install.sh | bash 또는 Homebrew의 brew install --cask claude-code를 이용할 수 있다. 설치 후 새 터미널에서 claude --version으로 인식을 확인한다.

프로젝트 폴더로 이동해 claude를 실행하고 브라우저 인증을 마친다. 처음에는 프로젝트 구조와 테스트 실행 방법을 설명해 달라고 요청한 뒤 작은 수정으로 범위를 넓히는 편이 좋다. 작업 전 권한 모드를 확인한다. 모드에 따라 파일 수정이나 명령 실행이 매번 확인을 요구하지 않을 수 있다. 네이티브 설치는 자동 업데이트되지만 Homebrew 설치는 별도로 업그레이드해야 한다.

실무에서 요청하는 방법

예를 들어 회원가입 폼에서 공백만 입력해도 등록되는 문제가 있다면, 먼저 관련 화면과 검증 함수를 찾아 원인을 설명하게 한다. 이어서 ‘공백 입력을 거부하도록 수정하고, 정상 입력과 공백 입력에 대한 테스트를 추가한 뒤 기존 테스트도 실행해 줘’처럼 요청할 수 있다.

완료 후에는 수정 파일, 실행한 테스트, 실패하거나 실행하지 못한 항목을 확인한다. 팀의 라이브러리 선택과 테스트 명령을 CLAUDE.md에 적어 두면 이후 작업에서도 같은 기준을 전달하기 쉽다. 이는 활용 예시이며 직접 사용해 확인한 결과는 아니다.

무료·유료와 사용량 제약

공식 시작 안내는 Pro·Max·Team·Enterprise 구독 또는 선불 API 크레딧을 사용하는 Console 계정을 제시한다. 일반 무료 Claude 계정만으로 지속 이용할 수 있다는 근거는 확인하지 못했다.

홈페이지 표시 가격은 Pro 월 결제 20달러, 연 결제 200달러이며, Max 5x는 월 100달러, Max 20x는 월 200달러다. 세금은 별도다. Pro·Max는 Claude와 Claude Code가 5시간 단위 및 주간 사용 한도를 공유하므로 무제한이 아니다. Console API 사용은 구독과 별도로 과금된다. 한도 도달 시 추가 이용 옵션의 비용을 확인하거나 초기화를 기다린다.

문제가 생겼을 때 확인 순서

claude 명령을 찾지 못하면 새 터미널을 열고 PATH를 확인한다. Windows에서는 PowerShell용 명령과 CMD용 명령을 혼용했는지도 점검한다. 실행 자체가 안 되면 claude doctor, 실행 중에는 /doctor로 설치와 설정 상태를 진단한다.

로그인 오류는 선택한 계정과 인증 방식부터 확인하고, 연결한 MCP 도구의 문제는 /mcp로 상태를 살핀다. 큰 저장소에서 느려지면 작업 범위를 줄이고 /compact로 대화 문맥을 정리하거나 재시작한다. 사용량 제한과 서버 오류는 메시지를 구분해 공식 오류 문서에서 확인한다.

다른 도구와 선택 기준

짧은 코드 질문과 설명이 목적이라면 일반 대화형 AI가 간편하다. 편집기 안에서 변경 사항을 비교하고 싶다면 Claude Code의 VS Code 확장을, 기존 셸·Git·테스트 명령을 중심으로 일한다면 CLI를 고려할 수 있다.

다른 AI 코딩 도구와 비교할 때는 모델 평판보다 실제 저장소에서 필요한 파일을 찾는지, 테스트를 실행하는지, 수정 범위를 통제할 수 있는지와 사용량 비용을 살피는 편이 유용하다. 사내 도입에는 외부 모델 통신 허용 여부와 조직의 인증·권한 정책도 선택 기준이 된다.

공식 안내

• Claude Code by Anthropic | AI Coding Agent, Terminal, IDE · 확인 2026-10-09
• Overview - Claude Code Docs · 확인 2026-10-09
• Advanced setup - Claude Code Docs · 확인 2026-10-09
• Quickstart - Claude Code Docs · 확인 2026-10-09
• Use Claude Code with your Pro or Max plan · 확인 2026-10-09
• Troubleshooting - Claude Code Docs · 확인 2026-10-09
• Releases · anthropics/claude-code · 확인 2026-10-09
• Release v2.1.286 · anthropics/claude-code · 확인 2026-10-09