Claude Code에서 Git 명령 실패할 때 Git Bash 경로 설정법

Claude Code 문제 해결

Claude Code에서 코드를 수정하다 보면 git commit이나 git diff 같은 명령을 자동으로 실행하는 경우가 많아요. 그런데 Windows 환경에서는 "git: command not found" 에러가 뜨면서 작업이 멈추는 일이 종종 발생해요.

📌 3줄 요약

1. 원인은 Claude Code가 쓰는 bash 셸이 Git 실행 파일의 위치를 모르기 때문이에요.

2. 시스템 PATH에 Git\cmd, Git\bin, Git\usr\bin 세 경로를 등록해요.

3. 그래도 안 되면 settings.json의 shell 항목을 Git Bash로 지정하고 재시작해요.

목차

· Git 명령이 실패하는 원인 확인하기

· Git 설치 경로와 PATH 환경변수 확인하기

· Claude Code 셸 설정에서 Git Bash 지정하기

· 설정 후 정상 동작 확인하기

Git 명령이 실패하는 원인 확인하기

이 에러의 핵심 원인은 Claude Code가 사용하는 셸(shell)에서 Git 실행 파일의 위치를 모른다는 거예요. Windows는 macOS나 Linux와 달리 Git을 설치해도 자동으로 모든 셸에서 접근 가능하게 되지 않아요.

🔍 왜 셸마다 결과가 다를까요?

운영체제별로 셸 환경이 분리되어 있다 보니, 같은 프로그램이 설치되어 있어도 특정 셸에서는 인식하지 못하는 상황이 생기는 거예요. 이 차이를 이해하면 왜 CMD에서는 되는데 Claude Code에서는 안 되는지 납득이 될 거예요.

특히 Git for Windows를 설치할 때 "Git from the command line and also from 3rd-party software" 옵션을 선택하지 않았다면, PATH 환경변수(환경 변수, environment variable)에 Git 경로가 빠져 있을 가능성이 높아요. 설치 과정에서 이 옵션은 기본값이 아닌 경우도 있어서, 무심코 넘기면 나중에 문제가 되는 거예요. Claude Code는 내부적으로 bash 셸을 사용하기 때문에, CMD에서는 git이 되더라도 Claude Code 안에서는 실패할 수 있어요.

구분	CMD · PowerShell	bash 셸 (Claude Code)
경로 인식 방식	Windows 자체 PATH를 바로 읽음	별도의 환경을 구성해 인식 방식이 다름
git 명령 결과	정상 동작	경로가 빠져 있으면 실패

결국 같은 컴퓨터에서도 어떤 셸을 쓰느냐에 따라 git 명령의 성공 여부가 갈리는 거예요.

 

💬 제 경험

제가 직접 겪었을 때 가장 혼란스러웠던 부분은, 윈도우 터미널에서는 git이 잘 되는데 Claude Code에서만 안 된다는 점이었어요. 셸 환경이 다르다는 걸 알고 나니 금방 해결할 수 있었어요. 혹시 비슷한 증상을 겪고 계시다면, 아래 단계를 하나씩 따라오시면 확실하게 해결할 수 있어요.

Git 설치 경로와 PATH 환경변수 확인하기

1Git 설치 경로 확인

먼저 Git이 실제로 어디에 설치되어 있는지 확인해야 해요. Windows에서 Git for Windows의 기본 설치 경로는 C:\Program Files\Git이에요. 만약 설치할 때 경로를 바꿨다면 본인이 지정한 폴더를 기억해 두셔야 해요. 설치 경로를 모르겠다면 윈도우 검색창에서 "git"을 검색한 뒤 파일 위치 열기를 통해 확인할 수 있어요.

2환경 변수 편집 창 열기

윈도우 검색창에 "환경 변수"를 입력하고 "시스템 환경 변수 편집"을 열어 주세요. "환경 변수" 버튼을 클릭하면 사용자 변수와 시스템 변수 목록이 나타나요. 사용자 변수는 현재 로그인한 계정에만 적용되고, 시스템 변수는 모든 사용자에게 적용된다는 차이가 있어요. Claude Code가 어떤 계정에서 실행되는지에 따라 적절한 변수를 선택해야 하지만, 보통은 시스템 변수에 추가하는 것이 안전해요.

3Path 목록에서 Git 경로 확인

시스템 변수 중 Path를 찾아 더블클릭하면, 현재 등록된 경로 목록을 볼 수 있어요. 여기에 C:\Program Files\Git\cmd가 포함되어 있는지 확인하는 것이 핵심이에요. 목록이 길 수 있으니 스크롤을 끝까지 내려서 꼼꼼히 확인해 주세요.

4누락된 경로 새로 추가

만약 목록에 Git 경로가 없다면 "새로 만들기"를 클릭하고 C:\Program Files\Git\cmd를 추가해요. Git을 기본 경로가 아닌 다른 위치에 설치했다면, 해당 경로의 cmd 폴더를 입력해야 해요. 경로를 입력할 때 오타가 나면 오히려 다른 오류가 생길 수 있으니 탐색기에서 실제 폴더가 존재하는지 먼저 확인해 보세요.

5저장하고 프로그램 재시작

경로를 추가한 뒤에는 반드시 "확인"을 눌러 저장해야 해요.

💡 팁

추가로 C:\Program Files\Git\bin과 C:\Program Files\Git\usr\bin도 함께 등록하면 bash 관련 유틸리티까지 사용할 수 있어서 편리해요.

⚠️ 주의

저장하지 않고 창을 닫으면 변경 사항이 적용되지 않으니 주의하세요. 환경 변수를 수정한 후에는 이미 열려 있던 터미널이나 프로그램에는 바로 반영되지 않아요. 반드시 Claude Code를 포함한 모든 관련 프로그램을 껐다가 다시 켜야 변경된 PATH가 적용돼요.

 

💬 제 경험

제가 직접 설정해 보니, Git\cmd만 추가하면 기본 git 명령은 동작하지만 Claude Code 내부에서 bash 스크립트를 실행할 때 추가 오류가 나는 경우가 있었어요. Git\bin과 Git\usr\bin까지 세 경로를 모두 등록하는 것을 추천해요. 세 경로를 한꺼번에 등록해도 시스템에 부담이 되지 않으니 걱정 없이 추가하셔도 돼요.

Claude Code 셸 설정에서 Git Bash 지정하기

PATH를 수정한 뒤에도 Claude Code가 여전히 git을 찾지 못하는 경우가 있어요. 이때는 Claude Code가 사용하는 셸 자체를 Git Bash로 지정하면 확실하게 해결돼요. 이 방법은 PATH 설정과는 독립적으로 동작하기 때문에, PATH 수정이 잘 안 먹히는 환경에서 특히 효과적이에요.

Claude Code의 설정 파일은 ~/.claude/settings.json에 위치해요. 이 파일을 열어 셸 경로를 Git Bash의 bash.exe로 변경할 수 있어요. 파일이 아직 없다면 해당 경로에 직접 만들어 주시면 돼요.

🔍 알아두기

~는 Windows에서 보통 C:\Users\사용자이름을 의미하니 참고해 주세요.

설정 방법은 다음과 같아요.

{
  "shell": "C:\\Program Files\\Git\\bin\\bash.exe"
}

위와 같이 shell 항목에 Git Bash의 bash.exe 경로를 지정해요.

⚠️ 주의

Windows 경로 구분자는 역슬래시(\\)를 두 번 써야 JSON에서 올바르게 인식돼요. 역슬래시를 하나만 쓰면 JSON 파싱 에러가 발생하거나 경로가 깨질 수 있으니 꼭 두 번씩 써 주세요.

💡 팁

혹시 다른 설정 항목이 이미 있다면 기존 내용을 지우지 말고, 쉼표로 구분해서 shell 항목만 추가하면 돼요.

설정을 저장한 후 Claude Code를 완전히 종료했다가 다시 실행해야 변경 사항이 적용돼요. 단순히 대화를 새로 시작하는 것만으로는 셸 설정이 반영되지 않을 수 있어요. Windows 트레이 아이콘까지 확인해서 프로세스가 완전히 종료되었는지 체크하는 것이 좋아요.

 

이 방법의 장점은 PATH 환경변수를 건드리지 않아도 Claude Code 내부에서 git 명령이 확실히 동작한다는 거예요.

⚠️ 경로 표기 차이 주의

다만 Git Bash 환경과 Windows CMD 환경은 경로 표기 방식이 다르기 때문에, 일부 Windows 전용 도구를 Claude Code 안에서 쓸 때는 주의가 필요해요. 예를 들어 Git Bash에서는 C:\Users를 /c/Users로 표기하는데, 이런 차이가 특정 스크립트 실행에 영향을 줄 수 있어요. 대부분의 경우에는 문제가 없지만, Windows 경로를 하드코딩한 스크립트가 있다면 한번 확인해 보시는 것을 권장해요.

설정 후 정상 동작 확인하기

PATH를 추가하거나 셸을 변경한 뒤에는 반드시 동작 확인을 해야 해요. 설정만 바꾸고 확인을 건너뛰면 나중에 실제 작업 중에 에러를 만나서 더 당황할 수 있어요. Claude Code를 재시작하고, 프로젝트 폴더에서 간단한 git 명령을 실행해 보세요.

1git --version 실행

가장 먼저 git --version을 실행하여 Git이 정상적으로 인식되는지 확인해요. 버전 번호가 출력되면 경로 설정이 성공한 거예요. 보통 git version 2.x.x.windows.x 형태로 출력되는데, 숫자가 나오기만 하면 정상이에요.

2git status로 저장소 상태 확인

이어서 git status로 현재 저장소 상태를 확인해 보세요.

3git log --oneline -5까지 확인

git log --oneline -5까지 정상 출력된다면 Claude Code에서 git 관련 자동 기능이 모두 동작할 준비가 된 거예요. 커밋, 브랜치 전환, 디프(diff) 확인 등 Claude Code가 내부적으로 사용하는 git 명령도 문제없이 실행돼요. 이제부터는 Claude Code가 코드를 수정하고 자동으로 커밋을 만들거나, 변경 사항을 비교하는 기능도 원활하게 쓸 수 있어요.

🔍 "fatal: not a git repository"가 나온다면?

프로젝트 폴더가 Git 저장소가 아닌 경우 "fatal: not a git repository"가 나오는데, 이것은 Git 경로 문제가 아니라 저장소 초기화가 안 된 것이므로 별개의 문제예요. 이 메시지가 나왔다면 오히려 git이 정상 동작하고 있다는 뜻이니 안심하셔도 돼요.

 

💬 제 경험

제가 여러 Windows PC에서 테스트해 본 결과, PATH 추가만으로 해결되는 경우가 약 80% 정도였어요. 나머지 경우는 셸 설정까지 변경해야 했는데, 두 가지를 모두 적용하면 거의 확실하게 해결되므로 처음부터 둘 다 설정해 두는 것도 좋은 방법이에요.

💡 그래도 안 될 때

만약 두 가지를 모두 적용했는데도 안 된다면, Git 자체가 손상된 설치일 수 있으니 Git for Windows를 재설치해 보시는 것을 권장해요. 재설치할 때는 설치 옵션에서 "Git from the command line and also from 3rd-party software"를 반드시 선택해 주세요. 이렇게 하면 앞으로 비슷한 경로 문제가 재발하는 것도 예방할 수 있어요.

✍️ 마치며

"git: command not found"는 Git이 없어서가 아니라, Claude Code가 쓰는 셸이 Git의 위치를 모를 뿐이에요. 그래서 해결책도 결국 두 갈래예요. 시스템 PATH에 Git의 세 경로를 등록하거나, settings.json의 shell 항목을 Git Bash로 직접 지정하는 것이죠.

둘 다 설정하고 Claude Code를 완전히 재시작한 뒤 git --version으로 확인하는 것까지 마치면, 커밋과 diff 같은 자동 기능을 마음 편히 쓸 수 있어요.

#ClaudeCode #클로드코드 #git #GitBash #PATH환경변수 #윈도우개발환경 #commandnotfound #settingsjson #개발환경설정 #클로드코드에러