에이전트 호환성 표
“툴 호출”이란 에이전트가 요청 시
tools을 전송하고 응답에서 tool_calls을 파싱할 수 있음을 의미합니다. 이 기능이 엔드투엔드로 작동하려면 에이전트와 로컬 모델 양쪽 모두가 지원해야 하는데, Qwen3-Coder-30B, Llama-3-70B, Mistral 같은 모델들은 vLLM 환경에서 툴 호출을 잘 처리합니다.IDE 기반 에이전트들
이 에이전트들은 사용자의 편집기 내부에서 작동하며 코딩 중에 자동 완성 요청을 전송합니다. 별도의 언급이 없는 한 모두 OpenAI Chat Completions API 형식을 사용합니다.Cline과 Roo Code
Cline과 그 포크인 Roo Code는 둘 다 “OpenAI 호환” 프로바이더를 사용합니다. 확장 프로그램 설정에서 3 필드들을 다음과 같이 지정해주세요:- API 프로바이더:
OpenAI Compatible - 기본 URL:
https://api.tokios.com/v1 - API 키: 사용자의
sk-tok-…키 값 - 업스트림 모델 ID: 배포 시 지정한 이름 (예:
qwen3-coder-tunnel)
계속하기
계속하기는~/.continue/config.yaml을 읽습니다. 모델 항목을 추가하려면 다음을 수행하세요:
커서
커서의 커스텀 모델 오버라이드 기능에서는 기본 URL과 API 키를 지정할 수 있습니다. 지원 여부는 커서 버전에 따라 다르므로 실제 사용 전에 커스텀 기본 URL 라우팅이 정상 작동하는지 확인하시기 바랍니다:- Open Cursor Settings → Models.
- 기본 URL로
https://api.tokios.com/v1을 입력하고sk-tok-…API 키를 지정하여 커스텀 모델을 추가합니다.
제드
제드는settings.json 내에서 오픈AI 호환 커스텀 제공업체를 지원합니다:
settings.json — enter it in Zed’s LLM provider UI, or export TOKIOS_API_KEY (Zed derives the variable name from the provider id). See the Zed guide.
젯브레인 AI 어시스턴트
JetBrains AI Assistant는 플러그인 설정을 통해 BYOK(Bring Your Own Key) 기능을 제공합니다. 사용자 지정 제공업체 필드에 기본 URL과 API 키를 입력해 주세요.- 기본 URL:
https://api.tokios.com/v1 - API 키: 귀하의
sk-tok-…키입니다
VS Code Copilot
GitHub Copilot 역시 BYOK 기능을 점차 지원하고 있습니다. VS Code 버전에서 사용자 지정 제공업체 기능이 지원된다면 다음 주소를 입력해 주세요:- 기본 URL:
https://api.tokios.com/v1 - API 키: 귀하의
sk-tok-…키입니다
터미널 에이전트
이 에이전트들은 사용자의 셸 환경에서 실행되며 환경 변수나 설정 파일을 통해 연결됩니다.Claude Code
Claude Code는 OpenAI가 아닌 Anthropic API 형식을 사용합니다. 2 환경 변수를 설정해 주세요:/v1 접미사가 없습니다.
세션 간에도 설정을 유지하려면 Claude Code 안내서를 참고하시기 바랍니다.
OpenAI Codex
OpenAI Codex는 Responses API (wire_api=responses)를 사용합니다. ~/.codex/config.toml에 기본 URL을 설정해 주세요:
env_key은 API 키 자체가 아니라 키를 저장하는 변수명이며, Tokios가 상태 없이 Responses 서비스를 제공하므로 disable_response_storage도 필수입니다. 이후 다음 명령을 실행하세요:
Aider
Aider는 환경 변수에서 기본 URL과 API 키를 읽어들이며,openai/ 모델 접두사도 필요합니다:
OpenCode
OpenCode는 내부적으로 AI SDK (Vercel)를 사용합니다.opencode.json에 사용자 정의 프로바이더를 추가해 주세요:
구스
구스에 내장된openai 제공자는 사용자 지정 호스트를 지원합니다. 구스는 이 설정들을 ~/.config/goose/config.yaml에 저장합니다:
~/.config/goose/custom_providers/ 위치에 JSON 파일을 배치하면 됩니다.
See the Goose guide.
파이와 옴프
파이는api: openai-completions을 이용해 사용자 지정 제공자를 활용합니다. 옴프(오마이파이) 역시 동일한 방식을 따르는데, providers은 제공자 이름을 키로 하는 맵 구조이며 키는 캐멀케이스 형식입니다. 옴프는 ~/.omp/agent/models.yml을 읽고 파이는 ~/.pi/agent/models.json을 읽습니다:
허미스 에이전트
허미스 에이전트는 OpenAI 호환/v1/chat/completions 엔드포인트에 연결할 수 있습니다. 이 에이전트는 ~/.hermes/config.yaml을 읽으며 제공자 키들은 model: 아래에 중첩되어 저장됩니다:
범용 설정 패턴
위에 나열된 모든 에이전트는 동일한 3단계 패턴을 따릅니다:- 기본 URL 설정 시에는
https://api.tokios.com/v1(OpenAI) 또는https://api.tokios.com(Anthropic)을 입력하세요. - API 키 설정 시에는 본인의
sk-tok-…API 키를 입력하시면 됩니다. - 모델 설정 시에는 등록해둔 배포 이름을 지정하세요.
엔진별 툴 호출 호환성
툴 호출 기능은 에이전트와 백엔드 양측의 지원이 모두 필요합니다. 아래는 이 기능을 지원하는 로컬 엔진 목록입니다:코딩 에이전트용으로 최적화된 로컬 모델들
하나의 엔드포인트로 모든 모델을 지원합니다
에이전트를 교체할 때마다 모델 설정을 다시 변경할 필요가 없습니다. Tokios에 한 번만 배포 정보를 등록하고sk-tok-… API 키를 생성해두면 어떤 에이전트든 동일한 엔드포인트를 사용할 수 있습니다. 2 환경 변수만 변경해주면 Aider에서 Claude Code로 전환도 가능합니다. 이 과정에서 사용 중인 모델, 커넥터, 배포 설정은 그대로 유지됩니다.
빠른 시작 가이드
커넥터를 설정하고 첫 번째 배포 작업을 등록해보세요
호환 가능한 클라이언트 목록
코딩 에이전트뿐만 아니라 39과 호환되는 모든 클라이언트의 전체 목록입니다
로컬 모델 선택하기
사용 중인 하드웨어와 활용 목적에 적합한 모델을 고르세요
API 키 관리
팀원 및 에이전트들이 사용할 API 키를 생성하고 권한을 설정하며 주기적으로 교체할 수 있습니다