메인 콘텐츠로 건너뛰기
Strix Halo 기기에서는 이미 모델이 실행 중입니다. 어려운 부분은 인바운드 포트를 열지 않고 노트북, 에디터, 또는 코딩 에이전트에서 해당 모델에 접근하는 것입니다. Tokios 커넥터를 런타임 옆에서 실행하면 https://api.tokios.com에 인증된 엔드포인트 하나가 생성되며, 이 엔드포인트는 OpenAI와 Anthropic 요청 형식을 모두 지원합니다. 따라서 Claude Code, opencode, 또는 모든 OpenAI 호환 클라이언트가 방화벽 규칙을 건드릴 필요 없이 기기에 접속할 수 있습니다.

실행 후: 엔드포인트 격차

Framework Desktop, 미니 PC 및 기타 AMD Ryzen AI Max+ 395(“Strix Halo”) 사용자는 대규모 로컬 모델을 실행하기 위해 128GB 통합 메모리 구성을 구매합니다. 이 실리콘에서 커뮤니티의 일반적인 경험은 llama.cpp를 Vulkan 백엔드와 함께 사용할 때 ROCm/HIP보다 더 안정적이라는 것입니다. 모델이 localhost에서 응답하기 시작하면, 대부분의 사용자가 다음으로 하고 싶은 것은 opencode, Claude Code, 또는 유사한 도구를 연결하는 것입니다. 다음이 필요합니다.
  • 다른 곳에서 접근 가능한 OpenAI 호환 엔드포인트. 런타임은 기본적으로 Strix Halo 기기의 127.0.0.1에 바인딩됩니다. 노트북이나 다른 곳에서 실행되는 코딩 에이전트에서 접근하려면 0.0.0.0에 바인딩하거나 포트를 열거나 터널을 구축해야 하며, 각각 자체 설정이 필요하고 클라이언트별 인증이 없습니다.
  • API 형식. Claude Code는 Anthropic Messages 형식을 사용하고, llama.cpp, Ollama, LM Studio는 OpenAI Chat Completions 형식을 사용합니다. 두 형식을 연결하려면 보통 작은 프록시를 작성하고 유지보수해야 합니다.
  • 도구를 가리킬 안정적인 장소. 동일한 기기에서 llama.cpp, Ollama, LM Studio 사이를 전환하거나 로드된 모델을 바꾸더라도, 해당 기기와 통신하는 모든 클라이언트를 재구성할 필요가 없어야 합니다.
Tokios는 이미 실행 중인 런타임 위에 위치하는 연결 계층입니다. llama.cpp, Ollama, LM Studio, vLLM, 또는 Lemonade Server를 대체하지 않습니다.
2 대의 Strix Halo 기기는 DeepSeek-V4-Flash-0731 GGUF 가중치에 충분한 집계 메모리를 가질 수 있지만, 필요한 llama.cpp RPC 경로는 불안정하고, 안전하지 않으며, 개념 증명 단계입니다. 프로덕션 배포로 취급하지 마세요. 실험적 경계에 대해서는 DeepSeek V4 Flash 로컬 하드웨어를 참고하세요.

Strix Halo 기기에 설정하기

1

기기에서 런타임을 시작하세요

평소와 같이 모델 서버를 실행하세요. 예를 들어 Vulkan 백엔드에서 llama.cpp를 사용합니다.
또는 LM Studio의 로컬 서버, 혹은 Ollama를 사용합니다.
Lemonade Server도 또 다른 옵션입니다. Strix Halo 하드웨어를 자동 감지하고 Vulkan 백엔드를 선택하므로 수동 백엔드 선택을 건너뛸 수 있습니다.
Lemonade Server는 기본적으로 포트 13305에서 수신하고 /v1에 OpenAI 호환 API를 노출합니다. 또한 다른 백엔드에서는 지원하지 않는 AMD Ryzen AI NPUs도 지원합니다. 전체 설정 가이드는 Lemonade Server 원격 접속을 참고하세요.커넥터를 추가하기 전에 해당 런타임의 OpenAI 호환 /v1 API에서 정상적으로 응답하는지 확인하세요.
2

페어링 코드를 발급받고 커넥터를 페어링하세요

Tokios dashboard의 Setup 탭에서 Start pairing을 선택하면 TKS-XXXX-XXXX 형태의 일회용 페어링 코드가 발급됩니다(약 15분간 유효).Linux에서:
Windows(PowerShell)에서:
대시보드에서 Setup 또는 Connectors 탭으로 돌아가 기기를 승인하세요. 커넥터의 토큰은 터널을 통해 전달되며 파일에 직접 붙여넣을 필요가 없습니다.
3

커넥터를 런타임의 /v1 엔드포인트로 지정하세요

커넥터의 업스트림은 외부에 노출하는 포트가 아니라 기기 상의 런타임 자체 OpenAI 호환 API입니다. 기본 포트: llama.cpp 8080, LM Studio 1234, Ollama 11434, Lemonade Server 13305(모두 /v1이 뒤에 붙으며, 모든 런타임의 /v1 OpenAI 호환 API를 사용하되 Ollama의 네이티브 /api는 사용하지 마세요). 인바운드 방화벽 규칙은 필요하지 않습니다. 커넥터는 아웃바운드 연결만 수행합니다.
4

배포를 등록하세요

대시보드의 Models 탭에서 업스트림 모델 id를 strix-coder와 같은 공개 배포 이름에 매핑하세요. 클라이언트는 업스트림 id가 아닌 이 배포 이름을 model 필드로 전송합니다.
5

API 키를 생성하세요

대시보드의 Keys 탭에서 키를 생성하세요. 키는 sk-tok-… Bearer 토큰이며 한 번만 표시되고 특정 배포 이름 패턴으로 범위를 지정할 수 있습니다.

코딩 에이전트에서 사용하세요

커넥터가 페어링되고 배포가 등록되면, 코딩 에이전트를 기기의 로컬 주소 대신 Tokios로 지정하세요.
Claude Code의 모델 선택기는 claude* id만 나열하므로 Tokios 배포가 목록에 나타나지 않습니다. --model strix-coder를 명시적으로 전달하세요.
기기에서 여러 백엔드를 실행하는 경우 — 예를 들어 한 모델에는 llama.cpp, 다른 모델에는 Lemonade Server나 Ollama — 단일 업스트림 페어링 흐름 대신 커넥터 설정 파일을 사용하여 여러 경로와 업스트림을 정의하세요. 동일한 엔드포인트 뒤에 여러 배포를 등록하고 전환하는 방법은 모델 라우팅을 참고하세요.

왜 하나의 엔드포인트인가

  • 에이전트 설정을 건드리지 않고 백엔드를 교체. 같은 기기에서 llama.cpp에서 LM Studio나 Ollama로 전환해도 strix-coder를 대상으로 하는 모든 에이전트가 계속 작동합니다. 커넥터의 업스트림만 변경하면 되지 클라이언트는 변경하지 않습니다.
  • 공유 바인딩 주소 대신 범위 제한 키. 런타임의 포트를 네트워크에 개방하는 대신 특정 배포 패턴으로 제한된 키를 팀원에게 제공하세요.
  • 기기에 인바운드 포트 없음. 커넥터는 아웃바운드 연결만 수행하므로 노트북이나 코딩 에이전트에서 접근하기 위해 런타임을 0.0.0.0에 바인딩하거나 자체 터널을 유지할 필요가 없습니다.

Strix Halo에서 Kimi K3을 실행할 수 있나요?

실행할 수 없습니다. Strix Halo의 128 GB 통합 메모리 풀(OS 오버헤드 후 약 90–110 GB 사용 가능)은 Kimi K3이 요구하는 용량에 훨씬 못 미칩니다. K3은 2.8조 개의 총 파라미터를 가지며 대략 1.4 TB가 네이티브 MXFP4 정밀도(파라미터당 4비트)에서 필요합니다. 이는 블록 스케일, 런타임 버퍼, 활성화, KV 캐시 이전의 수치입니다. 128 GB 풀의 모든 바이트를 가중치에 사용할 수 있다고 해도 약 1.27 TB 부족합니다. Moonshot은 K3을 64개 이상의 가속기가 있는 슈퍼노드에서 구동할 것을 권장합니다. 전체 메모리 계산 및 클러스터 사이징에 대해서는 Kimi K3 하드웨어 심층 분석을 참고하세요.
Strix Halo에 실제로 맞는 모델을 찾고 계신가요? Kimi K3 대신 실행할 모델을 참고하세요. 128 GB 통합 메모리에 최적의 코딩 및 범용 모델입니다.

다음 단계

Quickstart

처음부터 작동하는 커넥터, 배포, API 키까지 설정하세요.

Install the connector

모든 플랫폼에 대한 전체 커넥터 설치 및 페어링 레퍼런스.

Use Claude Code

자세한 설정은 ANTHROPIC_BASE_URL 및 ANTHROPIC_API_KEY 항목을 참고하세요.

Connector config reference

설정 파일 tokios-connector.json으로 하나의 기기에서 여러 모델을 제공하세요.