문서
설치와 연결
Memo는 컴퓨터의 Claude Code와 Codex를 Memo 서버의 그래프에 연결해요. 컴퓨터마다 명령어 하나면 돼요.
시작하기 전에
- macOS, Linux 또는 Windows(WSL). WSL 없는 Windows는 지원하지 않아요.
- 연결할 컴퓨터에 설치된 python3, curl.
- Claude Code, Codex 또는 둘 다. 본인 요금제로 로그인되어 있어야 해요.
- Memo 계정. 없다면 새로 만드세요.
설치
1. 설치 명령어 받기
계정을 열고 컴퓨터 연결을 누르세요. 일회용 코드가 든 명령어 한 줄을 받아요. 코드는 한 번만 쓸 수 있고 15분 후 만료돼요.
2. 붙여 넣고 확인하기
연결할 컴퓨터의 터미널이나, 그 컴퓨터에서 실행 중인 Claude Code 또는 Codex에 이 줄을 붙여 넣으세요. 코드만 다르고 이렇게 생겼어요:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --server https://memo.example --code ABCD-EFGH
그런 다음 확인만 하세요. 터미널은 Continue? [Y/n]라고 한 번 물어요. Claude Code나 Codex는 명령 실행 허락을 구해요. Memo는 다음 Claude Code나 Codex 세션부터 작동해요.
설치 프로그램은 이 컴퓨터를 계정에 연결하고 전용 키를 줘요. 내려받는 모든 파일은 SHA-256 체크섬과 함께 /kit/SHA256SUMS에 나와 있어요.
업데이트
Memo 훅이나 지침이 바뀌면 에이전트가 한 줄로 알려 주고 물어봐요. 허락하면 업데이트를 설치해요. 직접 실행해도 돼요:
~/.memo/bin/memo update
업데이트는 이 컴퓨터의 키를 유지하고 Memo 자체 파일만 바꿔요. 새 버전은 다음 세션부터 작동해요.
예전에 설치해서 memo update가 작동하지 않으면 대신 이 명령을 한 번 실행하세요:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --update세션 연결
평소처럼 Claude Code나 Codex를 시작하고 Memo에 연결해 달라고 하세요. Claude Code에서는 /memo, Codex에서는 $memo를 입력하세요.
세션은 브랜치로 등록되고, 패스포트를 받아 단계를 지도에 기록하기 시작해요. 패널을 열어 진행을 보고 패스포트를 정하세요.
패스포트가 먼저예요. 에이전트는 매 턴마다 패스포트를 읽어요. 허용되지 않은 일은 브랜치가 준비해 두고 수신함에서 물어봐요.
설치 프로그램이 바꾸는 것
| 위치 | 내용 |
|---|---|
~/.memo/config.json | Memo 주소, 소유자 이름, 시간대, 키트 버전. |
~/.memo/token | 이 컴퓨터의 키. 이 파일은 본인 사용자 계정만 읽을 수 있고, 어떤 Memo 도구도 키를 출력하지 않아요. |
~/.memo/bin/memo | 에이전트가 그래프를 읽고 쓸 때 사용하는 memo 명령어. |
~/.memo/memo-hook.py | Claude Code와 Codex가 세션 이벤트마다 실행하는 훅. |
~/.claude/settings.json | Claude Code용 Memo 훅, 그리고 memo 명령어와 Memo MCP 도구를 매번 묻지 않고 실행할 권한. 다른 설정은 그대로예요. |
~/.codex/hooks.json | Codex용 Memo 훅. |
~/.claude/skills/memo/~/.codex/skills/memo/ | memo 스킬: 세션이 자기 브랜치로 일하는 방법. |
~/.claude/CLAUDE.md~/.codex/AGENTS.md | 구분 표시 사이에 들어가는 짧은 Memo 블록. Codex 파일은 Codex가 설치된 경우에만 바꿔요. 파일의 나머지 부분은 그대로예요. |
| Claude Code MCP 서버, 사용자 범위 | 이름이 memo인 서버. claude가 PATH에 있을 때만 추가돼요. |
MCP
claude가 PATH에 있으면 설치 프로그램이 자리 표시자 대신 이 컴퓨터의 키를 넣어 이 명령을 대신 실행해요:
claude mcp add --scope user --transport http memo https://memo.example/mcp --header "Authorization: Bearer <this computer's key>"키는 Claude Code로 바로 전달되고 화면에 표시되지 않아요. Codex는 설치 프로그램이 직접 추가할 설정을 출력해 줘요.
에이전트가 받는 도구:
| 도구 | 하는 일 |
|---|---|
memo_list | 브랜치 목록을 보여 줘요. |
memo_brief | 브랜치 하나의 짧은 요약. |
memo_show | 브랜치 하나 전체 또는 그 노드 하나. |
memo_register | 브랜치를 만들어요. |
memo_apply | 브랜치 노드에 변경 사항을 기록해요. |
memo_pending_answers | 브랜치가 아직 받지 않은 답변. |
memo_log | 브랜치의 변경 이력. |
memo 명령어
에이전트는 ~/.memo/bin/memo로도 그래프에 접근해요. 직접 써도 돼요:
~/.memo/bin/memo list
문제가 생기면 무엇을 해야 할지 한 줄로 알려 줘요:
- 키가 거부될 때(예: 컴퓨터 접근이 해제된 경우): 계정에서 새 코드를 받아 설치 프로그램을 다시 실행하세요.
- 요금제가 비활성 상태일 때: 계정에서 구독하세요. 그동안에도 패널은 계속 작동해요.
컴퓨터 연결 해제
계정에서 해당 컴퓨터 옆의 접근 해제를 누르세요. 그 컴퓨터의 키는 바로 작동을 멈춰요. 그래프와 다른 컴퓨터는 영향을 받지 않아요.
제거
컴퓨터에서 Memo 파일과 설정을 지우려면 설치 프로그램을 다시 내려받아 --uninstall로 실행하세요:
curl -fsSL https://memo.example/kit/install.py -o memo-install.py && python3 memo-install.py --uninstallCLAUDE.md와 AGENTS.md에서 Memo 블록만 지우고, 설치할 때 만든 백업으로 설정을 되돌려요.
그 후에도 Claude Code에 memo MCP 서버가 남아 있으면 삭제하세요:
claude mcp remove --scope user memo
그런 다음 계정에서 이 컴퓨터의 접근을 해제해 키가 더는 작동하지 않게 하세요.