따라 하기 쉬운 터미널·CLI 데모 녹화하는 법

터미널 데모는 개발자가 만들 수 있는 가장 유용한 영상 중 하나입니다. 동시에 가장 보기 힘든 영상이기도 하죠. 깨알 같은 고정폭 글자, 끝없이 흘러가는 출력, 아무도 읽기 전에 화면 위로 사라져 버리는 명령어. 시청자는 2분 만에 포기합니다.

해결책은 거의 전부 준비 단계에 있습니다. 잘 보이는 터미널 녹화는 녹화 버튼을 누르기 전에 만들어지는 것이지, 나중에 수습되는 것이 아닙니다. 전체 과정을 살펴봅시다.

터미널 녹화가 보기 힘든 이유

GUI 화면 녹화에는 버튼, 아이콘, 레이아웃 같은 시각적 기준점이 있습니다. 터미널에는 그런 것이 없습니다. 모든 것이 같은 크기, 같은 색이고, 빠르게 움직입니다. 문제는 늘 똑같습니다:

• 글자가 너무 작음: 눈앞에서 편하게 보이는 폰트도 1080p 영상을 작은 창으로 재생하면 읽을 수 없습니다
• 대비가 낮은 테마: 거의 검은 배경 위의 흐릿한 회색은 모니터에서는 우아하지만 영상 압축 후에는 사라집니다
• 지나가 버리는 출력: 정작 중요한 줄은 여러분이 명령어를 설명하는 사이에 흘러가 버립니다
• 보이지 않는 입력: 시청자는 키 입력을 볼 수 없기 때문에, 빠르게 친 플래그는 마법처럼 보입니다
• 빈 시간: 설치, 빌드, 테스트 실행은 30초 동안 아무 일도 일어나지 않는 구간을 만듭니다

이 모든 문제는 5분 안에 해결할 수 있습니다.

녹화 전에 터미널 설정하기

데모용 터미널을 평소 작업용 터미널과 분리해서 다루세요. 대부분의 터미널 앱은 프로필을 지원합니다. “Recording” 프로필을 하나 만들고 한 번만 설정해 두면 됩니다.

• 폰트 크기 18~24pt: 평소 쓰는 크기의 약 두 배입니다. 모니터에서 우스꽝스럽게 커 보인다면 영상에서는 대체로 적당한 크기입니다
• 고대비 테마: 단색 어두운 배경 위에 밝은 글자. 투명도와 배경 이미지는 아예 쓰지 마세요. 압축에 취약하고 시각적 소음만 늘립니다
• 전체 화면 대신 창 크기 조절: 지나치게 큰 전체 화면 터미널은 프레임 대비 글자를 작게 만듭니다. 90~100열 정도의 창이 16:9 프레임을 알맞게 채웁니다
• 헷갈리는 합자는 끄기: ->나 !=를 화살표 기호로 바꿔 주는 기능은 명령어를 따라 치려는 시청자를 혼란스럽게 할 수 있습니다
• 줄 간격 살짝 넓히기: 약간의 여백만으로도 빽빽한 출력을 훨씬 읽기 쉬워집니다

셸 정리하기

프롬프트와 히스토리에는 생각보다 많은 정보가 담겨 있습니다. 녹화 전에:

• 프롬프트 단순화: git 브랜치, node 버전, 타임스탬프, 두 줄짜리 경로가 들어간 긴 프롬프트는 가로 공간을 잡아먹고 주의를 분산시킵니다. 짧은 ~/project $가 이상적입니다
• 사용자명과 호스트명 숨기기: 공개할 수도 있는 영상에서 여러분과 여러분의 기기를 식별하게 만드는 정보입니다
• 스크롤백과 히스토리 지우기: 이전 명령어에 고객사 이름, 내부 호스트명, 관련 없는 작업이 드러날 수 있습니다
• 환경 변수 확인: 영상 속 env 출력은 어떤 코드 조각보다도 많은 API 키를 유출시켜 왔습니다
• 임시 디렉터리 사용: 깨끗한 프로젝트 폴더는 ls 출력에 엉뚱한 파일이 나오는 것을 막아 줍니다
• 알림 끄기: 터미널 벨과 데스크톱 팝업은 둘 다 테이크를 망칩니다

데모에 실제 자격 증명이 필요하다면 더미 값을 쓰세요. 나중에 가리는 작업은 미리 API_KEY=demo-key-1234로 설정해 두는 것보다 훨씬 번거롭습니다.

명령어 순서 계획하기

녹화 전에 칠 명령어를 기억에 의존하지 말고 메모 파일에 적어 두세요. 순서대로 정확히 무엇을 칠지 적은 짧은 대본은 세 가지 역할을 합니다. 긴장한 상태에서 오타를 내는 것을 막고, 데모를 한 줄기로 유지하며, 그대로 내레이션의 개요가 됩니다.

그런 다음 녹화 없이 처음부터 끝까지 한 번 실행해 보세요. 이미 캐시가 채워져 있었다든가, 설치가 필요한 의존성이 있다든가, 잊고 있던 확인 프롬프트가 나온다든가 하는 돌발 상황이 여기서 드러납니다. 실행 후에는 디렉터리를 원래 상태로 되돌려 녹화 때 같은 상태에서 시작하도록 합니다.

터미널 작업을 위한 녹화 설정

터미널 콘텐츠는 대부분 정적인 텍스트라서 어떤 면에서는 너그럽고, 어떤 면에서는 까다롭습니다.

• 전체 화면이 아닌 창 캡처: 창 캡처는 프레임을 터미널에 맞게 좁히고 바탕화면의 나머지를 가려 줍니다
• 30fps면 충분: 텍스트에는 60fps가 필요 없습니다. 프레임 레이트가 낮으면 같은 비트레이트에서 글자가 더 선명해집니다
• 디스플레이 기본 해상도로 녹화: 나중에 텍스트를 확대하는 순간 흐릿해집니다
• 웹캠 오버레이는 생략하거나 작게: 터미널 데모의 주인공은 출력입니다. 큰 PIP는 화면 아래쪽 모서리를 가리는데, 새 출력이 나타나는 곳이 정확히 거기입니다

대부분이 놓치는 부분: 속도 조절

좋은 터미널 데모의 리듬은 여러분이 실제로 일하는 리듬과 다릅니다.

1. 치기 전에 무엇을 할 것인지 먼저 말하세요: “이제 CLI를 전역으로 설치하겠습니다”
2. 일정하고 또박또박한 속도로 입력하세요. 평소보다 느리게, 하지만 부자연스러울 정도는 아니게
3. 엔터를 누르기 전에 한 박자 멈추세요. 명령어 전체가 보이고 읽힐 시간을 줍니다
4. 출력이 나오는 동안에는 조용히 있다가 그다음에 설명하세요
5. 출력 전체를 읽지 말고 중요한 부분만 짚어 주세요

긴 명령어는 기본 명령어를 먼저 치고 플래그를 덧붙이는 식으로 두 단계로 나눠 보여 주면서 각 플래그의 의미를 설명해 보세요. 40자짜리 줄이 한 번에 나타나는 것보다 훨씬 따라가기 쉽습니다.

오래 걸리는 명령어 다루기

90초짜리 npm install을 지켜보고 싶은 사람은 없습니다. 좋은 선택지가 셋 있습니다:

• 속도 램핑: 명령어는 계속 보여 주되 대기 구간을 4~10배속으로 돌려서, 실행됐다는 사실은 보여 주고 기다리게는 하지 않습니다
• 대기 구간 잘라내기: 명령어가 시작된 순간부터 결과가 나오기 직전까지 잘라냅니다. 프롬프트 줄에서 자르면 편집점이 보이지 않습니다
• 캐시 미리 데우기: 녹화 전에 한 번 실행해 두면 녹화 중에는 자연스럽게 몇 초 만에 끝납니다

어느 쪽을 택하든 실제로 얼마나 걸리는지는 말로 알려 주세요. “보통 2분 정도 걸립니다”라고 해 두면 직접 따라 하는 사람이 당황하지 않습니다.

편집기에서 출력을 읽기 쉽게 만들기

괜찮은 터미널 녹화를 좋은 녹화로 만드는 단계가 편집입니다.

• 중요한 출력 확대: 중요한 세 줄로 줌 인하는 편이 로그로 가득한 화면을 시청자에게 들여다보게 하는 것보다 훨씬 효과적입니다
• 핵심 명령어에 텍스트 오버레이 추가: 명령어를 자막처럼 화면에 띄우면 내레이션을 들으면서 읽을 거리가 생깁니다
• 에러 메시지에 주석 달기: 의도적으로 실패를 보여 줄 때는 원인을 설명하는 줄을 강조하세요
• 챕터 추가: 설치, 설정, 첫 실행, 문제 해결. 터미널 데모는 따라 하면서 보는 영상이라 되감기가 잦습니다
• 무음 구간 제거: 자동 무음 제거는 말투를 건드리지 않고 명령어 사이의 공백만 줄여 줍니다

터미널과 다른 창 섞어 쓰기

실제 데모는 터미널만으로 끝나지 않습니다. 명령어를 실행하고, 브라우저를 확인하고, 설정 파일을 수정하죠.

• 녹화 전에 레이아웃을 정하세요: 터미널과 브라우저를 나란히 두거나, 전체 화면으로 전환하거나. 하나를 골라 끝까지 유지하세요
• 창을 전환할 때는 먼저 멈추세요: 시청자가 변화를 인지할 0.5초를 준 뒤에 말을 이어 가세요
• 폰트 크기를 통일하세요: 큰 터미널 폰트 옆의 작은 에디터 폰트는 읽을 수 없습니다
• 영역 캡처도 고려하세요: 두 창 배치가 고정돼 있다면 그 영역을 캡처하는 편이 영상 전체의 프레이밍을 안정적으로 유지해 줍니다

녹화 전 체크리스트

[ ] 녹화 프로필 적용: 큰 폰트, 고대비 테마, 투명도 없음
[ ] 프롬프트 단순화, 사용자명·호스트명 숨김
[ ] 스크롤백과 히스토리 삭제
[ ] 비밀 값을 더미 값으로 교체
[ ] 명령어 순서 기록 및 1회 리허설
[ ] 작업 디렉터리를 깨끗한 상태로 초기화
[ ] 알림과 터미널 벨 비활성화
[ ] 창 캡처 선택, 30fps, 기본 해상도
[ ] 10초 테스트 녹화로 가독성 확인

마지막 항목이 가장 중요합니다. 10초만 녹화해서 시청자가 실제로 볼 크기로 재생해 보고, 글자가 편하게 읽히는지 확인하세요. 아니라면 폰트를 키우고 다시 확인한 뒤에 12분짜리 녹화를 시작하세요.

흔한 실수

• 4K 디스플레이에서 전체 화면 녹화: 내보낸 영상에서 글자가 현미경 수준으로 작아집니다
• 화면을 계속 지우기: 시청자가 방금 무슨 일이 있었는지 맥락을 잃습니다
• 녹화 중 터미널 크기 변경: 텍스트가 다시 배치되면서 산만해집니다
• 출력을 그대로 읽기: “테스트 12개 모두 통과했습니다”처럼 요약하세요
• 정지 화면에 커서만 깜빡이게 두기: 그런 꼬리는 잘라내세요. 영상이 멈춘 것처럼 느껴집니다
• 시청자가 내 별칭을 안다고 가정하기: gs를 친다면 그것이 git status라고 말해 주세요

결론

터미널 데모의 성패는 가독성에서 갈립니다. 폰트를 크게 하고, 고대비 테마를 고르고, 프롬프트를 정리하고, 순서를 리허설하고, 엔터를 누르기 전에 한 박자 쉬세요. 그다음 편집에서 줌 효과와 속도 램핑으로 시선을 중요한 출력에 붙들어 두세요. 그러면 여러분의 명령줄 설명 영상은 참고 견디는 영상이 아니라, 터미널을 옆에 열어 두고 함께 따라 하는 영상이 됩니다.