Diff: Claude Code diff 패널에서 세션의 커밋되지 않은 변경 보기
Claude Code용 /diff 패널: 커밋되지 않은 git 변경을 파일별로 hunk와 함께 보여 주고 Claude의 편집에 맞춰 갱신합니다.
권한
- 파일 읽기컴퓨터의 파일을 읽고 디렉터리 목록을 볼 수 있습니다($.fs.read / list / stat / exists).
- 명령어 실행컴퓨터에서 셸 프로그램을 실행할 수 있습니다($.process.run / spawn). 정확히 어떤 프로그램인지는 소스를 확인하세요.
- 도구 호출 가로채기Claude가 하는 모든 도구 호출을 볼 수 있고(tool.call / tool.check), 이를 차단하거나 변경할 수 있습니다.
- 프롬프트 읽기입력한 내용과 대화 기록을 볼 수 있습니다(prompt.* / session.append / session.messages).
- UI 변경Claude Code 화면에 밴드, 패널, 상태 텍스트, 토스트를 그립니다(ui.render / $.ui.*).
- 명령어/도구 추가사용자나 Claude가 호출할 수 있는 새 슬래시 명령어나 도구를 등록합니다($.command.register / $.tool.register).
- 데이터 저장플러그인 전용 저장소에 세션 간 데이터를 보관합니다($.store.*).
- 테스트 버전
- v2.1.310
- 마지막 테스트
- 필요 버전
- Claude Code ≥ 2.1.287
- 표시 위치
- 패널
Claude Code 안에서 설치:
git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff이 모드는 무엇을 하나요?
Diff는 Anthropic이 claude-code 저장소에서 공개한 모드이며, 여기서는 커뮤니티 모드로 소개합니다. Claude Code diff 패널로서, /diff를 입력하면 세션의 커밋되지 않은 변경이 대화 기록 옆에 열립니다. 변경된 파일마다 한 줄이 있고 그 아래에 각 파일의 hunk가 이어지며, /diff를 다시 입력하면 닫힙니다. 전환할 때마다 대화 기록에 Diff panel shown 또는 Diff panel hidden이 남습니다.
Claude가 파일을 편집하거나 셸 명령을 실행하면 패널이 갱신됩니다. 열려 있는 동안에는 저장소의 HEAD도 확인하므로 다른 곳에서 한 커밋이나 체크아웃도 표시됩니다. 작업 트리는 세션 시작 시점의 HEAD(기본값), HEAD 자체, 또는 기본 브랜치와의 merge-base와 비교할 수 있고, 선택기로 이전 한 턴의 편집을 대신 볼 수도 있습니다. 세션 시작 전에 이미 바뀐 파일과 잠금 파일, 생성 파일, 테스트 파일은 따로 묶여 접힌 상태로 나옵니다.
터미널이 충분히 넓으면 세션의 첫 번째 성공한 편집이 패널을 자동으로 엽니다. 전체 화면 레이아웃이 아니면 /diff는 인라인 대화 상자를 엽니다. 선택한 행 주변 다섯 행의 파일 목록이 나오고, Enter로 그 파일의 hunk만 보고 Escape로 돌아갑니다. 파일의 [ ask ] 버튼은 그 파일을 장전하여, hunk가 다음 프롬프트에 컨텍스트로 한 번 붙습니다.
데모
녹화에서는 커밋되지 않은 변경이 하나 있는 작은 데모 프로젝트에서 모드를 불러온 Claude Code를 시작합니다. /diff를 입력하면 자동 완성에 "Toggle the diff panel showing uncommitted changes"가 표시됩니다. Enter를 누르면 프롬프트 위에 테두리가 있는 대화 상자가 열리고 제목은 Uncommitted changes (git diff HEAD), 그 아래에 1 file changed +2가 나옵니다. src/index.js와 [ ask ] 버튼이 보이고, 그 아래에 줄 번호가 있는 hunk가 표시되며 추가된 두 줄이 초록색으로 강조됩니다. 하단에는 ↑/↓ to scroll · Esc to back이 있습니다. 영상은 몇 초 동안 이 대화 상자에 머뭅니다. 데모 터미널은 도킹 레이아웃이 아니므로 인라인 대화 상자 형태입니다.
설치
설치 블록의 방법 중 아무 것이나 사용하세요. 모두 작성자의 저장소에서 바로 설치됩니다. 다음 세션이 시작된 후, 수정된 파일이 있는 git 저장소에서 /diff를 입력하세요.
$ install diff
Claude Code 2.1.287 이상 필요
작성자의 마켓플레이스에서 설치: anthropics/claude-code
1.설치하지 않고 사용해 보기
git clone https://github.com/anthropics/claude-code claude --plugin-dir ./claude-code/mods/diff한 세션에서만 모드를 불러옵니다. 설정에는 아무것도 추가되지 않습니다.
작동 방식
모듈 hooks/register.ts는 session.start에서 /diff를 등록하고 Pane 컴포넌트를 그리며, Edit, Write, NotebookEdit, Bash, PowerShell의 tool.call을 지켜보며 갱신 시점을 알아냅니다. 모든 git 자식 프로세스에는 고정된 저장소의 git 디렉터리와 작업 트리가 전달되고, 모든 diff는 같은 고정 인수로 시작합니다. hooks/git/argv/diff-leading-args.ts에서:
export const DIFF_LEADING_ARGS = [
'--no-optional-locks',
'-c',
'diff.relative=false',
'-c',
'core.quotePath=false',
'diff',
'--no-ext-diff',
'--no-textconv',
'--ignore-submodules=dirty',
'--submodule=short',
] as constgit은 내장 패널이 실행할 시점에만 실행됩니다. 세션 시작 시에는 실행하지 않고, /diff나 첫 편집이 필요로 할 때 저장소를 찾기 위해 한 번, 그 뒤로는 편집이나 셸 명령 후의 가져오기에서 실행합니다. 출력에는 상한이 있고 500개를 넘는 파일은 합계만 표시됩니다. 세션에 다른 /diff 명령이 이미 등록되어 있으면 이 모드는 물러납니다.
사용자 지정
/config에는 옵션이 없습니다. 비교 기준은 패널에서 고르고 ctrl+x b로 다음 기준으로 넘어가며, 선택은 저장소별로 플러그인 자체 저장소에 보관됩니다. 목록은 ctrl+up/ctrl+down과 opt+up/opt+down으로 스크롤합니다. 첫 편집에서 패널이 열리는 것이 싫다면 한 번 닫으면 기억합니다. CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING을 설정해도 자동 열림이 멈춥니다.
권한 및 안전
매니페스트, hooks/hooks.json, hooks/register.ts를 읽었고, hooks/ 아래 나머지 약 800개 파일에서 네트워크, 프로세스, 파일 쓰기, 환경 변수 접근을 검색했습니다. 3.4 MB 디렉터리를 한 줄씩 다 읽지는 않았으며 대부분 작은 TypeScript 모듈과 테스트입니다. package.json, 설치 스크립트, 바이너리, 난독화되었거나 인코딩된 코드는 없습니다.
- UI 변경: 패널 또는 대화 상자, 그리고 토스트.
- 명령 추가:
/diff. - 프로세스:
$.process.run은 읽기 전용 git 하위 명령(rev-parse,status,diff,ls-files,merge-base,show-ref,symbolic-ref)만 로케일을 C로 고정하여 실행합니다. - 네트워크: 찾지 못했습니다. 파일:
$.fs로 저장소의 파일과 타임스탬프를 읽고, 쓰기는$.store에만 합니다. - 환경 변수:
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING을 읽습니다. - 텔레메트리:
$.telemetry.log와$.telemetry.mark를 호출하지만 Claude Code에 텔레메트리 내장 기능이 없으면 버려집니다. 모드가 직접 무언가를 전송하는 것은 찾지 못했습니다. - 모델에 미치는 영향:
prompt.submit훅은 장전된 파일의 hunk를 프롬프트 컨텍스트에 추가하며, 해당 파일의 ask 버튼을 누른 뒤에만 그렇게 합니다. - 라이선스:
LICENSE.md는 모든 권리 보유(all rights reserved)이며 SPDX ID가 없습니다. 그래서 이 페이지는 링크만 제공하고 미러링하지 않습니다.
claude plugin validate는 오류도 경고도 보고하지 않았지만, README에 설치 줄이 없고 아이콘이 없으며 일곱 개의 훅에 .catch가 없다는 안내를 남겼습니다. 작성자의 테스트는 Claude Code 2.1.310에서 30개 파일의 234개가 모두 통과했고 실패는 0개였습니다.
- 파일 읽기
- 컴퓨터의 파일을 읽고 디렉터리 목록을 볼 수 있습니다($.fs.read / list / stat / exists).
- 명령어 실행
- 컴퓨터에서 셸 프로그램을 실행할 수 있습니다($.process.run / spawn). 정확히 어떤 프로그램인지는 소스를 확인하세요.
- 도구 호출 가로채기
- Claude가 하는 모든 도구 호출을 볼 수 있고(tool.call / tool.check), 이를 차단하거나 변경할 수 있습니다.
- 프롬프트 읽기
- 입력한 내용과 대화 기록을 볼 수 있습니다(prompt.* / session.append / session.messages).
- UI 변경
- Claude Code 화면에 밴드, 패널, 상태 텍스트, 토스트를 그립니다(ui.render / $.ui.*).
- 명령어/도구 추가
- 사용자나 Claude가 호출할 수 있는 새 슬래시 명령어나 도구를 등록합니다($.command.register / $.tool.register).
- 데이터 저장
- 플러그인 전용 저장소에 세션 간 데이터를 보관합니다($.store.*).
호환성 및 문제 해결
macOS의 Claude Code 2.1.310에서 확인했습니다(validate, 테스트, 녹화). /diff가 아무것도 보여 주지 않는다면:
- git 저장소 안에 있어야 합니다. 저장소 밖에서는
/diff가 그렇게 알려 주고 아무것도 하지 않습니다. - 실제로 수정된 파일이 있어야 합니다. 없으면
No changes this session이 보입니다. - 다른
/diff가 등록되어 있지 않아야 합니다. 그 경우 이 모드는 대기합니다. - 자동으로 열리려면 전체 화면 레이아웃에서 터미널 폭이 144열 이상이어야 합니다.
- 전체 화면 레이아웃에서 110열 미만이면 더 넓은 터미널을 요청하는 한 줄이 나옵니다.
자주 묻는 질문
- Diff가 내 코드를 어딘가로 보내나요?
- 네트워크 코드는 찾지 못했습니다. 읽기 전용 git 명령(rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref)을 내 컴퓨터에서 실행하고 결과를 그릴 뿐입니다. 모델에 전달되는 텍스트는 해당 파일의 ask 버튼을 눌렀을 때의 hunk뿐입니다.
- 저장소를 변경하나요?
- 아니요. 확인한 모든 git 명령은 읽기이며 --no-optional-locks, --no-ext-diff, --no-textconv와 함께 실행됩니다. 플러그인이 쓰는 곳은 자체 저장소뿐이고, 패널이 열려 있었는지와 선택한 비교 기준을 기억합니다.
- /diff가 가끔 저절로 열리는 이유는 무엇인가요?
- 세션에서 첫 편집이 성공한 뒤, 파일 체크포인트가 켜져 있고 터미널이 충분히 넓을 때입니다(144열, 이전에 열어 둔 적이 있으면 110열). 직접 닫았다면 건드리지 않습니다. 더 좁은 터미널이나 인라인 레이아웃에서는 /diff로만 열립니다.
- ask 버튼은 무엇을 하나요?
- 파일 하나를 장전합니다. 다음 프롬프트에서 그 파일의 hunk가 컨텍스트로 한 번 추가되고 장전이 해제됩니다. 컨텍스트 공간에 맞지 않으면 hunk는 버려지고 상태 줄에 표시됩니다.
- 재배포하거나 포크할 수 있나요?
- 확인한 내용으로는 안 됩니다. 저장소의 LICENSE.md에는 "All rights reserved"라고 적혀 있고 Anthropic의 상업 서비스 약관을 가리킵니다. 그래서 저장소 링크만 제공하고 코드를 미러링하지 않습니다.
# 관련 모드
추천프롬프트 위 Git 브랜치
Claude Code 프롬프트 위 한 줄 띠에 git 브랜치, 변경된 파일 수, ahead/behind 상태를 표시합니다.
- 프롬프트 위
- 명령어 실행
- 도구 호출 가로채기
- UI 변경
v2.1.310에서 테스트됨
cc-pr-tracker
Claude Code 프롬프트 위에 GitHub PR마다 한 줄씩 표시합니다. 병합 상태, 리뷰, 필수 검사를 보여 주고 바뀌면 알려 줍니다.
- 프롬프트 위
- 토스트
- 파일 읽기
- 명령어 실행
- 도구 호출 가로채기
- 프롬프트 읽기
- UI 변경
- 명령어/도구 추가
- 데이터 저장
v2.1.296에서 테스트됨
추천Blast Radius
Claude Code가 rm -r, 강제 푸시, 마이그레이션을 실행하기 전에 멈추고, 바뀔 파일이나 커밋을 보여 준 뒤 확인을 기다립니다.
- 패널
- 프롬프트 위
- 명령어 실행
- 도구 호출 가로채기
- UI 변경
v2.1.291에서 테스트됨
더 보기: Git 및 GitHub, Claude에 추가하는 도구.