본문 바로가기
이지티켓

Atuin Threads, 클로드 코드와 코덱스 세션을 컴퓨터 사이로 옮기는 도구

이지티켓
발행일:
Contents

개발 서버에서 클로드 코드에게 반쯤 맡겨 둔 작업이 있어요. 저녁에 노트북을 열면 그 대화는 노트북에 없습니다. 사흘 뒤엔 그 작업을 어느 컴퓨터에서 했는지도 헷갈리기 시작하고요. Atuin Threads는 오픈소스 셸 기록 도구 Atuin에 2026년 10월 18.24 버전부터 들어간 기능으로, 클로드 코드·코덱스 같은 코딩 에이전트의 대화 기록을 모아 두고 다른 컴퓨터에서 찾아 이어 하게 해 줍니다. 11월 들어 해커뉴스와 긱뉴스에 올라오면서 바이브코딩을 하는 사람들 사이에서 화제가 됐어요.

Atuin Threads가 해 주는 일

Atuin은 원래 터미널에서 친 명령을 SQLite에 저장하고, 원하면 종단 간 암호화로 여러 컴퓨터에 동기화해 주는 Rust 도구예요. 2021년부터 개발돼 왔고 라이선스는 MIT, GitHub 별은 2026년 11월 12일 기준 3만 2천여 개입니다.

Threads는 여기에 에이전트 대화 기록을 얹었습니다. 출시 글을 쓴 Ellie Huxtable은 개발 서버, 노트북, 임시 클라우드 인스턴스, 독일의 베어메탈 서버까지 에이전트 작업이 흩어져 찾기 어려웠다는 이야기로 글을 엽니다. Atuin의 동기화 엔진은 추가만 되는 기록(append-only log)이면 무엇이든 실어 나를 수 있는 구조라, 에이전트 대화도 그 위에 그대로 올렸다는 설명이죠.

Atuin 블로그의 Atuin Threads 출시 글 첫 화면으로, 제목과 클로드 코드에서 시작해 코덱스에서 이어 한다는 소개 문장이 보인다
출시 글은 클로드 코드에서 시작한 일을 다른 컴퓨터의 코덱스에서 이어 하는 장면을 첫 문장에 내세웁니다.

할 수 있는 일은 세 가지로 묶입니다.

  • 여러 컴퓨터의 에이전트 대화를 한 목록에서 찾기
  • 다른 컴퓨터에서 하던 작업을 지금 컴퓨터에서 이어 하기
  • 같은 기록을 가진 사본을 만들어(fork) 다른 에이전트로 이어 가기

공식 글의 예시가 이 기능을 잘 보여 줍니다. 개발 서버의 클로드 코드에서 시작한 일을 노트북의 코덱스에서 끝내는 장면이에요. 지원 에이전트는 출시 글에선 다섯 개였는데, 2026년 11월 12일 기준 공식 문서에는 Claude Code, Codex, Copilot, Grok Build, Hermes Agent, Kiro, opencode, Pi, Amp가 올라 있습니다. 릴리스 노트를 보면 10월 30일에 Copilot CLI가, 11월 4일에 Grok Build·Amp·Kiro CLI가 붙었으니 한 달 사이에 빠르게 늘어난 셈이에요. 커서는 수집 대상이 아닙니다.

언제 쓰면 좋고, 언제는 과한가

잘 맞는 사람은 분명합니다.

컴퓨터 두 대 이상에서 에이전트를 번갈아 돌리는 사람. 집 데스크톱과 노트북, 혹은 원격 개발 서버와 내 맥을 오가는 경우가 이 도구가 노리는 장면 그대로예요.

클로드 코드와 코덱스를 함께 쓰는 사람. 한쪽이 막히면 다른 쪽에 같은 맥락을 넘겨 보고 싶을 때가 있죠. 대화를 복사해 붙이는 대신 --in 옵션 하나로 넘길 수 있습니다.

「그때 그 작업」을 자주 다시 찾는 사람. 지난주에 에이전트가 어떤 파일을 고쳤는지, 어떤 명령을 돌렸는지 검색하고 싶다면 MCP 서버까지 켜 두면 에이전트가 직접 찾아 줍니다.

반대로 컴퓨터 한 대에서 에이전트 하나만 쓴다면 얻는 게 적어요. 동기화가 핵심인 기능이라, 혼자 한 자리에서 일하는 사람에게는 설정할 거리만 늘어나거든요. 긱뉴스 댓글에서도 버릴 대화까지 다 저장하는 게 맞느냐는 의문이 나왔습니다. 에이전트 대화를 금방 쓰고 버리는 습관이라면 굳이 켤 이유가 약해요.

Atuin Threads는 어떻게 쓰나요

준비물은 Atuin 하나입니다. 맥·리눅스·윈도우를 지원하고, 셸은 zsh, bash, fish, Nushell, xonsh, PowerShell에서 돕니다. 공식 설치 명령은 이렇습니다.

curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

맥이라면 brew install atuin, 윈도우는 winget install -e Atuinsh.Atuin도 됩니다. 설치 뒤에 Threads를 켭니다.

atuin threads enable
atuin threads import
atuin resume

첫 줄은 수집을 켜고 백그라운드 데몬을 띄운 뒤, 기존 대화를 가져올지 물어요. 수집은 켠 시점부터라서 예전 기록은 둘째 줄로 가져오고, 특정 에이전트만 원하면 --harness를 붙입니다. MCP 문서에는 같은 동작이 atuin config enable threads로 적혀 있는데, Threads 문서에 따르면 앞의 명령이 이것의 줄임이에요. 끌 때는 atuin config disable threads입니다.

Atuin 문서의 Threads 페이지로, 위쪽에 미출시 버전 문서라는 노란 배너와 atuin threads enable, atuin threads import 명령이 보인다
Threads 문서의 켜기 절. 맨 위 노란 배너는 아직 출시되지 않은 main 기준 문서라는 경고예요.

atuin resume을 치면 대화 고르기 화면이 열립니다. 옵션은 네 가지만 기억하면 돼요.

명령하는 일
atuin resume <id>고르기 화면 없이 그 대화를 바로 이어 하기
--in <agent>다른 에이전트에서 이어 하기(예: 클로드 코드에서 하던 대화를 코덱스로)
--fork같은 기록을 가진 사본을 만들어 갈라 가기
--print실행하지 않고 어떤 명령이 돌지 보여 주기

여기에 MCP 서버를 붙이면 에이전트가 지난 대화를 스스로 뒤질 수 있어요. atuin mcp install 한 줄이 설정 파일이 있는 에이전트를 찾아 등록할지 묻고, atuin mcp install claude-code처럼 하나만 지정해도 됩니다. 등록한 뒤엔 에이전트를 다시 켜야 하고요. 들어가는 도구는 셸 기록 검색과 스레드 검색·목록·읽기 등 여섯 개이고 모두 읽기 전용입니다. 커서, VS Code, Gemini CLI, Claude Desktop은 자동 등록이 안 되니 설정 파일에 손으로 적어야 해요.

Atuin 문서의 MCP Server 페이지로, atuin mcp install 명령과 오른쪽 목차에 손으로 설정하는 에이전트 목록이 보인다
MCP 문서. 명령 한 줄로 등록되는 에이전트와 손으로 설정해야 하는 편집기가 목차에 나뉘어 있어요.

터미널을 직접 만지기 부담스럽다면 클로드 코드에게 설치부터 맡기면 됩니다. 요청은 이 정도면 충분해요.

Atuin을 공식 명령으로 설치하고 Threads를 켠 뒤, 예전 클로드 코드 대화를 가져와 줘.

끝나면 설치된 버전과 바뀐 설정 부분을 보여 달라고 덧붙이고, 동기화 서버 로그인은 직접 하겠다고 적어 두는 편이 안전합니다. MCP까지 연결한 뒤에는 지난 작업을 찾아 달라는 요청이 통하죠.

atuin 스레드 검색으로 지난주 결제 페이지 작업을 찾아, 고친 파일을 정리해 줘.

무엇이 저장되고 무엇이 가려지나

켜기 전에 꼭 읽어 둘 대목이에요. Threads는 대화만이 아니라 도구 호출의 입력과 출력, 그러니까 에이전트가 실행한 명령과 읽고 쓴 파일 내용까지 저장합니다. 파일 수정은 diff도 남아요. 모델의 추론 과정은 있었다는 표시만 남깁니다.

가리는 장치도 있습니다. 알려진 비밀값과 직접 정한 패턴은 ****로 바뀌고, 이미지는 빠지며, 호출 하나의 입출력은 64KiB에서 잘립니다. 비밀값을 모아 두는 환경 변수 파일, SSH 키, AWS 자격 증명 같은 파일을 읽는 호출은 아예 저장하지 않고, gh auth token 같은 명령은 출력을 남기지 않아요. 더 줄이고 싶으면 capture_tools = false로 두어 도구 이름만 남길 수 있습니다.

문제는 이 목록을 벗어난 비밀입니다. 회사 내부 토큰처럼 Atuin이 모르는 형식은 그대로 남을 수 있어요. 해커뉴스에서도 에이전트의 자격 증명이 새어 나갈 수 있다는 우려가 나왔죠. 동기화된 기록 자체는 종단 간 암호화돼 Atuin 쪽에서 읽을 수 없고, 저장 위치는 호스팅 서버·직접 띄운 서버·로컬 전용 가운데 고를 수 있습니다. 회사 코드를 다룬다면 직접 띄운 서버나 로컬 전용으로 시작하는 게 맞아요. 암호화가 있어도 무엇이 기록되는지는 내 설정에 달려 있거든요.

비슷한 도구와 견주면

같은 고민을 다른 방식으로 푼 도구도 있습니다. 다만 아래 비교 도구들은 대부분 작은 개인 프로젝트이고, 이지티켓이 저장소를 깊이 살펴본 것은 아니라 큰 줄기만 적었어요.

Atuin Threadsclaude-code-syncclyncrsync·Syncthing 직접 구성
동기화 방식Atuin 동기화 서버(호스팅·직접 운영·로컬 전용)Git 저장소Git 저장소폴더 복사
다루는 에이전트9종(2026년 11월 12일 문서 기준)클로드 코드만클로드 코드 대화설정한 폴더 무엇이든
암호화종단 간 암호화Git 저장소에 맡김age로 암호화직접 구성
다른 에이전트로 넘기기된다(--in, --fork)안 된다안 된다안 된다
지난 대화 검색고르기 화면과 MCP 도구없음없음없음

차이는 결국 두 가지예요. 에이전트를 갈아타며 넘길 수 있다는 것, 그리고 에이전트가 지난 대화를 검색할 수 있다는 것. 클로드 코드 하나만 쓰고 Git이 익숙하다면 가벼운 도구로도 충분합니다. 해커뉴스 댓글에서 rsync나 Syncthing으로 직접 만든 방식이 언급된 것도 같은 맥락이에요.

써 보기 전에 알아 둘 것

이번엔 설치해 돌려 보지 않고 공식 블로그·문서·저장소 화면만 둘러봤습니다. 그 과정에서 걸린 점이 몇 가지 있어요.

먼저 문서 버전입니다. Threads 문서 위에는 출시되지 않은 main 기준 문서라는 노란 경고가 떠 있어요. 2026년 11월 12일 기준 최신 안정판은 11월 10일에 나온 18.24.6인데, 문서에 적힌 기능이 내가 깐 버전엔 아직 없을 수 있습니다. 안 되는 명령이 있으면 atuin --version부터 보는 게 순서예요.

에이전트마다 사정도 다릅니다. Amp 대화는 이어 하기만 되고, fork하거나 다른 에이전트에서 하던 일을 Amp로 넘기지는 못해요. Hermes는 별도 훅을 깔아야 다른 컴퓨터에서 한 대화를 되살립니다. 서브에이전트의 대화는 고르기 화면에 나오지 않고, 수집·필터 설정을 바꾸면 데몬을 다시 켜야 반영됩니다. 같은 대화를 두 컴퓨터에서 각각 이어 가다 갈라지면 자동으로 합치지 않고 어느 쪽을 쓸지 묻는다는 점도 알아 두면 덜 당황해요.

Atuin Threads 문서의 Amp와 Hermes Agent 절로, atuin hook install hermes 명령이 보인다
에이전트마다 따로 적힌 사정. Amp는 이어 하기만 되고, Hermes는 플러그인을 깔아야 해요.

유지보수는 활발한 편입니다. 18.24.0 이후 한 달 남짓 사이에 패치가 여섯 번 나왔고, 저장소에는 팀 기능 작업이 보여요. 팀 단위 공유는 아직 개발 중이라 이메일로 요청해야 쓸 수 있습니다. 한편 릴리스 노트에는 18.24.2 도커 이미지를 쓰지 말고 18.24.2-1을 쓰라는 경고가 있으니, 서버를 직접 띄울 생각이라면 이 버전은 피하세요.

GitHub의 atuinsh/atuin 저장소 첫 화면으로, MIT 라이선스, 별 32.3k, 최신 릴리스 18.24.6과 팀 기능 관련 최근 커밋이 보인다
저장소 첫 화면. 최신 커밋에 팀 기능 작업이 올라와 있고, 최신 릴리스는 18.24.6이에요.

자주 묻는 질문

무료인가요?

Atuin 자체는 MIT 라이선스 오픈소스라 무료이고, 동기화 서버를 직접 띄우거나 로컬 전용으로 쓰면 돈이 들 곳이 없습니다. 호스팅 동기화 서버의 가격은 2026년 11월 12일 기준 공식 페이지에 나와 있지 않고, 공식 사이트에는 Atuin AI 기능이 테스트 중 무료라는 문장만 있어요.

대화를 저장하면 토큰 비용이 더 나가나요?

해커뉴스에서 Atuin 엔지니어라고 밝힌 사람은 토큰은 쓰지 않고 주로 저장 공간만 든다고 답했습니다. 다만 MCP로 에이전트가 지난 대화를 읽어 오면 그 내용만큼은 에이전트의 입력이 되니, 그 부분은 평소처럼 토큰이 쓰여요.

커서에서도 쓸 수 있나요?

커서에서 한 대화는 수집 대상이 아닙니다. MCP 서버는 커서 설정에 손으로 등록할 수 있어서, 클로드 코드나 코덱스로 쌓은 기록과 셸 기록을 커서 안에서 검색하는 정도는 가능해요. 편집기가 경로를 못 찾으면 which atuin으로 나온 전체 경로를 적으면 됩니다.

컴퓨터 두 대에서 클로드 코드를 쓰고 있다면, 로컬 전용으로 켜서 atuin resume 고르기 화면부터 열어 보는 것으로 시작하면 충분해요.

참고한 자료 8
  1. Atuin Threads: All your agent sessions on every machine (Atuin 블로그)
  2. Threads - Atuin Docs
  3. MCP Server - Atuin Docs
  4. Installation - Atuin Docs
  5. atuinsh/atuin - GitHub
  6. Releases · atuinsh/atuin
  7. Atuin Threads: 모든 머신의 에이전트 세션을 한곳에 - GeekNews
  8. Atuin Threads: All your agent sessions on every machine | Hacker News

이 글은 AI가 자료 조사와 초안 작성을 돕고, 운영자가 직접 써 보고 확인해 고친 뒤 발행했어요. 틀린 내용을 발견하면 알려 주세요.