통합
Claude Code, Codex, Cursor, Cline, Kilo Code 등 자주 쓰는 agent 도구를 TokenHub에 연결합니다.
TokenHub는 OpenAI 호환, Anthropic Claude Messages 호환, Gemini 호환 API를 제공합니다. Base URL과 API key를 직접 지정할 수 있는 도구는 대부분 TokenHub에 연결할 수 있습니다.
도구
개발자 에이전트, IDE 확장, 데스크톱 클라이언트 중에서 선택하세요. 각 카드는 전용 설정 가이드로 연결됩니다.
Terminal agents
개발자 에이전트
저장소 읽기, 코드 수정, 셸 작업, 자동화된 개발 흐름에 적합합니다.
In-editor tools
IDE 확장
에디터 안에서 채팅, 자동 완성, 리팩터링, 리뷰를 처리하는 도구입니다.
Desktop clients
데스크톱 클라이언트
일상 대화, 모델 테스트, 프롬프트 점검, 여러 모델 전환에 사용합니다.
설정 파일 우선
서드파티 agent는 백그라운드 프로세스를 시작하는 경우가 많습니다. 한 terminal에서만 export한 값은 새 terminal, IDE 창, 확장 host에서 사라질 수 있습니다. 먼저 도구의 사용자 설정 파일이나 설정 화면에 저장하고, 임시 환경 변수는 디버깅용으로만 사용하세요.
| 도구 | 권장 위치 | 저장할 내용 |
|---|---|---|
| Claude Code | ~/.claude/settings.json; 선택 사항 ~/.claude.json | 모델과 Anthropic 호환 env; onboarding 상태와 VS Code claudeCode.environmentVariables는 보조 설정입니다. |
| Codex | ~/.codex/config.toml | TokenHub provider, model_providers.tokenhub, env_key, Base URL, wire API. |
| Aider | ~/.aider.conf.yml 또는 프로젝트 .aider.conf.yml | 기본 모델과 openai-api-base; 키는 OPENAI_API_KEY 또는 로컬 비밀 저장소에 둡니다. |
| OpenCode | ~/.config/opencode/opencode.json 또는 프로젝트 opencode.json | Custom provider package @ai-sdk/openai-compatible, options.baseURL, TokenHub 모델, /connect로 선택한 provider. |
| Qwen Code | ~/.qwen/settings.json 또는 프로젝트 .qwen/settings.json | modelProviders.openai, security.auth.selectedType = "openai", envKey, Base URL, model.name. |
| IDE 확장 | VS Code / JetBrains 사용자 설정 또는 확장 설정 | Provider, Base URL, API key, 모델 슬롯, 권한 설정. |
| 데스크톱 클라이언트 | Providers 또는 Models 설정 화면 | OpenAI Compatible 또는 Custom provider와 수동 model ID. |
호환 프로토콜 선택
먼저 도구가 지원하는 프로토콜을 확인한 뒤 Base URL을 선택합니다. 대부분의 IDE와 데스크톱 클라이언트는 OpenAI 호환 모드를 사용하고, Claude Code는 Anthropic Claude Messages 호환 모드가 우선이며, Gemini 네이티브 도구는 Gemini 호환 모드를 사용합니다.
공통 값
| 도구가 요구하는 값 | TokenHub 값 |
|---|---|
| OpenAI 호환 Base URL | https://us-api.tokenhub.com/v1 |
| OpenAI Chat Completions 테스트 URL | https://us-api.tokenhub.com/v1/chat/completions |
| OpenAI Responses 테스트 URL | https://us-api.tokenhub.com/v1/responses |
| Anthropic Base URL | https://us-api.tokenhub.com |
| Anthropic Messages 테스트 URL | https://us-api.tokenhub.com/v1/messages |
| Gemini Base URL | https://us-api.tokenhub.com |
| Gemini 모델 목록 URL | https://us-api.tokenhub.com/v1beta/models |
| API Key | TokenHub 워크스페이스 키. 보통 TOKENHUB_API_KEY로 로컬에 저장합니다 |
| Model ID | TokenHub 모델 목록에 있는 모델 이름 |
도구가 Host와 Path를 분리하면 Host는 https://us-api.tokenhub.com, OpenAI 호환 Path는 /v1을 사용합니다. 전체 Base URL 하나만 요구하면 https://us-api.tokenhub.com/v1을 사용합니다.
마지막 업데이트