클로드 코드(Claude Code)

들어가기 전에

이미 여러 AI 도구가 존재하는데 클로드 코드가 필요할까?

라는 의문이 들지만 어떤 측면에서 호평을 받는지 궁금하여 사용해보고자 합니다.

 

저는 업무에서 WebStrom, InteliJ, PHPStorm, VSCode, Cursor 등 프로젝트와 언어에 적합한 IDE를 사용하고 있습니다.

여러 AI 도구들을 사용하고 있고 코드 자동 완성 도구로는 Copilot을 기본으로 사용중이었습니다.

 

현 회사에서는 Node.js 환경에서 개발을 시작하였고, 입사 당시 Copilot이 출시되어 사수분과 재밌게 사용해봤던 기억이 납니다.

 

여러 도구를 사용해 보는 것을 즐기는 편입니다. 사내에서 Jetbrain 라이센스를 지원하여 Webstrom으로 갈아탔고 당시 다소 자동완성이 불안정하고 플러그인이 지원되지 않아 코파일럿은 잠시 사용을 멈췄습니다.

 

차후 Jetbrain 사에서도 Tabnine을 출시하여 사용해보았고, 점차 출시되는 서비스들을 하나 둘 씩 이용해보았습니다.

 

현재는 대부분의 서비스들이 상호 호환이 되지만, 여전히 사용범과 UI가 다를 수 밖에 없는 아쉬움이 있었습니다.

• 클로드 코드는 범용적으로 사용이 가능하도록 터미널 기반으로 설계되어 IDE에 독립적입니다.
• 프로젝트를 스캔하고 코드 베이스 질문이 가능합니다.
• 자동 완성 수정이 안정적입니다.

플러그인과 별도의 어플리케이션에 종속되지 않는 것이 여러 도구를 옮겨 다니는 저에게 더욱 편리함을 느껴지도록 다가왔습니다.

 

터미널 기반이라면 명령어를 수행해야 하는 것이 귀찮지 않을까?

 

아래 설치 방법의 내용과 같이 터미널에서 설치하면, 각각의 IDE에서 Claude 모양이 추가되어 터미널에서 'cladue' 명령을 자동으로 실행해주는 버튼이 생성됩니다.

Cursor

WebStrom

요금제

비용을 필요로 하니 글을 읽기 전에 참고 바랍니다.

• 2025년 6월 25일 기준 클로드 코드는 결제 혹은 API 사용량 별로 비용을 청구합니다.
• 해당 포스팅은 구독을 기준으로 내용을 작성합니다.
• 구독 서비스로는 Pro / Max의 결제가 필요합니다.

Claude App (Pro 또는 Max 플랜): Claude의 Pro 또는 Max 플랜에 구독하여 Claude Code와 웹 인터페이스를 모두 포함하는 통합 구독을 이용하세요. 동일한 가격대에서 더 많은 가치를 얻고 한 곳에서 계정을 관리할 수 있습니다. Claude.ai 계정으로 로그인하세요. 런칭 중에 구독 유형과 일치하는 옵션을 선택하세요.

설치 방법

# Claude Code를 설치하려면 NPM을 사용하세요:
npm install -g @anthropic-ai/claude-code

# Claude Code 시작:
claude

 

사용하고자 하는 IDE의 프로젝트 내에서 'cladue' 명령어를 실행하면 계정 인증 혹은 API 사용을 할 것인지 선택을 요구합니다.
해당 포스팅에서는 구독 후 결제를 인증하는 방식을 알아보겠습니다.

결제 후 'Authorize' 버튼을 누르게 되면 토큰이 나오게 되고, 터미널에 붙여넣으면 아래와 같이 해당 경로를 신뢰할 것인지 확인합니다.

 

사용하는 네트워크 망이 분리되어 있는 경우

회사에서는 별도의 네트워크 망을 사용하고 있으며 이에 따라 별도 인증서를 갖고 있습니다.
'claude' 명령어를 최초 실행 시 아래 에러가 발생하였습니다.

Failed to connect to api.anthropic.com: SELF_SIGNED_CERT_IN_CHAIN

 

이는 개발 업무 시 사내 망에서 외부 API를 쓸 때 맞딱뜨린 적 있던 '자체 서명 인증' 에러였습니다.

제 로컬 환경이기 때문에 아래 명령어로 외부 요청에 대해서 허용해도 문제가 없었습니다.

 

하기 명령어를 쉘에서 실행하여 해결하였습니다.

export NODE_TLS_REJECT_UNAUTHORIZED=0

사용 예시

설명을 요구하고, 코드를 수정하고, 신규 기능을 개발하는 것을 통해 테스트를 진행해보겠습니다.

 

새로운 프로젝트를 담당하게 되었습니다.

막막하기 때문에 클로드 코드에 던져보겠습니다.

 

질문을 하면 토큰을 분석하여 답변을 내려줍니다.

주요 구조, 핵심 도메인, 기술 스택, 특징 별로 심플하게 작성해주었습니다.

 

상당히 많은 폴더와 파일들이 존재하기 때문에 위 답변 만으로는 프로젝트의 구조에 대해서 파악하긴 어렵습니다.

조금 더 상세하게 정리해달라고 요구해보았습니다.

 
1~3번 옵션을 선택할 수 있습니다.
1번을 선택하게 되면 작업을 수행하다가 추가 확인 사항이 필요한 경우 다시 현재와 같이 진행할 것인지 물어봅니다.

2번을 선택하면 해당 세션에 대해서는 더 이상 질문하지 않고,

3번은 다른 질문을 할 때 선택하면 됩니다

 

위에서는 1번을 선택하였고, 아래와 같이 마크다운 파일을 생성해주고 생성할 것인지, 물어봅니다.

1,2 번을 선택하면 파일이 생성되고, 에디터 상에서 저장을 해도 파일이 생성되며 클로드의 2번을 선택한 것과 같이 동기화됩니다.

 

실제로 오랜만에 다시 보는 프로젝트이기에 결과물의 퀄리티를 기대하였는데, 기대 이상의 정리와 mermaid 문법으로 DB 까지 시각화 하여 정리해주어 만족스러운 결과물을 받아보았습니다.

 

코파일럿은 현재 커서가 위치한 곳에 수정된 코드를 주입해주지만 클로드코드는 완전히 코드를 정상적으로 수정해주는 것을 확인할 수 있었습니다.

참고 

Claude Code 설정 - Anthropic