<aside> 💡 이 가이드 하나면 끝나는 것 ① 클로드 한도가 걸린 날, 무료 모델로 갈아타 작업을 이어감 ② 요청을 압축해서 같은 한도로 더 오래 사용 ③ 세션이 바뀌어도 지난 작업을 기억

도구는 3개, 순서대로 하나씩 설치하면 30분이면 충분해요.

</aside>

<aside> 📌 먼저 확인하세요 — 이 세팅은 클로드 코드 전용이에요 일반 클로드 앱이나 claude.ai 웹 채팅에는 적용되지 않습니다. 그리고 클로드 코드 중에서도 터미널에서 실행하는 클로드 코드(CLI) 기준이에요 — 데스크톱 앱은 일부 도구(Headroom)가 아직 지원하지 않아요. 클로드 코드가 처음이라면 claude.ai/code 에서 시작할 수 있어요.

</aside>

• OmniRoute — 한도가 차면 요청을 다른 회사 무료 모델로 넘겨주는 도구 (환승 중계소)
• Headroom — 클로드에게 보내는 내용을 미리 압축해 토큰을 아껴주는 도구
• Claude-mem — 세션이 끝나도 작업 내용을 기억하게 해주는 도구

<aside> 🧭 셋 다 깔아야 하는 건 아니에요 — 목적별로 고르세요 · 한도 환승이 목적 → OmniRoute 하나면 됩니다 (요청 압축 기능도 안에 들어 있어요) · 압축만 필요 → Headroom · 이 둘은 둘 다 클로드 앞단의 같은 자리를 차지하는 도구라, 같이 쓰지 말고 하나만 고르는 걸 권장해요 · Claude-mem은 기억 담당이라 어느 쪽과도 같이 써도 됩니다

</aside>

<aside> 🔒 환승 전에 꼭 알아두세요 — 내 요청이 어디로 가는지 무료 모델로 환승된 순간부터, 내가 보낸 글과 코드는 클로드가 아니라 해당 무료 제공사(제3자)의 서버로 전송돼요. 회사 코드나 개인정보 같은 민감한 내용은 환승 모드에서 다루지 마세요. 무료 목록 중 15곳은 약관 주의 표시가 붙어 있어서, 쓸지 말지 직접 골라 켜게 되어 있습니다.

</aside>

시작 전에 터미널부터 열어볼게요

설치는 전부 터미널창에서 합니다. 명령어를 한 줄 붙여넣고 엔터만 치면 돼요. 코딩 지식은 필요 없습니다.

• 맥: ⌘ + 스페이스를 누르고 "터미널" 검색 → 엔터
• 윈도우: 시작 메뉴에서 "PowerShell" 검색 → 실행

<aside> 📖 용어 3개만 알고 가요 · 터미널 — 글자로 컴퓨터에 명령을 내리는 창 · Node.js — 설치 도구(npm·npx)가 들어 있는 프로그램. OmniRoute와 Claude-mem이 사용 · Python(pip) — Headroom이 사용하는 프로그램. pip은 Python의 설치 도구

</aside>

준비물이 깔려 있는지 먼저 확인합니다. 터미널에 한 줄씩 넣어보세요.

node --version
python3 --version

각각 v20 이상 / 3.10 이상 숫자가 나오면 통과예요. 안 나오거나 낮으면 nodejs.org · python.org에서 설치 후 다시 확인하세요.

<aside> 🛟 설치 전 30초 — 만약을 위한 백업 설정 파일을 통째로 바꾸는 도구는 없지만, 일부 항목이 추가되는 경우는 있어요 (예: Headroom이 함께 설치하는 보조 도구 등록). 그래서 혹시 모를 상황에 대비해, 시작 전에 설정 파일 두 개를 복사해 둡니다. 터미널에 두 줄:

</aside>

cp ~/.claude/settings.json ~/.claude/settings.backup.json
cp ~/.claude.json ~/.claude.backup.json

파일이 없다는 메시지가 나와도 괜찮아요 — 아직 그 설정 파일이 없는 것뿐이라, 그 줄은 건너뛰고 진행해도 됩니다.