Claude Code와 채팅 AI의 차이: 내 컴퓨터 폴더에서 읽고 수정하고 검증하는 방식

Claude Code와 채팅 AI의 차이는 프로젝트 파일을 찾고, 고치고, 명령을 실행하고, 결과를 확인하는 흐름이 어디까지 이어지느냐에서 갈립니다. 로컬 도구가 없는 채팅에서는 이 연결을 사람이 맡아요. 코드를 붙여 넣고, 받은 수정안을 파일에 옮기고, 실행 결과를 다시 대화창에 전달하는 식이죠. 반면 Claude Code의 로컬 세션은 도구로 실제 파일을 읽고 바꾸며, 실행 결과를 다음 판단에 바로 활용할 수 있습니다.

그래서 저는 비교 기준을 하나로 잡습니다. 수정 코드를 제안하는 데서 끝나는지, 아니면 프로젝트에 적용하고 검사하는 단계까지 가는지예요. 이 반복 과정은 공식 작동 방식 문서에 설명돼 있습니다. 이 글에서 말하는 채팅 AI는 로컬 작업 도구를 연결하지 않은 대화형 사용 방식이고, Claude Code는 내 컴퓨터 폴더에서 실행하는 로컬 세션을 가리킵니다.

Claude Code는 실행한 작업 폴더를 출발점 삼아 필요한 파일을 찾아 읽어요. 여기서 흔히 오해하는 부분이 있는데, 폴더를 지정했다고 해서 그 안의 모든 파일 내용을 처음부터 알고 있는 건 아닙니다. 그러니 요청할 때 파일 경로나 오류 상황을 적어서 어디를 봐야 할지 좁혀 주는 편이 낫습니다. 다른 폴더가 필요하면 --add-dir 또는 /add-dir로 추가할 수 있고, 추가한 폴더를 편집할 때도 현재 권한 모드가 그대로 적용돼요.

테스트 실패를 고치는 상황을 떠올려 보면 차이가 잘 보입니다. 작업은 ‘오류 확인 → 관련 코드 탐색 → 수정 → 재실행’으로 이어질 수 있어요. 다시 돌렸는데도 실패하면 새로 나온 오류를 근거로 코드를 더 살펴봅니다. 한 번 만든 수정안에 머무르지 않고, 도구가 돌려준 결과를 보고 다음 행동을 정하는 구조죠.

다만 접근할 수 있는 파일과 실제로 읽은 파일은 따로 생각해야 합니다.

결과를 검토할 때 제가 먼저 권하는 건 두 가지예요. 관련 설정을 실제로 읽었는지, 그리고 수정한 부분과 연결된 테스트를 돌렸는지입니다. "테스트가 통과했다"는 설명을 들었다면 어떤 검사를 통과했는지까지 함께 읽어야 변경이 어디까지 검증됐는지 알 수 있어요.

처음 써 본다면 README의 실행 안내를 프로젝트 설정과 대조하는 작업으로 시작해 보세요. 문서에 적힌 명령과 설정을 나란히 놓고 비교하기 쉽고, 수정 범위를 README로 묶어 두면 바뀐 결과도 눈으로 확인하기 편합니다. 요청은 이 순서로 해 보면 됩니다.

1. “README의 실행 안내를 프로젝트 설정과 대조해 주세요. 관련 파일과 수정 계획만 설명해 주세요.”
2. 계획을 확인한 뒤 “설정에서 확인되는 내용에 맞춰 README의 실행 안내를 수정해 주세요. 변경 범위는 README로 한정해 주세요”라고 요청합니다.
3. “변경 내역, 실행한 검사, 검사 결과를 정리해 주세요. 실행하지 못한 검사가 있다면 이유도 알려 주세요”라고 요청하고 결과를 검토합니다.

계획 단계에서는 어떤 설정을 근거로 안내를 바꾸려 하는지부터 확인하세요. 수정이 끝나면 계획과 실제 파일 변경이 맞아떨어지는지, 실행한 검사가 무엇을 확인했는지 살펴봅니다. 이때 헷갈리기 쉬운 점이 하나 있어요. 안내 문구를 설정과 대조한 것과 그 명령을 실제로 실행해 본 것은 검증 범위가 다릅니다.

시작하기 전에 설치된 버전과 /permissions에서 보이는 현재 권한 모드를 먼저 확인해 두세요. 읽기, 편집, 명령 실행은 승인 조건이 각각 다릅니다. Manual 모드라면 작업 폴더 안의 읽기는 일반적으로 승인 없이 이뤄지지만, 파일 수정과 상당수 명령 실행에는 승인을 요청해요. acceptEdits는 편집을 자동 승인하고, auto는 일부 행동을 분류기로 검토합니다. 그러니 어떤 환경에서든 수정 전에 물어볼 거라고 기대하면 곤란해요.

작업 폴더를 지정한다고 운영체제 수준의 격리가 생기지는 않습니다. 권한 설정은 도구 사용을 통제하는 장치이고, 샌드박스는 명령과 하위 프로세스가 파일시스템과 네트워크에 접근하는 범위를 운영체제 수준에서 제한하는 장치예요. 어떤 조건에서 적용되는지는 현재 설정과 함께 공식 권한 문서에서 확인하세요.

로컬에서 작업하더라도 모델과 통신하려면 데이터가 네트워크로 전송됩니다. 파일을 직접 첨부하지 않았다고 해서 파일 관련 정보가 컴퓨터 안에만 머문다고 판단하면 안 돼요. 모델 학습에 쓰이는 조건은 계정 유형과 설정에 따라 달라지니 공식 데이터 사용 안내를 확인해 보세요.

마지막으로 되돌리기입니다. /rewind는 추적된 파일 변경을 되돌릴 수 있지만, 셸 명령만으로 바꾼 파일까지 복구해 주지는 않아요. 그래서 작업 전에 Git 상태로 기존 변경을 파악해 두고, 작업 후에 변경 내역을 검토하는 습관을 권합니다. 두 시점을 비교해야 이번 요청으로 무엇이 달라졌는지 분명하게 짚을 수 있습니다.