덕삼
블로그

요즘 공부하는 것...들 2탄 — 터미널로 옮겨 온 도구, 함정은 셸과 판 차이에서 났다

· 수정 2026-11-18

편집기 대신 터미널에서 일하면 무엇을 쓰고, 어디서 걸릴까?

답부터 적습니다. 에이전트 하나와 그 에이전트가 부르는 작은 명령 열 남짓이면 됩니다. 걸린 곳은 도구의 결함이 아니라 환경 차이였습니다. 대화형 셸에서만 드는 별칭, zsh 가 패턴으로 읽는 ?, 로컬과 CI 에서 다른 pnpm 판, 원격 셸의 자기 매칭이 그것입니다. 하루 뒤 다시 확인하니 목록은 그대로였고 Claude Code 만 한 판 올랐습니다.

왼쪽 공구판에 rg, fd, jq, gh, glab, pnpm, uv, podman 이 걸려 있고 그 아래에 셸 별칭, zsh 의 물음표, pnpm 판이라고 적힌 주의 표지가 서 있다. 오른쪽에서는 로봇이 터미널 앞에서 명령을 부른다

그림으로 줄이면 이렇습니다. 일은 터미널의 에이전트가 하고, 에이전트는 공구판의 작은 명령을 집어 씁니다. 발에 걸린 것은 공구가 아니라 바닥의 표지판들이었습니다.

1탄은 Windows 와 폐쇄망의 GUI 도구였습니다. 여덟 달 사이 손이 가는 곳이 편집기에서 터미널로 옮겨 와 2탄을 씁니다. 버전은 2026-11-17 에 제 맥(M4 Pro)에서 --version 으로 읽었습니다. 2026-11-18 에 한 번 더 읽었습니다. 셸 설정은 제 dotfiles(agents-scaffold 의 dotfiles/)와 대조했습니다.

매일 쓰는 도구는 열 가지이고, 하루 사이 바뀐 것은 한 판입니다

도구2026-11-172026-11-18용도
Claude Code2.1.3252.1.326터미널에서 도는 AI 코딩 에이전트
Git2.54.0같음버전 관리
gh / glab2.96.0 / 1.99.0같음GitHub, GitLab 을 터미널에서 다룬다
ripgrep (rg) / fd15.2.0 / 10.4.2같음내용 검색 / 파일 이름 찾기
jq1.7.1같음JSON 가공
pnpm / Bun12.21.0 / 1.4.2같음JS 패키지 관리와 실행
uv0.12.5같음파이썬 도구를 설치 없이 실행
Podman6.1.4같음컨테이너
Rust (rustc, cargo)1.100.0같음메모리를 적게 쓰는 서버와 CLI

있으면 편한 도구도 같은 날 확인했습니다. 처음 올린 글의 표에서 비어 있던 eza 와 shellcheck 의 버전을 채웠습니다.

도구2026-11-18용도
eza / bat0.23.4 / 0.26.1ls 와 cat 대신
fzf / zoxide0.74.4 / 0.9.9목록에서 골라 찾기 / 자주 가는 폴더로 이동
ccusage20.0.20Claude Code 토큰 사용량 집계
codegraph1.6.2저장소의 심볼과 호출 관계 색인
age / autossh1.3.2 / 1.4g파일 암호화 / 끊기면 다시 붙는 SSH 터널
shellcheck0.11.0셸 스크립트 검사

Claude Code 는 규칙을 파일에, 막을 것은 훅에 둡니다

1탄에서는 VS Code 의 권장 확장이었습니다. 지금은 터미널에서 CLI 로 씁니다. 저장소에서 바로 읽고, 고치고, 빌드하고, 올립니다. 써 보고 정착한 방식은 셋입니다.

  • 전역 규칙은 ~/.claude/CLAUDE.md 에, 저장소 규칙은 AGENTS.md 에 적습니다. 세션이 바뀌어도 같은 규칙으로 시작합니다.
  • force push 나 reset --hard 는 실행 전 훅이 거부합니다. 문서에 “하지 마라"고 적는 것으로는 부족했습니다. 자세한 내용은 AI 코딩 에이전트가 규칙을 못 어기게 만드는 법에 썼습니다.
  • 끝났다는 보고에는 실행 링크와 응답 코드를 같이 받습니다.

에이전트는 틀린 내용도 맞는 내용과 같은 말투로 말합니다. 그래서 수치, 날짜, 출처는 원문과 대조합니다. 이 글을 옮기면서도 버전 하나(Claude Code)가 하루 만에 낡아 있었습니다.

함정 여섯은 셸과 판, 캐시의 차이에서 났습니다

함정증상대처
셸 별칭스크립트 안의 cat 은 별칭이 아니라 원래 cat 이다터미널에서 원래 명령이 필요하면 command cat
zsh 의 ?따옴표 없는 gh api …commits?per_page=10 이 zsh: no matches found 로 끝난다주소를 따옴표로 감싼다
pnpm 판로컬 pnpm 12 는 ERR_PNPM_IGNORED_BUILDS 로 실패, CI 의 pnpm 9 는 그대로 설치CI 에 판을 적고, 결과가 다르면 판부터 본다
원격 pkill -f원격 셸의 명령줄에도 찾는 글자가 있어 셸이 같이 죽는다"[v]llm serve" 처럼 대괄호로 자기 매칭을 피한다
이미지 캐시ENV X=${ARG} 로 넣은 버전이 바뀌어도 캐시된 층이 쓰인다버전은 파일에 적고 COPY 로 넣는다
ccusage 수치실행 중인 세션이 로그를 계속 써서 두 번 돌린 값이 다르다로그 폴더 사본을 읽힌다

pnpm 은 근거를 다시 찾았습니다. 2026-11-18 의 pnpm 문서는 strictDepBuilds 의 기본값을 true 로 적습니다. 검토하지 않은 빌드 스크립트가 있으면 0 이 아닌 종료 코드로 끝난다는 설명도 있습니다. 블로그 저장소의 배포 설정은 지금도 pnpm/action-setup 에 version: 9 를 적고 있습니다.

이미지 캐시는 이 사이트의 Dockerfile 주석에도 같은 내용이 있습니다. “buildah 는 ENV 줄을 글자 그대로 캐시해 값이 안 바뀐다.”

별칭은 dotfiles 의 zsh/zshrc.macos 에 있는 그대로입니다. 2탄을 쓸 때 옮긴 세 줄과 같습니다. 하나 더 있는 것은 zoxide init zsh --cmd cd 입니다. 그래서 이 맥에서는 cd 가 zoxide 로 바뀌어 있습니다.

alias ls="eza --icons --group-directories-first"
alias ll="eza -l --icons --git --sort=modified"
command -v bat >/dev/null && alias cat="bat --paging=never"

원격 pkill 과 ccusage 사본은 명령으로 보는 편이 빠릅니다.

ssh myserver 'pkill -f "vllm serve"; echo done'      # 원격 셸이 같이 죽는다
ssh myserver 'pkill -f "[v]llm serve"; echo done'    # 대괄호로 자기 매칭을 피한다

cp -R ~/.claude /tmp/claude-snapshot
CLAUDE_CONFIG_DIR=/tmp/claude-snapshot ccusage daily

서버는 Quadlet 과 sops 로 다시 만들 수 있게 둡니다

서버의 컨테이너는 루트 권한 없이 Podman 으로 돌리고, 서비스 등록은 Quadlet 으로 합니다. .container 파일을 두면 systemd 서비스가 됩니다.

# ~/.config/containers/systemd/myapp.container
[Container]
Image=localhost/myapp:local
PublishPort=127.0.0.1:8080:8080
EnvironmentFile=%h/app/.env

[Service]
Restart=always

[Install]
WantedBy=default.target

.env 를 서버에만 두면 서버를 다시 만들 때 값을 잃습니다. 그래서 sops 와 age 로 값만 암호화한 파일을 저장소에 둡니다. 키 이름은 평문으로 남아 무엇이 바뀌었는지 diff 로 보입니다. 개인 키는 저장소에 넣지 않고 따로 백업합니다. 이 키를 잃으면 암호화한 파일을 모두 열 수 없습니다.

sops -e --input-type dotenv --output-type dotenv .env > deploy/secrets/app.env.sops
autossh -M 0 -N -L 5432:127.0.0.1:5432 myserver   # 집 서버 DB 는 터널로만 붙는다

정적 사이트는 다음 날 Hugo 로 옮겼습니다

2탄을 쓴 날 두 정적 사이트의 빌드 시간을 쟀습니다.

쪽 수빌드 시간 (2026-11-17)
Astro 5.16.6 (옛 블로그)80쪽0.95초
Hugo 0.170.0 (테마 예제 사이트)45쪽0.021초

내용과 쪽 수가 달라서 같은 조건의 비교가 아닙니다. 자릿수가 다르다는 정도만 읽으면 됩니다. 이 값은 다시 재지 않았습니다.

그날 저녁 이 사이트가 Hugo 와 작은 Go 서버로 바뀌었습니다. 테마를 따로 떼어 낸 과정은 테마는 별도 저장소에, 사이트에는 글과 설정만에 적었습니다. 옛 블로그는 Pagefind 로 검색을 만듭니다. 이 사이트는 검색을 넣지 않아서 컨테이너 빌드에 Pagefind 단계가 없습니다.

Rust 서버는 Java 보다 메모리 바닥이 30배 넘게 낮았습니다

메모리값이 오르면 Java 는 부자만 쓴다는 농담이 있습니다. 배경은 TrendForce 의 2026-01-05 전망입니다. 2026년 1분기 범용 D램 계약 가격이 전 분기보다 55~60% 오른다는 내용입니다. 전망치이고 계약 가격이라 소매 가격과는 다릅니다.

요청을 받으면 ok 를 돌려주는 HTTP 서버를 두 언어의 표준 라이브러리로 썼습니다. 2026-11-17 에 3회씩 쟀고, 메모리는 ps 의 RSS(프로세스가 실제로 잡은 메모리)입니다.

대기 중요청 2,000회 뒤첫 응답까지
Rust 1.100.0 (rustc -O)1.5MB1.5MB5~10ms
Java 21.0.11 (기본 옵션)51.4~51.8MB126.9~130.1MB77~95ms
Java 21.0.11 (-Xmx64m -XX:+UseSerialGC -Xss256k)49.2~49.3MB80.1~82.6MB87~102ms

대기 중에는 약 34배, 요청을 받은 뒤에는 약 85배 차이가 났습니다. 해석은 이렇습니다. Java 가 그만큼 필요한 것은 아닙니다. 기본 JVM 은 힙 상한을 물리 메모리의 1/4(이 맥에서 12GB)로 잡아 치우지 않고 쌓아 둡니다. 그래도 아무 일도 안 하는 JVM 이 약 50MB 를 잡는 바닥은 남습니다. 512MB 서버라면 위 값으로 JVM 4~6개가 들어가고, Rust 서버는 수십 개가 들어갑니다.

이 비교가 틀리는 조건도 적어 둡니다. 프레임워크를 올리지 않았고, 요청을 하나씩 보내 동시 처리량은 재지 않았습니다. 팀이 이미 Java 로 일한다면 메모리값보다 사람의 시간이 비쌉니다. Rust 와 Go 를 어디에 쓰는지는 Go 와 Rust 를 쓰면 좋은 점에 따로 정리했습니다.

1탄에서 바뀐 것과 지금 남은 것

2026-11-18 의 이 맥과 dotfiles 로 다시 나눴습니다.

구분도구근거
지금도 쓴다위 표의 도구 전부2026-11-18 --version. dotfiles install.sh 가 eza·bat·zoxide·fzf·fd·jq 를 깔고 zshrc.macos 가 별칭을 건다
자리를 내줬다VS Code 확장으로 쓰던 Claude Code확장(2.1.323)은 남아 있지만 일은 CLI(2.1.326)로 한다
자리를 내줬다TortoiseGit 같은 GUI, DBeaver 로 SQLite 조회gh·glab, SSH 터널로 서버 DB 에 붙는다
새로 쓴다starship 1.26.0, zsh 자동 제안·구문 강조 플러그인dotfiles install.sh 1단계가 깐다
새로 쓴다Codex CLI 0.169.0, Antigravity CLI(agy) 1.5.10dotfiles 가 두 도구의 상태 표시줄을 맞춘다. Codex 가이드, agy 가이드
새로 쓴다Go 1.26.2, Hugo 0.170.0이 사이트의 서버와 화면

해석은 이렇습니다. 2탄 표에는 에이전트가 Claude Code 하나뿐입니다. 그런데 dotfiles 는 2026-10-24 부터 Codex 와 agy 의 상태 표시줄도 맞추고 있었습니다. 공구판은 그대로이고, 그것을 집는 손은 글보다 먼저 늘어 있었습니다.

이 판단이 틀리는 경우도 있습니다.

  • Windows 와 폐쇄망에서는 1탄의 GUI 도구가 맞습니다. 이 글은 인터넷이 되는 맥의 목록입니다.
  • 버전 비교는 하루 간격입니다. “바뀐 것이 한 판"이라는 말은 이틀의 사실일 뿐, 도구가 안정됐다는 근거는 아닙니다.
  • 빌드 시간과 메모리는 2026-11-17 하루 측정값입니다.

정리

터미널에서 일하면 에이전트 하나와 작은 명령 열 남짓으로 충분합니다. 시간을 잡아먹은 것은 도구가 아니라 셸, 판, 캐시의 차이였습니다.

다음에 볼 것은 하나입니다. 블로그 배포 설정의 pnpm 9 를 로컬과 같은 판으로 맞춥니다. 그때 로컬의 설치 실패가 CI 에서도 똑같이 나는지 확인합니다.

이 글은 2026-11-17 에 옛 블로그에 올린 글을 2026-11-18 에 다시 확인하고 고쳐 쓴 것입니다.