Skip to main content
AionUi는 Claude Code, Codex, OpenCode 등 여러 코딩 에이전트를 조율하고 자체 내장 에이전트를 포함하는 오픈 소스 데스크톱 “동료 작업(cowork)” 앱입니다. Tokios를 Custom OpenAI 호환 모델로 추가하고 https://api.tokios.com/v1로 sk-tok-… 키를 설정하면, AionUi의 내장 에이전트가 자체 하드웨어의 모델에서 실행됩니다.
이 페이지는 AionUi 자체의 모델 구성을 다룹니다. AionUi가 실행하는 외부 CLI 에이전트(Claude Code, OpenAI Codex, Hermes Agent 등)는 각각 자체 설정을 읽습니다. 이러한 에이전트는 Claude Code 및 OpenAI Codex와 같은 전용 가이드를 사용하여 Tokios로 연결합니다.

​
전제 조건

커넥터 페어링 완료

AionUi가 도달하려는 모델 옆에 tokios-connector를 설치하고 페어링합니다.

모델 등록 완료

해당 모델에 대한 배포(공개 이름)를 등록합니다.

API 키 생성 완료

해당 배포에 범위가 제한된 sk-tok-… 키를 생성합니다.

지원되는 백엔드

로컬 백엔드(Ollama, llama.cpp, vLLM, LM Studio)가 실행 중인지 확인합니다.

​
Tokios를 커스텀 모델로 추가하기

1

모델 설정 열기

AionUi에서 Settings → Model Settings를 열고 Add Model을 선택합니다.
2

Custom 플랫폼 선택

플랫폼 목록에서 Custom을 선택합니다. 이는 OpenAI 호환 인터페이스를 노출하는 모든 서비스에 대한 옵션입니다.
3

Base URL 및 API 키 설정

Tokios 엔드포인트와 키를 입력합니다:
접미사 /v1을 Base URL에 포함하십시오.
4

배포를 모델 이름으로 추가

다음으로 Model Names에 public deployment name을 Models 탭에 등록한 이름으로 입력합니다 — 예를 들어 gemma-tunnel. 이는 백엔드의 로컬 모델 ID가 아니라 AionUi가 model 필드에서 전송하는 값입니다.
배포 이름은 gemma-tunnel을 등록한 이름으로, API 키는 sk-tok-YOUR_KEY를 자체 키로 대체합니다. 이 둘 중 어느 것도 공유 구성 파일에 커밋하지 마십시오.

​
하나의 GUI, 그 뒤에 자체 모델

AionUi는 파일을 읽고, 코드를 작성하며, 작업을 자동화하는 에이전트를 실행하도록 설계되었습니다. 내장 모델을 Tokios로 연결하면 이러한 워크플로우가 사용자가 제어하는 모델에서 실행됩니다. 모델 옆의 커넥터가 Tokios로 아웃바운드를 걸고, AionUi는 인바운드 포트나 VPN 없이 키를 사용하여 https://api.tokios.com/v1에서 이를 도달합니다.

​
문제 해결

AionUi가 전송한 API 키가 누락되었거나, 형식이 잘못되었거나, 취소되었습니다. 추가 공백 없이 전체 sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인합니다.
모델 값이 등록된 배포와 일치하지 않거나, Base URL에 /v1이 누락되었습니다. 모델 이름이 Models 탭의 공개 이름과 일치하고, Base URL이 https://api.tokios.com/v1인지 확인합니다.
해당 배포의 커넥터가 오프라인이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인합니다. 커넥터는 Online로 표시되어야 하며, 실행 중인 머신은 여전히 가동 중이고 도달 가능해야 합니다.

​
다음 단계

호환 클라이언트

기타 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 참조합니다.

Claude Code 사용

AionUi가 실행하는 Claude Code 에이전트를 Tokios 엔드포인트로 연결합니다.