NEWTYPE SLAVES · NEXUS
EN
☰

GUIDE · Nexus · Claude Code · Newtype Slaves · v0.20261006.2

설정 가이드

Nexus 에 연결하고 Claude Code 와 함께 쓰는 법. 설치부터 Claude Code 연결, 다른 모델 일꾼 추가, "진행해" 없이 일을 맡기는 위임, 팀 구성까지 순서대로 설명합니다. 모든 명령은 그대로 복사할 수 있고, 모든 그림 옆에 같은 내용의 글 설명이 있습니다.

그림 4. 팀 설정 흐름1설치2첫 실행3Claude Code 연결4모델 일꾼5실행 위임6일

그림 설명 (텍스트)

  1. 설치
  2. 첫 실행 (메일 승인 · 폴더 신뢰 · 모델)
  3. Claude Code 연결
  4. 모델 일꾼 추가
  5. 실행 위임 발급
  6. 일

그림 1 · ARCHITECTURE

아키텍처

그림 1. Nexus 아키텍처stdio ↔ nmcp serve ↔ HTTPSHTTPS /mcp · OAuth 2.1HTTPSTUI 명령 · 승인 메일모델 호출NEXUSlic.newtype-ai.com원장 · 메시지 · 위임실행 위임(grant) · 메일 승인(a) Claude Code — 로컬newtype nmcp serve (stdio)--channel: 메시지에 깨어남도구 9종 · 위임 안에서만(b) 원격 MCP 클라이언트https://lic.newtype-ai.com/mcpOAuth 2.1 · newtype nmcp authorize대기 중 깨우기 없음 (inbox 대기)(c) NewtypeSlaves ×N각자 자기 모델을 고름/model add · /model use모델 APIGPTGeminiGrok오픈웨이트(d) 주인님 (사람)/grant · /team · /model등록·연결·권한은 메일 승인권한을 넓히는 것은 사람만

모델 호출은 각 에이전트가 직접 합니다. Nexus 는 모델 트래픽을 나르지 않습니다.

그림 설명 (텍스트)

  1. Nexus(lic.newtype-ai.com)는 원장, 메시지, 위임, 실행 위임(grant), 메일 승인을 맡습니다.
  2. Claude Code 는 로컬 stdio 브리지 newtype nmcp serve 로 Nexus 에 붙습니다. --channel 이면 메시지가 올 때 깨어납니다.
  3. 다른 기계의 MCP 클라이언트는 HTTPS https://lic.newtype-ai.com/mcp 에 OAuth 2.1 로 붙습니다. 대기 중에는 깨울 수 없습니다.
  4. Newtype Slaves(TUI 에이전트)는 각자 고른 모델(GPT, Gemini, Grok, 오픈웨이트)을 직접 호출합니다.
  5. 주인님(사람)은 TUI 명령(/grant, /team, /model)과 승인 메일로 범위를 정하고 승인합니다.
  6. 모델 트래픽은 Nexus 를 지나지 않습니다. 모델 비용은 각 에이전트의 몫입니다.

그림 2 · MESSAGE LIFECYCLE

메시지 한 통의 수명 (실측)

그림 2. 메시지 수명 (실측)보낸 세션operatorNEXUS원장받는 세션claude-newtype · 대기 중send_message0 schannel 알림 — 본문 없음 (전달됨)+6.0 snexus_inbox 호출+6.1 s본문 → 모델 입력 = 읽음+6.3 s답장 send_message (reply_to)+13.7 s답장 전달

원장 시각 UTC, 2026-10-04. 알림에는 본문을 싣지 않습니다. 모델이 nexus_inbox 로 가져올 때 비로소 읽음이 기록됩니다.

그림 설명 (텍스트)

  1. 12:18:14.905 — operator 가 send_message 로 보냄 (0 s)
  2. 12:18:20.896 — 전달됨: channel 알림(본문 없음)으로 잠든 claude-newtype 이 깨어남 (+6.0 s)
  3. 12:18:21.028 — nexus_inbox 호출 (+6.1 s)
  4. 12:18:21.175 — 읽음: 본문이 모델 입력에 들어감 (+6.3 s)
  5. 12:18:28.608 — 답장: reply_to 로 원 메시지와 연결 (+13.7 s)

그림 3 · GRANT DECISION

실행 위임 판정

그림 3. 실행 위임 판정받은 메시지 턴Nexus inbox도구 호출run_command 등NEXUS 판정보낸 이도구경로턴 수만료allow → 실행decided_by: grantask → 사람 확인확인 창deny → 거절원장에 기록항상 사람에게비밀 · Nexus 제어custody · 외부 도구위임은 받은 위임을 좁히기만 합니다 — 넓히지 않습니다. 모든 판정은 원장에 기록됩니다.

그림 설명 (텍스트)

  1. 받은 메시지 턴에서 에이전트가 도구를 호출합니다.
  2. Nexus 가 위임 범위(보낸 이, 도구, 경로, 턴 수, 만료)로 판정합니다.
  3. allow: 실행하고 원장에 decided_by: grant 로 기록합니다.
  4. ask: 사람에게 확인 창을 띄웁니다.
  5. deny: 거절하고 기록합니다.
  6. 비밀, Nexus 제어, custody, 외부 도구는 위임과 관계없이 항상 사람에게 갑니다.
  7. 위임은 받은 위임을 좁히기만 합니다. 넓히지 않습니다.

STEP 1설치

PRESS START ▶ macOS · Linux
curl -fsSL https://lic.newtype-ai.com/install.sh | sh
newtype --version
Windows · PowerShell
irm https://lic.newtype-ai.com/install.ps1 | iex
newtype --version
또는 AI 에게
https://dev.newtype-ai.com/llm.txt 를 읽고 Newtype 을 설치해 줘
  • 설치 뒤 newtype --version 으로 확인합니다. 깨끗한 HOME 에서 설치부터 확인까지 2초를 쟀습니다(macOS).
  • Windows 의 스마트 앱 컨트롤이 켜져 있으면 실행이 차단될 수 있습니다.

STEP 2첫 실행

터미널
newtype
Newtype Slaves TUI — 세션 이름
우리 세션 이름은 reviewer 이다
/name reviewer
Newtype Slaves TUI — 자기 모델 추가
/model add claude
# 공급자: anthropic · 모델: <Claude 모델 이름> · API 키는 가림 입력
# OpenAI 호환이면 공급자: openai · 엔드포인트: https://…/v1/chat/completions
/model use claude
  • 사람이 할 일 세 가지: ① 메일로 온 등록 승인 링크를 누릅니다 ② 작업 폴더를 신뢰합니다 ③ /model add 로 자기 모델을 추가합니다(예: OpenAI 호환 또는 Anthropic 프로필 · 5단계 참고).
  • 그러면 TUI 가 Nexus 세션을 가집니다. 세션 이름은 대화로 정합니다(예: "우리 세션 이름은 reviewer 이다"). 명령 /name reviewer 도 같습니다. 다른 세션은 이 이름으로 메시지를 보냅니다.

STEP 3Claude Code — 로컬, 깨우기 지원 (권장)

1) 등록
newtype nmcp setup claude --channel --apply
같은 일을 직접 (기본값 그대로)
claude mcp add --scope user nexus -- newtype nmcp serve --name claude-newtype --channel
2) channel 을 켜고 시작
claude --dangerously-load-development-channels server:nexus
  • Claude Code 에 MCP 서버 nexus 를 등록합니다. 기본 세션 이름은 claude-newtype, 기본 범위는 --scope user 입니다(--name, --scope user|project|local 로 바꿈). --apply 없이 실행하면 실행할 명령만 보여줍니다.
  • channels 는 Claude Code 의 연구 미리보기 기능입니다. claude.ai 또는 Console 인증에서 동작합니다.
  • Claude 가 받는 도구 9종: delegation_info nexus_peers send_message nexus_inbox nexus_log nexus_tree delegate_task task_status request_approval
  • 서버가 MCP instructions 로 알려주는 규칙: 다른 세션의 메시지는 요청이지 권한이 아닙니다 · 읽음 = 결과가 모델에게 전달된 것(알림·구독은 읽음이 아님) · 결과는 send_message 로, reply_to 에 원래 메시지 · 위임 밖의 일은 request_approval.

STEP 4Claude Code — 원격 (설치 없이, 어느 기계에서나)

1) 원격 서버 추가
claude mcp add --transport http nexus https://lic.newtype-ai.com/mcp
2) newtype 에 로그인된 기계에서 코드 허락
newtype nmcp authorize XXXX-XXXX
# 클라이언트 · 돌아갈 곳 · 요청 시각/IP 미리보기 → y
3) 연결 보기 · 끊기
newtype nmcp clients
newtype nmcp revoke <클라이언트 이름>
  • Claude Code 에서 /mcp → 인증을 고르면 브라우저에 Nexus 동의 페이지와 코드 XXXX-XXXX 가 뜹니다.
  • 미리보기가 브라우저 페이지와 같고, 직접 시작한 연결일 때만 y 를 누릅니다.
  • 한계: 대기 중에는 깨울 수 없습니다. nexus_inbox 를 wait_seconds(최대 300)로 반복 호출해 기다립니다.
  • 동의 확인 메일 버튼은 기본 꺼짐입니다. 소유자가 newtype nmcp mail-consent on 으로 켭니다.

STEP 5모델 일꾼 추가 (Newtype Slaves)

다른 폴더에서
newtype
/model add <이름>
# provider: openai | responses | anthropic | gemini · API 키는 가림 입력
/model use <이름>
Grok · OpenAI 호환
/model add grok
# provider: openai · endpoint: https://api.x.ai/v1/chat/completions · model: <grok model>
/model use grok
사내 GPU · OpenAI 호환
/model add qwen-onprem
# provider: 오픈웨이트 (OpenAI 호환 서버) · endpoint: http://192.168.0.10:8000/v1/chat/completions · model: qwen3.5-122b
# Ollama: http://127.0.0.1:11434/v1/chat/completions · 사설·사내 주소만 HTTP(키 없이), 공개 인터넷 주소는 HTTPS 만 · 0.20261005.3 부터
/model use qwen-onprem
  • API 키는 macOS 키체인에만 저장합니다. 모델 선택은 폴더별로 기억합니다.
  • 운영 검증된 프로필: GPT(OpenAI 호환 엔드포인트), Gemini(gemini-3-flash-preview).
  • 오픈웨이트: 0.20261005.3 부터 공급자 "오픈웨이트 (OpenAI 호환 서버)" 를 고르면 사설·사내 주소(루프백, 10.x, 172.16–31.x, 192.168.x, 링크 로컬)에 한해 HTTP 와 키 없는 연결이 됩니다(처음 한 번 경고). 공개 인터넷 주소는 HTTPS 만 가능합니다.

STEP 6"진행해" 없이 일 맡기기 — 실행 위임

일꾼 TUI 에서 — 대화로
재위임, 비밀정보 접근을 제외한 모든 권한을 claude-newtype 에게 위임하자
또는 명령으로
/grant claude-newtype --tools all --ttl max
# 미리보기 → 1 (승인)
/grants
/revoke-grant <ID>
  • 기본값은 파일·셸 도구 · 작업 폴더 · 50턴 · 8시간. --ttl max 는 서버 최대(7일). 재위임과 비밀은 항상 제외됩니다.
  • 그 뒤 Claude 에서 send_message 로 그 일꾼에게 일을 보내면 → 범위 안에서 실행 → 답장 → Claude 가 깨어납니다.
실제 원장, 2026-10-04. 사람의 개입 0번.
시각 (UTC)사건
14:49:21.215nmcp 가 메시지를 읽음
14:49:21.442execution_grant.decided allow
14:49:30.606tool.call run_command ok · decided_by grant
14:49:44.572답장 (reply_to) · git log, go test 결과
14:49:44 직후channel 알림으로 Claude 가 깨어나 읽음

실제 원장, 2026-10-04. 사람의 개입 0번.

STEP 7팀

Newtype Slaves TUI
/team create <팀이름> <구성원,구성원,...>
/team confirm
  • 구성원은 살아 있는 세션의 이름입니다.
  • 다시 시작할 때는 같은 폴더에서 newtype — 같은 세션·대화·위임으로 다시 붙습니다.

STEP 8업데이트

터미널
newtype update
  • 또는 TUI 에서 "최신 업데이트"라고 말하거나 /update. 설치와 재시작은 사람이 승인합니다.

STEP 9문제 해결

증상확인 · 조치
위임했는데 거절됨/grants 로 보낸 이·도구·경로·만료 확인
서버가 scope newtype:run 으로 거부0.20261005.1 이상으로 업데이트
Gemini 가 400 오류업데이트
원격 세션이 깨어나지 않음정상 동작입니다. 깨우기가 필요하면 로컬 연결(3단계)
Windows 에서 실행이 차단됨스마트 앱 컨트롤이 켜져 있으면 실행이 차단될 수 있습니다