OPENAI_API_BASE 및 OPENAI_API_KEY 값을 읽어들입니다. OPENAI_API_BASE 값을 https://api.tokios.com/v1로 설정하고 OPENAI_API_KEY에는 sk-tok-… 형태의 API 키를 입력한 뒤 openai/ 접두사를 붙여 원하는 모델을 선택하면 됩니다. 예시로는 aider --model openai/gemma-tunnel이 있습니다.
사전 요구 사항
- A running Tokios connector paired with your local model — see Connector install
- A registered model deployment name — see Register a model
- A Tokios API key — see API keys
- Aider가 설치되어 있어야 합니다.
Aider 설정하기
위 두 환경 변수를 내보낸 뒤openai/ 접두사와 함께 배포 이름을 지정하여 Aider를 실행합니다.
gemma-tunnel with the public deployment name you registered in the console.
Aider는 모델 이름을 인식하지 못해 컨텍스트 창 크기나 비용 정보를 확인할 수 없다는 경고를 출력할 수 있습니다. 이는
gemma-tunnel이 Aider에 내장된 모델 메타데이터 목록에 없기 때문이며, 로컬이나 사내 배포 환경에서 사용되는 모델 이름이라면 흔히 발생하는 현상이며 문제가 되지 않습니다. Aider는 여전히 OPENAI_API_BASE으로 요청을 정상적으로 전송합니다.문제가 발생했을 경우
- 401은 Tokios에서 제공 —
OPENAI_API_KEY이 누락되었거나 오타가 있거나 API 키가 취소된 상태입니다. Keys 탭에서 해당 키가 활성 상태인지 확인해 주세요. - 404 배포 정보를 찾을 수 없음 —
openai/뒤에 입력된 이름이 등록된 배포 정보와 일치하지 않습니다. Models 탭에서 정확한 공개 배포명을 확인하시기 바랍니다. - 403 — 해당 API 키가 지정된 배포의 모델 패턴에 적용되지 않거나 계정이 일시 정지된 상태입니다. Keys 탭에서 키와 관련된 모델 패턴 정보를 확인해 주세요.
- 503 connector_unavailable / connector_busy — 해당 배포와 연결된 커넥터가 오프라인 상태이거나 이미 요청 처리 한도에 도달한 상태입니다. Connectors 탭에서 커넥터가 정상 작동 중이며 연결되어 있는지 확인해 주세요.
사용 중인 모델은 절대 사용자의 기기 밖으로 나가지 않습니다. 엔드포인트는 어디서든 정상 작동합니다.
Aider는 오직https://api.tokios.com/v1과만 통신합니다. 모델, 가중치, 코드 모두 커넥터가 실행 중인 기기에만 저장됩니다. 기본적으로 Tokios는 프롬프트나 응답 내용을 저장하지 않고 사용량 통계와 메타데이터만 보관합니다. 워크스페이스 관리자가 요청 로깅 기능을 활성화하면 요청 내용(응답 내용은 제외)이 7일 동안 암호화된 상태로 보관되며 사용자 본인의 대시보드에서만 확인 가능합니다. 코딩 에이전트를 사용할 경우 해당 요청 내용에는 에이전트가 읽어들인 파일들도 포함됩니다.
호환 가능한 클라이언트 목록
지원되는 모든 클라이언트의 기본 URL 및 API 키 설정 방법을 확인해 보세요.
API 키 관리
팀원 및 에이전트용
sk-tok-… API 키를 생성하고 권한을 설정하며 주기적으로 교체할 수 있습니다.