ai-memory로 클로드 코드와 코덱스가 기억을 같이 쓰게 설치하는 법

ai-memory는 클로드 코드(Claude Code)·코덱스(Codex) 등 여러 코딩 에이전트가 한 기억을 나눠 쓰게 하는 오픈소스 도구다. 훅으로 프롬프트·도구 호출·세션 경계를 조용히 기록하고, 세션이 끝나면 프로젝트별 마크다운 위키 페이지로 정리한다. 클로드 코드를 작업 중간에 끄고 같은 폴더에서 코덱스를 열어도 어디까지 했고 무엇이 실패했는지를 이어받는다. 기본 경로는 LLM을 부르지 않아 API 키가 없어도 된다. 10월 16일 3.1.0이 나왔고 GitHub 트렌딩에 올랐다.

1. 바이너리를 설치하고 설정을 돌린다. 데이터 폴더와 토큰을 만들고, 사용자 서비스(launchd·systemd --user)를 띄우고, 발견한 에이전트마다 MCP·훅·스킬을 연결할지 묻는다.

curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh
ai-memory setup

1. 클로드 코드와 코덱스는 플러그인으로 붙여도 된다(바이너리는 그대로 필요, 3.0 이상). 코덱스는 설치 뒤 /hooks에서 훅을 신뢰할지 묻는다.

claude plugin marketplace add akitaonrails/ai-memory && claude plugin install ai-memory@ai-memory
codex plugin marketplace add akitaonrails/ai-memory && codex plugin add ai-memory@ai-memory

1. 에이전트를 다시 시작하고 "이 프로젝트에 대해 뭘 기억하니"라고 물어 연결됐는지 본다.

2. 클로드 코드에서 하던 작업을 코덱스로 넘기려면 에이전트를 ai-memory run으로 띄운다. 3.1.0부터는 같은 체크아웃에서 앞 에이전트의 세션 기록 요약까지 함께 넘긴다.

ai-memory run claude
ai-memory run codex

1. 3.1.0에 더해진 --global은 모든 프로젝트의 위키를 터미널에서 한 번에 검색한다.

ai-memory search --global "인증 토큰 만료"

맥·리눅스·WSL2를 지원하고 네이티브 윈도는 실험 단계다. 기억은 git으로 관리되는 마크다운 파일이라 grep으로 찾거나 손으로 고칠 수 있다.