본문으로 건너뛰기

© 2026 Molayo

Zenn헤드라인2026. 06. 02. 22:57

사용법은 외울 필요 없으니 tmux를 설치해라

요약

Claude Code나 Codex 같은 AI 에이전트 사용 시 발생하는 백그라운드 태스크 관리 및 대화형 CLI 실행 문제를 tmux 설치로 해결하는 방법을 제안합니다. tmux 세션을 활용하면 에이전트 간 작업 공유와 프로세스 유지가 용이해집니다.

핵심 포인트

  • tmux를 통해 AI 에이전트의 백그라운드 태스크 안정성 확보
  • 에이전트 간 tmux 세션 공유로 작업 연속성 유지
  • 대화형 CLI 명령어를 AI가 실행할 수 있도록 환경 구축
  • 복잡한 tmux 명령어 대신 AI에게 실행을 요청하는 워크플로우

Claude Code나 Codex를 사용하다 보면 AI에게 명령어를 실행시키는 상황이 늘어납니다. 그 과정에서 두 가지 어려움이 발생합니다.

  • 시간이 걸리는 명령어를 background task (백그라운드 태스크)로 실행했을 때, 에이전트마다 동작이 다르다
  • AI가 대화형(interactive) 명령어를 실행할 수 없다

둘 다 tmux로 해결할 수 있습니다.

tmux라고 하면 "터미널을 분할하여 단축키로 조작하는 전문가용 도구, 나와는 상관없다"라고 생각하는 분들도 많을 것입니다. 하지만, tmux의 조작법을 외울 필요는 없습니다. tmux를 사용하는 것은 AI 에이전트이므로, 설치만 해두면 OK입니다.

Mac이라면, 지금 바로 brew install tmux를 실행하세요. 필요한 것은 그것뿐입니다.

과제 1: background task의 동작을 파악하고 있습니까?

긴 테스트나 dev server (개발 서버)를 background task로 실행했을 때, 다음과 같은 동작을 파악하고 있습니까?

  • Ctrl+C로 멈췄을 때, background task도 멈추는가
  • 세션을 닫았을 때, 프로세스는 남는가
  • 재개했을 때, 해당 태스크를 참조할 수 있는가
  • 로그는 어디에 남는가
  • 다른 에이전트에서 해당 태스크를 볼 수 있는가

Codex에도 동일한 의문이 적용됩니다. 새로운 에이전트가 차례차례 등장하는 가운데, 각각의 동작을 파악하는 것은 매우 힘든 일이죠.

과제 2: AI는 대화형 CLI에 서툴다

Claude Code로부터 이런 말을 들어본 적이 없으신가요?

이 명령어는 대화형 CLI이기 때문에 제가 실행할 수 없습니다.
대신 ! npx create-next-app 을 실행해 주세요.

npx create-next-app이나 npm init과 같은 대화형 명령어는 AI가 직접 실행할 수 없습니다. AI는 Bash 명령어를 비대화형(non-interactive)으로 실행하기 때문에, 도중에 프롬프트가 나타나면 처리가 중단되어 버립니다.

tmux로 해결하기

「과제 1: background task의 동작」 해결

tmux를 설치해 두면 다음과 같이 부탁하는 것만으로 충분합니다.

pnpm test를 tmux로 실행해줘

이렇게 하면, tmux session (세션)을 사용하여 pnpm test를 실행해 줍니다.

tmux의 세션은 부모 프로세스와 독립되어 있으므로, Ctrl+C로 멈춰도 background task는 남으며, 세션을 닫아도 프로세스는 계속 살아있습니다. tmux ls로 목록을 확인할 수 있고, 다른 에이전트에서도 참조할 수 있습니다. 즉, 서두에서 언급한 것과 같은 의문점을 에이전트마다 조사할 필요가 없습니다. tmux 세션의 동작 방식만 파악하고 있다면, Claude Code에서도 Codex에서도 동일하게 다룰 수 있습니다.

아까 그 테스트의 tmux session을 모니터링해줘

이와 같은 지시로 확인할 수 있습니다. Claude Code에서 기동한 tmux session을 Codex에서 참조하는 등, 에이전트 간에 자유롭게 공유할 수 있습니다.

dev server도 tmux로 실행해 두면, 에이전트를 전환한 후에도 상태를 확인할 수 있습니다. "로그도 파일에 남겨줘"라고 부탁하면 저장해 주기 때문에, tmux session을 닫은 후에도 AI에게 로그를 읽게 할 수 있습니다.

인간의 개입이 필요한 상황에서는 직접 session에 들어가 조작할 수 있습니다. tmux attach -t <session명>으로 들어갈 수 있지만, 이런 것조차 외울 필요는 없습니다. 그때마다 AI에게 물어보세요.

아까 그 tmux session에 직접 들어가고 싶으니까 명령어를 알려줘

라고 말하면 됩니다.

「과제 2: AI는 대화형 CLI에 서툴다」 해결

AI에게 대화형 명령어를 부탁했다가 거절당해도, 이렇게 대답하면 실행해 줍니다.

AI: npx create-next-app은 대화형 CLI이기 때문에 제가 실행할 수 없습니다.
당신: tmux 사용해서 해줘

tmux에는 키 입력을 보내는 기능이 있으므로, AI가 대화형 프롬프트에 대해 순차적으로 답변을 입력할 수 있습니다.

대화형 명령어라는 것을 알게 되면, AI가 스스로 tmux로 실행해 주는 경우도 있습니다.

요약

tmux는 AI에게 장시간 명령어 또는 대화형 명령어를 맡기고 싶을 때 유용합니다.

필자는 Codex와 Claude Code를 병용하고 있는데, tmux 덕분에 에이전트 간의 인수인계가 상당히 수월해졌습니다. Claude Code로 실행한 tmux 세션 (session)을 Codex가 모니터링하게 하거나, 도중에 직접 세션에 들어가서 확인할 수 있습니다. 자주 사용하는 패턴은 CLAUDE.md (AGENTS.md)나 Skills에 적어두면 매번 설명할 필요도 없습니다. 아직 사용하고 있지 않은 분들은 우선 설치만이라도 해두면 분명 도움이 될 것입니다.

Discussion

AI 자동 생성 콘텐츠

본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0