Claude Code는 Anthropic이 제공하는 코딩 에이전트 도구다. 공식 개요는 코드베이스를 살펴보고 파일을 편집하거나 명령을 실행하는 개발 작업을 지원한다고 설명한다. Claude 대화 서비스에서 코드 질문에 답을 받는 흐름과 달리, 개발 환경에서 실제 파일과 명령을 다룰 수 있다는 점이 핵심적인 차이다. [1] [2]
어디에서 만나나
도구가 파일을 읽거나 수정할 수 있는 범위는 사용자 설정과 권한에 달려 있다. Claude Code의 권한 안내는 읽기·쓰기·명령 실행 등 행동을 제어하는 규칙과 모드를 설명한다. 설정을 넓게 허용하면 에이전트가 더 많은 작업을 수행할 수 있지만, 사용자는 예상되는 변경과 외부 영향을 살펴야 한다. [1] [2]
일반적인 코드 작업은 저장소 맥락 파악, 수정 대상 결정, 변경, 검사 실행, 결과 설명의 여러 단계를 포함할 수 있다. 이 흐름은 AI 에이전트의 사례이며, 하네스와 도구 사용이 작업 환경을 지원한다. 구체적인 실행 기능과 설치 경로는 바뀔 수 있으므로 공식 문서의 현재 안내를 따른다. [2]
작동과 사용 예
작은 버그 수정 요청을 한다고 가정하면, 재현 단계와 관련 파일을 알려 주고 원인과 변경 내용을 설명하도록 요청할 수 있다. 명령을 실행한 뒤 어떤 검사가 성공했는지 확인하고, 변경된 파일을 검토한다. 실제 운영 자료나 자격 증명이 있는 환경에서는 필요한 파일과 명령만 허용하는 편이 안전하다.
코드 변경을 마친 뒤에는 에이전트의 설명만 읽지 말고 실제 diff와 실행 결과를 살펴야 한다. 자동으로 실행된 명령이 예상한 범위에 속하는지, 테스트가 변경된 코드의 핵심 동작을 확인하는지 점검할 수 있다. 권한 설정은 작업마다 필요한 범위에 맞추고, 추가 권한이 필요할 때는 요청 내용과 영향을 확인한다. [1] [2]
비슷한 개념과 주의점
Claude Code는 Claude 모델을 활용하는 코딩 제품이고 Claude 자체는 모델 계열과 대화 서비스에도 쓰이는 이름이다. Codex 역시 코드 작업을 돕는 에이전트 제품이지만, 제품이 비슷한 작업을 다룬다는 이유만으로 실행 환경이나 성능이 동일하다고 볼 수 없다. 결과물은 개발자가 읽고 검증해야 한다. [1] [2]
출처와 확인
- Overview · 공식 자료 · 확인 2026-10-08
- Configure permissions · 공식 자료 · 확인 2026-10-08