/// NOTES · 연재 003

고친 파일을 옆에서 실시간으로 본다

이 글도 그날 쓴 것이 아니다. 2026년 9월 3일에 나온 Claude Code 판에 /diff 패널이 조용히 끼어 들어갔는데, 그날은 그냥 지나갔다가 나중에 공식 문서를 다시 열어 확인해 적는다. "다 고쳤습니다"라는 말을 듣고 나서야 무엇이 바뀌었는지 찾아본 적이 있다면 볼 만하다.

2026-09-03· 분류 : 기능· 직접 해 보기 5분· 나중에 채운 글

무엇이 바뀌었나

확인 GitHub의 공식 릴리스 노트에 따르면 Claude Code v2.1.260(2026-09-03 출시)에 /diff 명령이 대화창 옆에 diff 패널을 여는 기능이 추가됐다. Claude가 파일을 고칠 때마다 패널이 실시간으로 갱신되어, 대화가 끝나기를 기다리지 않고도 바뀌는 내용을 옆에서 계속 지켜볼 수 있다.

확인 공식 문서(Interactive mode)를 보면 /diff는 원래도 있던 명령이다. 바뀐 것은 풀스크린 렌더링(fullscreen rendering)에서의 동작이다 — 전에는 화면을 다 채우는 뷰어가 떴다가 닫아야 했는데, 이제는 패널로 옆에 붙어서 대화를 계속하는 동안에도 켜져 있다.

모드무엇이 뜨나닫는 법
풀스크린 렌더링 diff 패널 — 대화창 옆에 붙어, 파일이 바뀔 때마다 갱신 /diff 다시 치거나 패널 머리의 ✕ 클릭
클래식 렌더러(기본값) diff 뷰어 — 프롬프트 자리를 차지하는 화면. Current와 턴별 보기 다 보면 Esc로 닫아야 다시 대화 가능

확인 패널이 뜨려면 조건이 있다 — 풀스크린 렌더링, git 저장소 안, 터미널 너비 110열 이상, v2.1.260 이상. 이 중 하나라도 안 맞으면 /diff는 예전처럼 클래식 diff 뷰어를 대신 연다. 터미널이 144열 이상으로 넉넉하면, /diff를 한 번 켠 다음부터는 Claude가 파일을 고치기 시작하는 순간 패널이 저절로 뜬다.

왜 중요한가

이 사이트 교육 과정 L2·01 "했습니다"를 믿지 않는 법에서 "확인을 사람이 하면 열 번 중 아홉 번은 건너뛴다"고 적었다. Claude가 "수정 완료했습니다"라고 답한 뒤 실제로 무엇을 건드렸는지 확인하려면 지금까진 직접 git diff를 치거나 파일을 하나씩 열어야 했다.

확인 diff 패널은 그 확인 절차를 대화와 같은 화면에 놓는다. 건너뛰기가 어려워진다는 뜻이다 — 물어보지 않아도 옆에 떠 있으니까. 특히 특정 줄을 마우스로 선택하면 다음 프롬프트에 그대로 붙는다는 점이 쓸 만하다. "이 줄 왜 이렇게 바꿨어?"를 파일 경로와 줄 번호 없이 바로 물을 수 있다.

한 줄로

"했습니다"를 글로 믿는 대신 옆 패널로 본다. 확인이 귀찮은 절차가 아니라 화면에 그냥 떠 있는 것이 되면, 실제로 확인하는 횟수가 늘어난다.

직접 해 보기 — 5분

  1. 버전을 확인한다. 패널은 v2.1.260부터다.
    claude --version
    낮으면 먼저 업데이트한다.
  2. git 저장소 안에서 풀스크린 모드를 켠다. 아무 프로젝트 폴더에서 (git 저장소여야 하고, 터미널은 110열 이상으로 넓혀 둔다)
    /tui fullscreen
    대화가 그대로 유지된 채 화면만 다시 시작된다. /tui default로 언제든 되돌릴 수 있다.
  3. Claude에게 파일을 고쳐 달라고 시키고, 패널을 연다.
    README.md 에 "설치" 섹션을 하나 추가해 줘
    고치는 동안 또는 끝난 뒤
    /diff
    를 치면 대화창 옆에 바뀐 파일 목록과 추가·삭제 줄 수가 뜬다.
  4. 바뀐 줄을 골라 물어본다. 패널에서 마음에 걸리는 줄을 마우스로 드래그해 선택하면 다음 프롬프트에 그 줄이 붙는다. 그대로
    이 부분 왜 이렇게 썼어?
    라고 보내면 그 줄만 짚어서 답한다.
  5. 비교 범위를 바꿔 본다. Ctrl+X B를 누르면 "이번 세션에서 바뀐 것" → "커밋 안 한 것 전부" → "기본 브랜치에서 갈라진 뒤로 전부" 순으로 돈다. 여러 턴에 걸쳐 작업했다면 마지막 것으로 두고 전체를 한 번에 본다.
이 글의 한계

확인 풀스크린 렌더링은 공식 문서에 "연구 프리뷰(research preview)"로 적혀 있다. 흔하지 않은 터미널에서는 화면이 깨질 수 있고, tmux -CC (iTerm2 통합 모드)에서는 아예 쓰지 말라고 문서가 못박고 있다.

확인 패널은 git 저장소가 아니면 뜨지 않는다. 서브모듈 안의 변경은 diff에 따로 나오지 않고, 서브모듈이 가리키는 커밋이 바뀐 것만 한 줄로 표시된다.

이 글은 배포 당일에 쓴 것이 아니다. 릴리스 노트와 공식 문서를 나중에 찾아 확인해 채운 글이라, 그날 실제로 화면을 만진 기록과는 다를 수 있다.

한 줄 정리

  1. Claude Code v2.1.260(2026-09-03)부터 풀스크린 모드에서 /diff가 대화창 옆 패널로 뜬다.
  2. 패널이 뜨려면 git 저장소 · 110열 이상 터미널 · 풀스크린 모드가 필요하다. 안 맞으면 예전 방식의 diff 뷰어로 대신 열린다.
  3. 패널에서 줄을 선택해 그대로 질문할 수 있다 — 파일 경로를 따로 적지 않아도 된다.
이어 읽기 L2 · 01 "했습니다"를 믿지 않는 법 — 확인을 사람이 기억해서 하는 대신, 구조로 붙잡아 두는 장치들. →
SOURCES
  1. Claude Code GitHub Releases — v2.1.260 (2026-09-03 출시 · diff 패널 최초 도입)
  2. Claude Code Docs — Interactive mode · Review changes with /diff (패널·뷰어 차이 · 요구 조건 · 비교 범위 전환)
  3. Claude Code Docs — Fullscreen rendering (연구 프리뷰 · 터미널 호환성 · tmux 주의)