한도가 끝나도 계속 쓰기 — 여러 AI 를 하나로 묶는 9Router

AI 는 쓰다 보면 한도가 차거나 그날따라 막힙니다. 그때마다 주소와 열쇠를 바꿔 끼우면 일이 끊깁니다. 9Router 는 내 PC 에서 켜 두는 작은 중계 프로그램입니다. 도구들은 9Router 한 곳만 부르고, 9Router 가 내가 정해 둔 순서대로 AI 를 시도합니다. 아래 말을 순서대로 한 줄씩 치고, 3~5단계는 내가 직접 합니다.

먼저 알아 둘 것 — 이 편이 하는 것, 안 하는 것

시작 전에

• Node.js 20 이상이 필요합니다(9Router 공식 안내의 기술 스택 줄). 깔려 있는지는 1단계에서 클로드가 봐 줍니다.
• 빈 폴더 하나에서 클로드를 엽니다. 02편의 노트 폴더에서 해도 됩니다. 로그인·공급자 연결처럼 사람 손이 필요한 곳(3~5단계)은 내가 직접 합니다.
• 클로드가 명령을 실행하려고 허락을 물으면 무슨 명령인지 읽고 허락하세요. 처음에는 묻는 방식(Manual)이 안전합니다(02편 「준비물 자세히」).
• 🤖 칸에 「예시 답」 이라고 적힌 것은 설치·실행이 들어가는 단계라 실제로 돌리지 않고, 공식 문서와 설치본의 화면 문구로 답의 모양을 확인해 쓴 것입니다. 표시가 없는 답은 실제로 돌려 받은 것입니다.

1단계 · 깔려 있는지 먼저 보기

클로드가 Node.js 와 9Router 가 이미 있는지 봅니다. 이 단계에서는 아무것도 설치되지 않습니다.

✅ 이렇게 나오면 성공 — Node.js 가 20 이상으로 나오면 다음 단계로. 「Node.js 가 없다」고 하면 위 「준비물 자세히」에서 먼저 설치하세요. 이미 9Router 가 깔려 있다고 하면 2단계는 켜는 것만 하면 됩니다.

2단계 · 설치하고 내 PC 안에서만 켜기

허락하면 클로드가 설치하고 켭니다. 끝나면 대시보드 주소를 알려 줍니다(공식 안내: http://localhost:20128/dashboard).

✅ 이렇게 나오면 성공 — 내가 브라우저 주소창에 http://localhost:20128/dashboard 를 쳤을 때 로그인 화면이 보이면 됩니다. (안 열리면 「막히면」 1번, 잠깐 열렸다가 꺼지면 7번.)

3단계 · 처음 로그인하고 암호부터 바꾸기 (내가 직접)

이 단계는 클로드에게 말하지 않고 내가 직접 합니다.

1. 로그인 화면에 처음 암호를 넣습니다. 공식 README 에 처음 암호는 123456 이라고 적혀 있습니다.
2. 들어가자마자 왼쪽 메뉴 맨 아래의 Settings(설정)를 열어 암호를 바꿉니다. 제 PC 에 깔린 판에서는 「Current Password」「New Password」 칸이 있는 화면이고, 대시보드도 「처음 암호를 쓰고 있으니 Profile 설정에서 바꾸라」는 경고를 띄웁니다.

✅ 이렇게 나오면 성공 — 새 암호로 다시 로그인할 수 있으면 됩니다. 화면 이름은 판마다 조금 다를 수 있습니다.

4단계 · 공급자 연결하기 (내가 직접)

1. 왼쪽 메뉴의 Providers 를 엽니다.
2. 로그인이 필요 없는 무료 공급자부터 연결해 봅니다. 공식 README 의 빠른 시작은 OpenCode Free(로그인 없음)와 Kiro AI(월 약 50 크레딧 무료, AWS·구글·GitHub 계정 로그인 필요)를 예로 듭니다. 무료 공급자는 자주 바뀝니다(공식 README 에도 「무료 한도는 바뀐다」고 적혀 있습니다).
3. 내 API 열쇠가 있는 유료 서비스(GLM, MiniMax 등)는 Add API Key 로 공급자 이름과 열쇠를 넣습니다. 열쇠는 대화창이 아니라 이 칸에만 넣으세요.

✅ 이렇게 나오면 성공 — Providers 화면에 방금 연결한 공급자가 연결됨으로 보이면 됩니다. 다만 「연결됨」이 실제로 답이 온다는 뜻은 아닙니다. 그건 6단계에서 확인합니다.

5단계 · 열쇠와 순서표(콤보) 만들기 (내가 직접)

1. 열쇠: 왼쪽 메뉴의 Endpoint(설치본에서는 「Endpoint & Key」)를 열면 「API Keys」 칸에 Create Key 버튼이 있습니다. 이름(예: my-key)을 정해 만들고, 보이는 열쇠는 비밀번호 관리자처럼 잠가 두는 곳에만 보관합니다(메모장 파일·대화창에 두지 마세요). 나중에 클로드가 이 열쇠를 써야 할 때는 NINEROUTER_KEY 라는 환경변수에 넣어 둡니다(「막히면」 3번). 이 편의 시험은 열쇠가 없어도 되는 기본 설정이지만(공식 README 의 REQUIRE_API_KEY 기본값은 false), 다른 도구를 붙일 때 필요합니다.
2. 콤보: 왼쪽 메뉴의 Combos(설치본에서는 「Combo & Vision Adapter」)에서 새 콤보를 만들고(공식 README 는 「Create New」, 설치본은 「Create Combo」), 이름을 my-combo 로 정합니다. 그다음 Add Model 로 4단계에서 연결한 공급자의 모델을 먼저 쓰고 싶은 순서대로 넣습니다. 공식 README 의 순서 예시는 구독 → 값싼 유료 → 무료 입니다.

✅ 이렇게 나오면 성공 — Combos 목록에 my-combo 가 보이고, 안에 모델이 한 개 이상 들어 있으면 됩니다. 메뉴 이름은 판마다 다릅니다. 「Endpoint」「Providers」「Combo」가 들어간 메뉴를 찾으세요.

6단계 · 한 줄 보내 보기

이제 클로드가 9Router 에 실제로 한 줄을 보내 봅니다. 「연결됨」 표시가 아니라 진짜 답이 오는지 보는 단계입니다.

✅ 이렇게 나오면 성공 — 모델 목록에 내가 만든 콤보 이름이 보이고, 그 이름으로 보낸 한 줄에 답이 오면 됩니다. 시험은 열쇠 없이 되지만, 「401」이 나오면 「막히면」 3번을 보세요.

7단계 · 연결 정보를 노트로 남기기

나중에 다른 도구를 붙일 때 주소·콤보 이름·켜는 법을 다시 찾지 않게 노트 한 장으로 남깁니다. 열쇠 값은 절대 적지 않게 말합니다.

2~6단계를 같은 대화에서 했다면 클로드가 주소·콤보 이름·켜는 명령을 이미 알고 있어서 이렇게 짧게 칠 수 있습니다. 새 대화에서 하면 그 값들을 말에 넣어 주세요. (시험에서는 앞 단계 대신, 그 값들을 한 번 말해 둔 대화에서 돌렸습니다. 그때 알려 준 켜는 명령에는 --tray 가 빠져 있었으니, 노트에는 2단계의 명령이 그대로 적혔는지 보세요.) 값을 알려 주지 않고 「켜는 법도 적어 줘」라고만 했을 때는 클로드가 명령을 짐작해서 --host 없이 적고 「짐작했으니 확인하세요」 칸을 달았습니다. 클로드가 덧붙인 호출 예시는 추정이니, 맞는지 확인하기 전에는 믿지 마세요.

✅ 이렇게 나오면 성공 — notes/9router.md 가 생기고, 열쇠 값이 아니라 환경변수 이름만 적혀 있으면 됩니다.

다 됐습니다 — 이제 이렇게 말하면 됩니다

• 「9router 가 지금 켜져 있는지 봐 줘.」
• 「my-combo 에 모델을 하나 더 넣고 싶어. 어느 화면에서 하는지 알려 줘.」
• 「9Router 주소랑 콤보 이름이 뭐였지?」 (02편의 노트 폴더에서 했다면 노트에서 찾아 답합니다.)
• 「9router 를 껐다 다시 켜 줘.」

컴퓨터를 껐다 켜면 9Router 도 꺼집니다. 다음에는 「9router 켜 줘」라고 하면 2단계의 켜는 명령만 다시 실행합니다.

막히면

1. 대시보드 주소가 안 열리거나, 켜려는데 listen EACCES 오류가 난다 → 윈도우가 그 번호(20128 근처)를 미리 예약해 둔 경우가 있습니다. 포트가 비어 있어도 「권한 없음」이라고 나와 원인이 안 보입니다(제가 겪은 것, 아래 「내가 만들 때는」). 이렇게 다시 말하세요: "9router 가 listen EACCES 로 안 켜져. 포트를 9130 으로 바꿔서 다시 켜 줘."
2. 콤보를 만들었는데 막혀도 다음 AI 로 안 넘어간다 → 도구가 콤보 이름이 아니라 개별 모델 이름을 부르고 있을 수 있습니다. 개별 모델을 부르면 그 공급자만 시도합니다. 이렇게 다시 말하세요: "도구가 부르는 모델 이름을 my-combo 로 바꿔서 다시 불러 줘."
3. 401 이 난다 → 9Router 가 열쇠를 요구하는 설정입니다. 이렇게 하세요: 클로드를 연 터미널을 닫고, 새 터미널에서 먼저 열쇠를 환경변수에 넣은 뒤(PowerShell: $apikey = "내 열쇠"; $env:NINEROUTER_KEY = $apikey — 이름에 apikey 가 든 변수를 거치면 PowerShell 이 이 줄을 명령 기록 파일에 남기지 않습니다) 같은 터미널에서 claude 를 다시 엽니다. 그다음 "NINEROUTER_KEY 환경변수의 열쇠로 다시 불러 줘. 값은 화면에 찍지 마."
4. Providers 에는 연결됨인데 한 줄을 보내면 오류가 난다 → 상태 표시와 실제 호출은 다릅니다. 이렇게 다시 말하세요: "my-combo 에 한 줄 보내고 오류 내용을 그대로 보여 줘. 열쇠 값은 지우고." (제가 겪은 건, 상태판이 열쇠가 있는지만 보고 「정상」이라고 한 일입니다.)
5. 무료 공급자가 갑자기 안 되거나 모델 목록이 달라졌다 → 무료 공급자의 모델과 한도는 자주 바뀝니다. 공식 README 에도 몇몇 무료 한도가 끝났다고 적혀 있습니다. 콤보 마지막 칸에 다른 공급자를 하나 더 넣어 두세요.
6. 다른 PC 에서 내 9Router 가 보인다 → --host 127.0.0.1 없이 켠 것입니다. 9Router 를 터미널에서 직접 켰을 때 나오는 메뉴의 「Hide to Tray (Background)」나, 트레이 아이콘의 「Enable Auto-start」도 같습니다. 0.5.99 코드를 읽어 보니 둘 다 --host 를 빼고 다시 켜거나, 컴퓨터를 켤 때마다 --host 없이 켜지게 등록합니다. 이 둘은 쓰지 마세요. 이렇게 다시 말하세요: "9router 를 끄고 --host 127.0.0.1 --no-browser --tray 로 다시 켜 줘."
7. 켰다고 했는데 대시보드가 잠깐 열렸다가 안 열린다 → --tray 없이 켠 것입니다. 클로드가 명령을 돌리는 창에서는 메뉴가 「나가기」로 처리돼 꺼집니다(위 「준비물 자세히」). 이렇게 다시 말하세요: "9router 를 --host 127.0.0.1 --no-browser --tray 로 다시 켜 줘."

한 번에 맡기기 (익숙해진 다음에)

역할: 너는 내 PC 에서 일하는 도우미다. 9Router(여러 AI 를 한 주소로 묶는 중계 프로그램)를 내 PC 에 설치해 내 PC 안에서만 열리게 켜고, 내가 대시보드에서 공급자·열쇠·콤보를 만든 뒤 연결을 확인하고 노트로 남기게 도와준다. 나는 초보자이니 어려운 말은 풀어서, 한 단계씩 말해 줘.

맥락: 9Router 는 제3자 오픈소스(github.com/decolua/9router, MIT)다. npm 패키지 이름은 9router 이고 Node.js 20 이상이 필요하다. 켜면 대시보드는 http://localhost:20128/dashboard, OpenAI 꼴 주소는 http://localhost:20128/v1 이다. 콤보는 「AI 순서표」 이름표이고, 이 이름을 모델 이름으로 부르면 앞 AI 가 막힐 때 다음으로 넘어간다. 클로드 코드 자체를 9Router 로 돌리지 않고, Claude 구독 로그인을 9Router 에 넣지 않는다. 지금 열려 있는 이 폴더가 작업 폴더다.

입력: <운영체제>, <쓰는 클로드: Claude Code 터미널 / 데스크톱 앱의 Code 탭>, <목표: 9Router 를 켜고 my-combo 콤보로 한 줄이 가는지 확인>

작업:
① 확인 — 아무것도 설치하기 전에 Node.js 버전(20 이상인지)과 9router 가 전역에 이미 있는지 본다. Node.js 가 없거나 20 미만이면 멈추고 내가 nodejs.org 에서 설치하도록 안내한다.
② 설치와 켜기 — 쓸 명령을 먼저 말하고 내 허락을 받은 뒤 실행한다. 설치는 npm install -g 9router. 켜기는 9router --host 127.0.0.1 --no-browser --tray (다른 PC 가 못 들어오게 내 PC 안에서만 열고, 네 명령 창은 메뉴를 고를 수 없어 --tray 가 없으면 바로 꺼지므로 메뉴 없이 뒤에서 도는 트레이 모드로, 백그라운드로 실행). 켠 뒤 대시보드 주소가 계속 답하는지 한 번 더 확인한다. 옵션 이름이 이 판에서 안 먹으면 9router --help 로 확인해 맞는 이름을 쓴다.
③ 사람이 할 일 안내 후 멈춤 — 아래를 순서대로 안내하고 「다 했어요」라고 할 때까지 기다린다. 대시보드는 내가 직접 조작한다.
 - 브라우저로 http://localhost:20128/dashboard 를 열고, 처음 암호(공식 README: 123456)로 로그인한 뒤 왼쪽 메뉴 맨 아래 Settings 에서 암호를 바꾼다.
 - Providers 에서 로그인 없이 쓰는 무료 공급자를 연결한다. 구독 계정 로그인 연결은 하지 않는다. 내 API 열쇠가 있으면 Add API Key 칸에 직접 넣는다.
 - Endpoint(Endpoint & Key)에서 열쇠를 만들고, Combos 에서 my-combo 콤보를 만들어 연결한 공급자의 모델을 쓰고 싶은 순서로 넣는다.
④ 확인 — 내가 「다 했어요」라고 하면 /v1/models 로 목록을 불러 my-combo 가 있는지 보고, my-combo 로 「안녕」 한 줄을 보내 답이 오는지 본다. 401 이 나오면 열쇠를 환경변수 NINEROUTER_KEY 에서 읽어 다시 부른다(값은 찍지 않는다). 개별 모델 이름이 아니라 콤보 이름으로 부른다.
⑤ 노트 — notes/9router.md 를 만든다: 주소, 콤보 이름, 켜는 명령, 열쇠는 환경변수 이름만. 열쇠 값은 절대 쓰지 않는다. 이미 있으면 덮어쓰지 말고 멈춰서 묻는다.
⑥ 마무리 — 초보자 눈높이로 무엇이 만들어졌고, 앞으로 어떻게 말하면 되는지(「9router 켜 줘」「my-combo 에 모델 하나 더 넣는 법」) 설명한다.

제약: 열쇠·암호·토큰을 출력하거나 파일에 쓰지 않기. 오류를 건너뛰지 않기. 기존 파일을 지우거나 덮어쓰지 않기. 이 폴더 밖의 파일을 읽지도 쓰지도 않기. 9Router 를 인터넷에서 보이게(0.0.0.0·터널) 열지 않기. 무료 공급자에게 회사 자료나 개인정보를 보내지 않기. 내 허락 없이 다른 프로그램을 설치하지 않기.

출력: 한 일, 확인된 상태(Node.js 버전 · 9router 버전 · 켜진 주소), 만든 파일 목록, 확인 결과(모델 목록에 my-combo 가 있는지 · 한 줄에 답이 왔는지), 남은 문제와 다음 조치.

검증: 아래가 실제로 확인돼야 「완료」라고 보고한다. 하나라도 실패하면 완료로 보고하지 말 것.
 (가) 9Router 가 127.0.0.1 로만 열려 있다(다른 PC 에서 보이게 켜지 않았다).
 (나) /v1/models 의 목록에 my-combo 가 있다.
 (다) my-combo 로 보낸 한 줄에 실제 답이 왔다(상태 표시가 아니라 실제 응답).
 (라) notes/9router.md 에 열쇠 값이 없고 환경변수 이름만 있다(글자 검색으로 확인).
 단, 대시보드에서 내가 직접 하는 ③은 네가 확인할 수 없으니 「완료」가 아니라 「남은 일」로 적는다.

내가 만들 때는

처음엔 이렇게 물었습니다. 2026-07-22 13:32, 회사 플랫폼을 만들던 대화에서 이렇게 말했습니다. 「넌 지금 어떻게 연결된거야?? 9router와 연결된거야? 아님 claude 내 계정을 사용하고 있는거야?」 15분 뒤에는 「9router 연결 확인해줘」라고 했습니다. 그 뒤 제 개인 비서(파이스)가 9Router 를 앞문으로 쓰게 됐고, 8월 중순에는 앞문을 기능이 더 많은 다른 중계 프로그램(omniroute)으로 바꾸고 9Router 는 그 밑 공급자 하나로 붙였습니다. 두 개를 다 써 본 8월 20일 저녁에는 이렇게 적었습니다. 「확실이 omni보다 9router가 보기좋고.. 사용하기 좋네.. 단지 공급자가 좀 작을뿐이지..」 그래서 처음 하는 분은 9Router 하나면 충분합니다.

가장 오래 헤맨 일은 「콤보 전환이 안 되는」 것이었습니다. 8월 13일 14시 40분에 이렇게 물었습니다. 「9router 콤보 설정을 어떻게 해야되나.. 분명 너가 다 소진되면.. 내가 claude 계정 두개를 넣었어.. 거기다가 antigravity 다른 키 등등 엄청 넣었는데.. 왜 콤보전환이 안되지..」 클로드가 9Router 의 저장소(DB)를 직접 열어 보고 원인 둘을 찾았습니다. 하나는 제 개인 비서가 콤보 이름이 아니라 개별 모델 이름을 부르고 있었다는 것입니다. 개별 모델을 부르면 그 모델의 공급자(Claude 계정들)만 시도하고 다른 곳으로 안 넘어갑니다. 다른 하나는 Claude 계정 둘이 그날 아침 동시에 429(한도 초과)였다는 것입니다. 이 편 「막히면」 2번이 이것입니다.

8월 18일에는 9Router 와 omniroute 가 동시에 죽었습니다. 오류는 listen EACCES: permission denied 였는데, 그 포트는 아무도 쓰고 있지 않았습니다. 윈도우가 WSL·도커 때문에 20124~20223 번 100개를 예약해 둔 것이었고, 포트 번호를 10000 아래로 옮겨 풀었습니다. 열쇠 일도 있었습니다. 8월 20일 맥으로 옮기던 날 16시 06분에 「지금 보니깐 9router에 api키가 만들어진게 없는데?」라고 물었습니다. 그날 9Router 열쇠 하나가 맥의 설정 파일에 평문으로 들어 있었던 것이 드러나 그 열쇠를 폐기하고, 양쪽 저장소의 열쇠를 0개로 비운 뒤 제가 새로 만들기로 했습니다. 그래서 이 편은 열쇠를 대화창이나 파일에 적지 않고 필요한 칸에만 넣게 합니다. 한 가지 더 있습니다. 클로드 한도가 끝난 뒤에도 이어 쓰려고 저는 처음부터 클로드 계정 두 개까지 9Router 에 넣었습니다(8월 13일 질문에도 그렇게 적었습니다). 이 편을 쓰며 공식 문서를 확인하니 구독 로그인은 클로드 코드와 앤트로픽 자체 앱용이라고 적혀 있어서, 본문에서는 권하지 않습니다.

→ 뒷이야기 6단계에서 자세히 보세요.