Claude Code CLI: 터미널에서 AI 기반 개발 및 코드 리뷰

Claude Code는 Anthropic의 Claude 3.5 Sonnet을 터미널에 직접 가져옵니다. 웹 브라우저도 없고, 복사-붙여넣기도 없습니다. 당신, 코드, 그리고 컨텍스트를 이해하는 AI만 있습니다.

이 도구는 GitHub Copilot과 다르게 작동합니다. Copilot은 타이핑하면서 자동 완성합니다. Claude Code는 터미널에 있는 시니어 개발자와 같습니다 - 질문하고, 리팩토링을 요청하거나, 버그를 수정하라고 말할 수 있습니다. 코드베이스를 읽고, 컨텍스트를 이해하며, 여러 파일에 걸쳐 변경을 수행합니다.

작동 방식

npm이나 pip로 Claude Code를 설치하고, Anthropic API 키로 인증한 다음, 대화를 시작합니다. 파일이나 디렉토리를 가리키고 무언가를 요청하세요.

claude "refactor this component to use React hooks"

Claude는 파일을 읽고, 무엇을 하는지 이해하고, 리팩토링된 버전을 작성하고, diff를 보여줍니다. 승인하거나 거부합니다. 이것이 워크플로우입니다. 간단하지만, Claude가 할 수 있는 것과 할 수 없는 것을 이해하면 강력합니다.

이 도구는 메시지 전체에 걸쳐 컨텍스트를 유지합니다. Claude에게 함수를 작성하라고 한 다음, 그 함수에 대한 테스트를 작성하라고 요청하세요. 방금 한 것을 기억합니다. 컨텍스트 윈도우는 대부분의 파일과 대화를 처리할 만큼 충분히 크지만 무한하지는 않습니다. 긴 대화는 결국 초기 컨텍스트를 잊습니다.

Claude Code가 잘하는 것

Claude는 기존 코드를 이해하는 데 뛰어납니다. 지저분한 레거시 함수를 주고 설명을 요청하세요. 코드가 무엇을 하는지 분석하고, 문제를 식별하며, 개선 사항을 제안합니다. 코드베이스를 상속받았을 때 매우 유용합니다.

claude "explain what this function does and why it's slow"

리팩토링도 강점입니다. Claude는 클래스 컴포넌트를 훅으로 변환하고, 큰 함수를 작은 것으로 분할하거나, 더 나은 패턴을 따르도록 코드를 재구성할 수 있습니다. 단순히 구문을 다시 쓰는 것이 아닙니다. 의도를 이해하고 구조를 개선하면서 동작을 유지합니다.

문서화와 테스트 작성도 훌륭하게 작동합니다. Claude에게 JSDoc 주석 생성, 단위 테스트 작성 또는 통합 테스트 생성을 요청하세요. 테스트가 완벽하지는 않지만 다듬을 수 있는 견고한 시작점입니다.

Claude는 여러 언어를 처리합니다. Python, JavaScript, TypeScript, Go, Rust, PHP. 각 언어의 관용구와 모범 사례를 알고 있습니다. 관용적인 Go를 작성하라고 하면 번역된 Python이 아닌 Go 개발자가 작성한 것처럼 보이는 Go를 얻습니다.

어려움을 겪는 부분

Claude Code는 완벽하지 않습니다. 전체 코드베이스를 한 번에 볼 수 없습니다. 특정 파일이나 디렉토리를 가리켜야 합니다. 문제가 시스템의 연결되지 않은 부분에 걸쳐 있으면 Claude가 중요한 컨텍스트를 놓칠 수 있습니다.

이 도구는 때때로 환각을 합니다. 존재하지 않는 라이브러리를 참조하거나 작동하지 않는 패턴을 제안할 수 있습니다. 항상 작성하는 코드를 검토하세요. AI 생성 코드를 테스트하지 않고 머지하지 마세요.

성능 분석은 제한적입니다. Claude는 N+1 쿼리나 누락된 인덱스와 같은 명백한 문제를 발견할 수 있지만, 실행 중인 애플리케이션을 프로파일링할 수 없습니다. 성능 작업에는 실제 프로파일링 도구를 사용하세요. Claude는 결과를 해석하는 데 도움을 줄 수 있지만 결과 자체를 생성할 수는 없습니다.

대규모 리팩토링은 지저분해집니다. Claude에게 전체 애플리케이션 아키텍처를 재구성하라고 하면 시도하겠지만, 결과는 대개 잘못됩니다. 집중된 변경에 Claude를 사용하세요. 작은 함수. 개별 컴포넌트. 특정 버그. 작업이 작고 집중될수록 결과가 좋습니다.

워크플로우

Claude Code는 반복적인 워크플로우에서 가장 잘 작동합니다. 작은 변경을 하고, 테스트한 다음, 또 다른 변경을 합니다. 전체 앱을 한 번에 리팩토링하려고 하지 마세요. 작업을 조각으로 나누고 하나씩 처리하세요.

명확하고 구체적인 요청으로 대화를 시작하세요. "이것을 더 빠르게 해줘"는 너무 모호합니다. "posts 테이블의 user_id 열에 인덱스를 추가해줘"는 구체적입니다. Claude는 정확한 지시에 더 잘 수행합니다.

모든 변경을 검토하세요. diff를 읽으세요. 무엇이 왜 변경되었는지 이해하세요. Claude는 물어보면 추론을 설명해주며, 이는 패턴을 배우고 프롬프팅을 개선하는 데 도움이 됩니다.

지루한 작업에 Claude를 사용하세요. 상용구 코드. 반복적인 변경. 한 형식을 다른 형식으로 변환. AI가 지루한 작업을 처리하게 하고 아키텍처와 비즈니스 로직에 집중하세요.

비용과 개인정보

Claude Code는 비용이 드는 Anthropic API를 사용합니다. 토큰당 비용을 지불합니다. 큰 파일과의 긴 대화는 비용이 늘어납니다. 비용은 전문적인 사용에는 합리적이지만 취미 개발자를 놀라게 할 수 있습니다. 사용량을 모니터링하거나 예산 한도를 설정하세요.

코드가 처리를 위해 Anthropic 서버로 전송됩니다. 민감한 코드베이스에서 작업한다면 이것이 중요합니다. Anthropic은 API 입력으로 훈련하지 않는다고 말하지만, 데이터는 여전히 머신을 떠납니다. 업무 프로젝트에 Claude Code를 사용하기 전에 회사의 AI 정책을 확인하세요.

Cursor vs Claude Code

Cursor는 VS Code를 기반으로 구축된 전체 IDE에 Claude를 내장합니다. 하나의 도구에서 자동 완성, 채팅 및 인라인 편집을 얻습니다. 더 통합되어 있지만 워크플로우에 대해 더 고집스럽습니다.

Claude Code는 CLI 도구일 뿐입니다. 모든 에디터와 함께 사용하세요. 자동 완성하거나 다음에 무엇을 입력할지 예측하지 않습니다. 무엇을 변경해야 하는지 알 때 사용하는 대화형 도구입니다.

올인원 AI 기반 IDE를 원한다면 Cursor를 선택하세요. 현재 에디터에 만족하고 필요할 때 AI 지원만 원한다면 Claude Code를 선택하세요.

가치가 있을까요?

Claude Code는 특정 작업에서 시간을 절약합니다. 문서화, 테스트, 리팩토링, 레거시 코드 설명. 이러한 작업은 어렵지 않고 단지 지루할 뿐입니다. Claude가 당신보다 빠르게 처리합니다.

이 도구가 당신을 10배 개발자로 만들어주지는 않습니다. 앱을 대신 작성해주지 않습니다. 코드가 어떻게 작동하는지 이해하는 것을 대체하지 않습니다. 하지만 깊은 사고가 필요하지 않은 개발 부분을 가속화합니다.

먼저 사이드 프로젝트에서 Claude Code를 사용해보세요. 무엇을 잘하고 무엇을 못하는지 배우세요. 언제 사용하고 언제 직접 코드를 작성할지에 대한 직감을 키우세요. 몇 주 후에 워크플로우에 맞는지 알게 될 것입니다.

Claude Code는 혁명적이지 않습니다. 특정 작업을 더 빠르게 만드는 유용한 도구일 뿐입니다. 많은 개발자에게 그것으로 충분합니다.