https://api.tokios.com에 인증된 엔드포인트 하나가 생성되며, 이 엔드포인트는 OpenAI와 Anthropic 요청 형식을 모두 지원합니다. 따라서 노트북, Claude Code, 그리고 초대한 누구나 방화벽 규칙을 건드릴 필요 없이 Spark에 접속할 수 있습니다.
”작동한다” 이후의 격차
DGX Spark 및 GB10 사용자는 보통 Ollama, llama.cpp, vLLM, 또는 Lemonade Server로 모델을 실행한 뒤, 두 번째 문제에 부딪힙니다. Spark 자체 외의 다른 곳에서 해당 모델을 사용하는 것입니다.- 연결 작업. 여러 모델 환경에서 OpenAI 호환 엔드포인트를 하나 꺼내려면 LiteLLM,
llama-swap, 런타임 자체를 서로 연결하고 동기화를 위한 폴링 데몬까지 추가해야 합니다. 일부 DGX Spark 커뮤니티 프로젝트에서는 이를 명시적 목표로 설명하며, 많은 사용자들은 이런 연결 작업을 “차라리 건너뛰고 싶은 배관 작업”으로 표현합니다. - 원격 접속. 다른 기기에서 Spark에 접속하는 일반적인 경로로는 런타임을
0.0.0.0에 바인딩하는 것(snap set ollama host="0.0.0.0:11434"), SSH 터널, 또는 Tailscale이 있습니다. 각각 ARM64 / DGX OS 환경에서 번거로운 설정이 필요하며, 단순히 열어둔 포트에는 클라이언트별 인증이 없습니다. - API 형식. Claude Code는 Anthropic Messages 형식을 사용하고, 로컬 런타임은 OpenAI Chat Completions 형식을 사용합니다. 두 형식을 연결하려면 보통 작은 프록시를 작성하고 유지보수해야 합니다.
2 대의 DGX Spark는
DeepSeek-V4-Flash-0731을 분할할 수 있는 충분한 집계 메모리를 제공할 수 있지만, DeepSeek 전용 클러스터 레시피는 아직 커뮤니티 차원에서 검증 중이며 0731 재검증이 필요합니다. 커넥터는 헤드 노드의 /v1 엔드포인트에 두세요. 성숙도 라벨 및 설정 경계에 대해서는 DeepSeek V4 Flash 로컬 하드웨어를 참고하시기 바랍니다.DGX Spark 클러스터에서 Kimi K3을 실행할 수 있나요?
실행할 수 없습니다. Kimi K3의 2.8T 파라미터(MoE를 통해 토큰당 약 50B가 활성)는 대략 1.4 TB가 네이티브 4-bit 하한에서 필요하며, NVIDIA의 문서화된 Spark 클러스터는 최대 4 노드 512 GB이고, Moonshot은 K3을 64개 이상의 가속기가 있는 슈퍼노드에서 구동합니다. 8대의 DGX Spark(1 TB 풀)라도 순수 가중치 하한에만 376 GB 부족합니다. 현재 Spark에서는 NVIDIA의 문서화된 120B 단일 노드, 400B 듀얼 노드, 또는 700B 쿼드 노드 범위 내에서 모델을 선택하세요. 전체 목록은 DGX Spark 모델 호환성을, 각 Spark 구성에 가장 적합한 모델은 Kimi K3 대신 실행할 모델을 참고하세요. K3의 전체 메모리 계산 및 클러스터 산술에 대해서는 Kimi K3 하드웨어 심층 분석을 확인하세요.Spark에 설정하기
1
Spark에서 런타임을 시작하세요
평소와 같이 모델 서버를 실행하세요. 예를 들어:또는Lemonade Server는 CUDA를 자동으로 처리하는 대안입니다. DGX Spark의 GPU를 감지하고 수동 플래그 없이 올바른 백엔드를 선택합니다.Lemonade Server는 기본적으로 포트
13305에서 수신하고 /v1에 OpenAI 호환 API를 노출합니다. 설치 지침은 lemonade-server.ai를 참고하세요.커넥터를 추가하기 전에 해당 런타임의 OpenAI 호환 /v1 API에서 정상적으로 응답하는지 확인하세요.2
페어링 코드를 발급받고 커넥터를 페어링하세요
Tokios dashboard의 Setup 탭에서 Start pairing을 선택하면 Tokios는 DGX Spark의 Grace CPU를 커버하는 Linux arm64용
TKS-XXXX-XXXX 형태의 일회용 페어링 코드가 발급됩니다(약 15분간 유효). Spark에서 다음을 실행하세요.tokios-connector 빌드를 제공합니다. 정확한 systemd 통합 및 패키징 단계는 DGX OS 버전에 따라 다를 수 있으니 설치 스크립트를 작성하기 전에 버전을 확인하세요.대시보드에서 Setup 또는 Connectors 탭으로 돌아가 기기를 승인하세요. 커넥터의 토큰은 터널을 통해 전달되며 파일에 직접 붙여넣을 필요가 없습니다.3
커넥터를 런타임의 /v1 엔드포인트로 지정하세요
커넥터의 업스트림은 외부에 노출하는 포트가 아니라 Spark 상의 런타임 자체 OpenAI 호환 API입니다. 기본 포트: Ollama
11434, vLLM 8000, Lemonade Server 13305(모두 /v1이 뒤에 붙습니다). 인바운드 방화벽 규칙은 필요하지 않습니다. 커넥터는 아웃바운드 연결만 수행합니다.4
배포를 등록하세요
대시보드의 Models 탭에서 업스트림 모델 id(예:
llama3.1)를 spark-llama와 같은 공개 배포 이름에 매핑하세요. 클라이언트는 업스트림 id가 아닌 이 배포 이름을 model 필드로 전송합니다.5
API 키를 생성하세요
대시보드의 Keys 탭에서 키를 생성하세요. 키는
sk-tok-… Bearer 토큰이며 한 번만 표시되고 특정 배포 이름 패턴으로 범위를 지정할 수 있습니다.어디서든 사용하세요
커넥터가 페어링되고 배포가 등록되면, 클라이언트를 Spark의 IP 주소 대신 Tokios로 지정하세요.Claude Code의 모델 선택기는
claude* id만 나열하므로 Tokios 배포가 목록에 나타나지 않습니다. --model spark-llama를 명시적으로 전달하세요.왜 하나의 엔드포인트인가
- 클라이언트 설정을 건드리지 않고 모델을 교체. 배포 이름을 다른 업스트림 모델이나 백엔드로 지정하면
spark-llama를 대상으로 하는 모든 에이전트와 스크립트가 계속 작동합니다. - 팀원을 위한 범위 제한 키. 팀원에게 Spark에 대한 원시 접근 권한을 공유하는 대신 특정 배포 패턴으로 제한된 키를 제공하세요.
- Spark에 인바운드 포트 없음. 커넥터는 아웃바운드 연결만 수행하므로 노트북에서 접근하기 위해 런타임을
0.0.0.0에 바인딩하거나 SSH 터널 또는 Tailscale 노드를 유지할 필요가 없습니다.
다음 단계
Quickstart
처음부터 작동하는 커넥터, 배포, API 키까지 설정하세요.
Install the connector
모든 플랫폼에 대한 전체 커넥터 설치 및 페어링 레퍼런스.
Use Claude Code
자세한 설정은
ANTHROPIC_BASE_URL 및 ANTHROPIC_API_KEY 항목을 참고하세요.Connector config reference
설정 파일
tokios-connector.json으로 하나의 Spark에서 여러 모델을 제공합니다.