AI 코딩 도구

클로드 코드(Claude Code)

Claude Code는 프로젝트의 코드를 읽고 파일 수정과 명령 실행을 도와주는 Anthropic의 AI 코딩 도구입니다.

쉬운 설명

앱을 만들다가 “버튼을 눌러도 저장이 안 돼요”라고 설명하면, Claude Code가 관련 파일을 찾아 읽고 수정하는 작업을 진행할 수 있어요. 허용된 범위에서 명령을 실행해 결과를 확인할 수도 있어요. 터미널뿐 아니라 편집기 확장, 데스크톱 앱, 웹에서도 사용할 수 있어요. 어떤 파일과 실행 환경에 접근하는지는 사용 방식과 설정에 따라 달라요.

이런 상황에서 만나요

스터디 신청 폼이 빈 이메일도 받아들이는 문제를 고치려는 상황이에요. 프로젝트를 연 뒤 재현 방법과 원하는 동작을 함께 알려 주고, 실제 변경과 검증 결과를 확인해요.

수정 요청과 실제로 확인한 결과를 구분해요

설명용 화면
1작업 요청

이메일이 비면 신청을 막아 주세요.

수정 후 빈 입력으로 검사해 주세요.

2파일 변경 예시
수정: src/SignupForm.tsx
추가: 빈 이메일 안내와 제출 차단
3검증 보고 예시

확인: 빈 입력 제출 차단

미확인: 실제 이메일 발송

  1. 1문제 상황과 원하는 결과를 함께 전달해요.
  2. 2답변에 코드를 적었는지, 프로젝트 파일을 바꿨는지 구분해요.
  3. 3작업 보고에서 확인한 범위와 남은 항목을 읽어요.
코딩 도구에 요청하고 결과를 검토하는 상황을 재구성했습니다. Claude Code의 실제 화면이나 실행 기록은 아닙니다.

“이메일 없이 신청하면 안내를 보여 주고 저장하지 않게 해 줘. 수정 파일과 실행한 검사를 알려 줘”처럼 완료 조건을 적어 보세요. 결과를 받으면 변경 내용을 읽고 앱에서 같은 입력을 시험해요. 검사하지 못한 항목이 있다면 완료한 작업과 구분해요.

헷갈리기 쉬운 점

Claude와 Claude Code는 같은 건가요?

Claude라는 이름은 모델과 대화 서비스 문맥에서도 쓰여요. Claude Code는 프로젝트 파일과 개발 도구를 다루는 코딩 도구예요. 파일 수정이나 명령 실행이 가능한지는 연결된 환경과 권한을 확인해야 해요.

명령 실행 요청을 받으면 대상 폴더와 영향을 확인하세요. 수정 전부터 있던 작업이 덮어써지지 않았는지 변경 목록을 읽고, 완료 보고와 실제 기능 동작을 함께 확인해요.

왜 알아야 할까요?

코드 예시를 답변받은 상태와 프로젝트 파일이 실제로 바뀐 상태를 구분할 수 있어요. 어느 폴더를 고쳤고 무엇을 검증했는지 구체적으로 확인하기 쉬워져요.

조금 더 자세히

Claude Code는 코드를 읽고 수정하는 작업과 명령 실행을 연결합니다. 작업 지시와 프로젝트의 맥락을 전달하되, 도구의 실행 환경이 로컬인지 원격인지 확인합니다. 사용하는 화면과 설정에 따라 접근 가능한 자원이 다릅니다.

도구 사용 권한은 설정과 실행 모드에 따라 달라집니다. 지시문에 주의사항을 적는 것과 실제 실행 권한을 제한하는 것은 별개입니다. 필요한 작업에 맞는 권한을 설정하고 변경 내역과 검사 결과를 확인합니다.

직접 사용할 때 확인해 보세요

  • 작업 폴더와 원하는 완료 조건을 확인한다
  • 수정 파일과 명령 실행 결과를 읽는다
  • 재현했던 상황으로 기능을 다시 시험한다

관계 지도

클로드 코드(Claude Code) 중심으로 관련 개념의 정의와 관계를 한눈에 정리했습니다.
클로드 코드(Claude Code)의 정의와 관련 개념 간 관계를 설명한 계층형 그래프