BizRouter 비즈라우터

개발 도구 연동

BizRouter를 Claude Code, Claude 앱, Codex CLI, Codex 앱, opencodex, Cline, Vercel, OpenCode 환경에 연결하는 빠른 가이드입니다. 명령 한 줄로 끝내려면 BizRouter CLI 를 먼저 보십시오.

빠른 선택 가이드

도구별 권장 Base URL과 경로

BizRouter CLI로 연결

설치 · 로그인 · 실행 세 단계 --model 로 BizRouter 모델 ID를 고를 수 있고, 그 뒤의 인자는 도구에 그대로 전달됩니다. 예: bizrouter codex --model openai/gpt-5.5 exec "README 요약해줘" 도구별 옵션, 영구 설정( bizrouter setup ), 점검( bizrouter doctor )은 BizRouter CLI 문서 에 있습니다.

Claude Code 연동

환경 변수 네 줄로 시작하고, 팀 배포는 settings.json으로 나눕니다 1. 권장 설정 ANTHROPIC_API_KEY 는 빈 문자열로 명시 해야 합니다. 값이 남아 있으면 Claude Code가 Anthropic 직접 인증으로 되돌아가거나 「auth may not work as expected」 경고를 냅니다. CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 을 켜면 Claude Code가 시작할 때 GET /v1/models 를 조회해 /model 선택창에 이 API 키로 쓸 수 있는 Claude 모델을 이름과 함께 채웁니다. API 키 사용 범위와 조직의 모델 차단 정책이 그대로 반영됩니다. Base URL에 /v1 은 붙이지 않습니다. Claude Code가 /v1/messages , /v1/messages/count_tokens , /v1/models 를 스스로 이어 붙입니다. 2. settings.json으로 설정 (팀 배포) 셸 export 대신 ~/.claude/settings.json 의 env 블록에 넣으면 모든 프로젝트에 적용됩니다. 조직 전체에 배포할 때는 같은 내용을 Claude Code의 관리형 설정(managed settings)으로 내려보내면 개발자가 따로 설정할 것이 없습니다. API 키는 프로젝트 settings.json에 넣지 마십시오 프로젝트 안의 .claude/settings.json 은 저장소에 함께 커밋되어 클론하는 모두에게 공유됩니다. 키는 사용자 설정( ~/.claude/settings.json )이나 환경 변수에만 두십시오. 3. 모델 선택 Claude Code가 보내는 claude-fable-* , claude-opus-* , claude-sonnet-* , claude-haiku-* 요청은 BizRouter 내부 모델로 자동 매핑됩니다. 따로 정하지 않아도 바로 동작합니다. 기본 매핑 대신 조직 단위로 family별 대상 모델을 덮어쓸 수 있습니다. 조직 관리자는 모델 접근 정책 에서 haiku , sonnet , opus , fable 각각 원하는 모델로 설정하십시오. (조직 관리자 권한 필요) 이 오버라이드는 Claude Code 경로인 /claude/v1/messages 요청에 적용되며, 설정하지 않은 family는 기본 매핑이 그대로 동작합니다. 개인 환경에서 모델을 직접 고정하려면 Claude Code의 family별 환경 변수에 BizRouter 모델 ID를 그대로 넣습니다. 모델 ID는 모델 목록 에서 확인할 수 있습니다. 모델 ID 끝의 [1m] 마커는 1M(100만 토큰) 컨텍스트 창을 켜는 스위치입니다. Claude Code는 모델 ID의 [1m] 마커로만 컨텍스트 창 크기를 정하고, 마커가 없는 ID는 200k로 회계하므로 1M 모델도 5배 일찍 대화를 압축합니다. bizrouter claude 래퍼와 bizrouter setup claude 는 1M 컨텍스트 모델에 이 마커를 자동으로 붙이므로, 이 문서의 래퍼를 쓰는 경우에는 직접 지정할 필요가 없습니다. 단, claude-haiku-4.5·claude-sonnet-4.5·claude-opus-4.5처럼 컨텍스트가 200k인 모델에는 마커를 붙이지 마십시오. 실제 창보다 늦게 압축해 긴 대화가 오류로 끝납니다. 모델별 컨텍스트 크기는 모델 목록에서 확인할 수 있습니다. 세션 안에서는 /model anthropic/claude-fable-5.1[1m] 처럼 입력해 즉시 전환할 수 있습니다. Claude 외 모델도 Claude Code에서 그대로 씁니다 이 키로 쓸 수 있는 채팅 모델 전체가 /model 선택창에 채워집니다. Claude Code는 ID에 claude 나 anthropic 이 들어간 모델만 보여 주므로, Claude 외 모델은 claude-code/ 접두를 붙여(예: claude-code/bizrouter/glm-5.3[1m] ) 나타납니다. /model 이나 ANTHROPIC_DEFAULT_*_MODEL 에는 접두 없는 카탈로그 ID( bizrouter/glm-5.3 , openai/gpt-6-astra )를 그대로 써도 됩니다. Claude Code가 항상 보내는 Anthropic 전용 힌트( cache_control , thinking , context_management , 이전 턴의 thinking 블록)는 Claude 외 모델로 갈 때 BizRouter가 떼어 내고, 뗀 cache_control 개수를 응답 헤더 x-bizrouter-cache-control-dropped 로 알립니다. 추론 강도는 /effort ( output_config.effort )가 각 프로바이더의 reasoning_effort 로 넘어갑니다. 1M 컨텍스트 모델에는 [1m] 이 붙어 Claude Code가 컨텍스트를 200k로 잘못 계산하지 않습니다. 4. 연결 확인 Claude Code를 켜고 /status 를 실행하면 Status 탭에 아래 두 줄이 보여야 합니다. 이전에 claude.ai 계정으로 로그인해 둔 상태라면 /logout 으로 먼저 지우십시오. Claude Code 없이 주소와 키만 먼저 확인하려면 직접 호출해 봅니다. 5. GitHub Actions Claude Code GitHub Action은 워크플로 env 의 Base URL을 읽고, anthropic_api_key 입력을 x-api-key 헤더로 보냅니다. BizRouter는 두 인증 헤더를 모두 받습니다. 6. 폐쇄망·프록시 환경 Claude Code는 모델 요청 외에도 버전 확인·텔레메트리 같은 부수 트래픽을 Anthropic과 GitHub로 보냅니다. BizRouter로만 나갈 수 있는 망에서는 아래 변수로 그 트래픽을 끄십시오. 이 설정에서도 모델 목록 조회는 BizRouter로만 가므로 /model 선택창은 그대로 동작합니다.

Codex CLI 연동

Responses API provider 설정 Codex CLI에서 BizRouter를 별도 model provider로 등록하고 wire_api = "responses" 를 사용하십시오. Base URL에는 /responses 를 붙이지 않습니다. 1. 환경변수 설정 2. Codex 설정 파일에 provider 추가 $HOME/.codex/config.toml 에 다음 설정을 추가하십시오: 3. 일회성 실행 예시 모델은 BizRouter 모델 ID를 그대로 사용합니다. 예를 들어 openai/gpt-5.3-codex 처럼 provider prefix를 포함해야 합니다. OpenAI 외 모델도 사용할 수 있습니다. 예: anthropic/claude-sonnet-5 , google/gemini-3.5-flash

Codex 앱(Windows·macOS) 연동

데스크톱 앱에서 BizRouter 모델 사용 Codex 앱은 Codex CLI와 같은 config.toml 을 읽습니다. Windows는 %USERPROFILE%\.codex\config.toml , macOS는 ~/.codex/config.toml 입니다. 아래 명령이 이 파일에 BizRouter provider와 모델 목록을 넣어 줍니다. 1. BizRouter CLI 설치와 로그인 2. Codex 앱용 설정 쓰기 기존 config.toml 은 config.toml.bak-<시각> 으로 백업합니다(백업에서는 API 키를 가립니다). 그다음 BizRouter provider와 API 키를 기록하고, 이 키로 쓸 수 있는 모델 목록을 같은 폴더의 bizrouter-models.json 으로 저장해 앱의 모델 선택창에 BizRouter 모델이 나오게 합니다. 쓰기 전에 결과만 보려면 --dry-run 을 붙이십시오. 3. Codex 앱을 완전히 종료한 뒤 다시 실행 macOS는 Cmd+Q, Windows는 작업 표시줄 트레이 아이콘까지 종료하십시오. 설정은 앱이 시작할 때 한 번 읽습니다. 모델 선택창에서 BizRouter 모델 ID(예: openai/gpt-5.3-codex , anthropic/claude-sonnet-5 )를 고르면 됩니다. 되돌리기 BizRouter provider·기본 모델 지정·모델 목록 파일만 지우고 나머지 설정은 그대로 둡니다. API 키 없이도 실행됩니다. API 키가 config.toml에 그대로 저장됩니다 파일은 소유자만 읽도록 만들지만 키는 평문입니다. 공용 PC에서는 쓰지 마십시오. 키를 바꾸거나 새 모델이 추가되면 bizrouter setup codex --app 을 다시 실행하십시오. bizrouter doctor 가 파일의 키가 지금 쓰는 키와 다른지 알려 줍니다. ChatGPT 로그인과는 별개입니다 이 연동은 ChatGPT 계정 로그인이 아니라 BizRouter API 키로 모델을 호출합니다. 사용량과 과금은 BizRouter에 기록되며 ChatGPT 계정의 사용 한도와 무관합니다. ChatGPT 로그인이 있어야 켜지는 앱 기능은 제한될 수 있습니다. CLI 없이 직접 적기 config.toml 에 다음을 넣고 앱을 다시 실행해도 호출은 됩니다. 다만 모델 목록 파일이 없으면 앱의 모델 선택창에 BizRouter 모델이 나오지 않고 Codex 기본 목록이 보이며, 컨텍스트 창 같은 모델 정보가 기본값으로 대체됩니다. Codex CLI 탭의 env_key 방식(환경 변수)은 터미널에서 실행할 때만 쓰십시오. 시작 메뉴·Dock에서 연 앱은 터미널의 환경 변수를 받지 못해 「Missing environment variable」 오류가 납니다.

Claude 앱(Windows·macOS) 연동

Claude 데스크톱에서 BizRouter 모델 사용 Claude 데스크톱 앱에는 Anthropic 계정 로그인 없이 외부 게이트웨이에 연결하는 「타사 추론」 모드가 있습니다. 이 모드에 BizRouter의 Claude 호환 경로를 게이트웨이로 지정합니다. 설정은 앱의 설정 창에 값을 입력하는 방식이라 설정 파일을 직접 고칠 필요가 없습니다. 가장 쉬운 방법: BizRouter CLI 앱의 설정 창이 저장하는 것과 같은 설정을 CLI가 대신 써 줍니다. 주소( https://api.bizrouter.ai/claude )와 API 키를 입력할 필요가 없고, /v1 을 잘못 붙이는 실수도 없습니다. 명령이 끝나면 Claude 앱을 완전히 종료한 뒤 다시 열고 , 로그인 화면에서 타사(게이트웨이)로 시작하는 선택지를 고르십시오. 앱 로그인 화면을 건너뛰고 바로 BizRouter로 시작하게 하려면 --3p-only 를 붙입니다(Claude 계정 로그인 선택지가 숨겨지며, 되돌리기로 복구합니다). 쓰기 전에 기존 _meta.json 을 백업하고, 앱에 이미 있는 다른 설정은 그대로 둡니다. 확인만 하려면 --dry-run . 되돌리기: bizrouter setup claude-desktop --undo (키·네트워크 없이 실행, 이전에 쓰던 설정을 되살립니다). API 키는 처음에 설정 파일에 들어가고, 앱이 처음 시작하면 OS 보안 저장소(macOS는 키체인)로 옮기고 파일의 평문을 지웁니다. 공용 PC에서는 권장하지 않습니다. bizrouter doctor 가 앱에 저장된 BizRouter 주소가 맞는지( /v1 이 붙지 않았는지) 점검합니다. 설정 창에서 직접 입력한 경우도 봅니다. 터미널을 쓰지 않는다면 아래 순서로 앱의 설정 창에 직접 입력하십시오. 1. 준비 Claude 앱을 최신 버전으로 설치하고( claude.com/download ), BizRouter 콘솔에서 API 키를 발급하십시오. Windows에서는 설치 중에 뜨는 관리자 승인 창을 승인하십시오(관리자 권한이 없으면 관리자에게 승인을 받으십시오). 승인하지 않으면 Cowork가 빠진 버전이 설치됩니다. 앱을 열되 Anthropic 계정으로 로그인하지 마십시오. 이미 로그인되어 있다면 먼저 로그아웃하십시오. 2. 개발자 모드 켜기 메뉴에서 도움말 → 문제 해결 → 개발자 모드 활성화… 를 고르십시오 (영어 화면: Help → Troubleshooting → Enable Developer Mode…). Windows는 로그인 화면 왼쪽 위의 ☰ 메뉴에서 같은 순서로 고릅니다. 메뉴에 개발자 가 생기면 됩니다. 3. 타사 추론 설정 입력 개발자 → 타사 추론 설정… 을 열고 Connection 에서 아래 값을 입력하십시오. 이 창의 항목 이름은 한국어로 번역되지 않고 영어로 보입니다. 항목 입력값 비고 Inference provider Gateway 목록에서 선택 Gateway base URL https://api.bizrouter.ai/claude 끝에 /v1을 붙이지 않습니다 Gateway API key BizRouter API 키 ( sk-br-v1-… ) 앞뒤 공백 없이 Gateway auth scheme Bearer 기본값 그대로 (x-api-key도 동작) Model list 비워 둠 시작할 때 이 키로 쓸 수 있는 BizRouter 모델을 자동으로 가져옵니다 앱은 입력한 주소 뒤에 /v1/models 와 /v1/messages 를 직접 붙여 호출합니다. 그래서 BizRouter 주소는 /v1 없이 https://api.bizrouter.ai/claude 입니다. 4. 적용하고 다시 시작 Apply Changes 를 누른 뒤 Save & Restart 를 누르십시오. 앱이 다시 시작되면 로그인 화면에 타사(게이트웨이)로 시작하는 선택지가 나타납니다. 그것을 고르면 Claude 계정 없이 BizRouter로 연결됩니다. 모델 고르기 모델 선택창에는 이 키로 쓸 수 있는 BizRouter 모델이 나옵니다. ID는 BizRouter의 Claude 호환 목록을 그대로 따릅니다. [1m] 은 100만 토큰 컨텍스트 항목입니다. 특정 모델만 보이게 하려면 Model list 에 ID를 직접 추가하십시오(첫 항목이 기본 모델). 위 값은 예시입니다. 쓸 수 있는 모델과 ID는 콘솔의 모델 페이지나 GET https://api.bizrouter.ai/claude/v1/models 결과를 기준으로 하십시오. 연결한 뒤: 내 PC 폴더로 작업하기 내 PC의 폴더를 읽고 파일을 만드는 일은 Cowork 작업이나 Code ( </> 아이콘) 세션에서 합니다. 그 작업에 폴더를 붙여야 Claude가 폴더 안의 파일을 다룰 수 있습니다. Cowork 작업이 아닌 채팅 대화에는 폴더를 붙일 수 없어서, 채팅에서 파일 작업을 시키면 Claude가 할 수 없다고 답하고 Cowork에서 시작하라고 안내합니다. BizRouter 연결과는 관계가 없습니다. 화면 폴더 붙이는 법 알아 둘 점 Cowork (최신 버전은 첫 화면에서 보낸 메시지가 Cowork 작업으로 시작됩니다) 입력창에서 폴더를 추가합니다. 작업 중에 추가하거나, Claude가 폴더 접근을 요청할 때 승인해도 됩니다. PC 안의 격리된 가상 머신(앱 화면에서는 「Claude의 작업 공간」)에서 돌아가며, 붙인 폴더 안의 파일만 읽고 씁니다. 작업 공간 파일(1GB 이상)은 처음 쓸 때와, 앱 업데이트로 새 버전이 필요할 때 downloads.claude.ai 에서 내려받습니다. Code ( </> ) 새 세션을 만들 때 작업할 폴더를 고릅니다. Claude Code를 앱 안에서 쓰는 화면입니다. 가상 머신 없이 고른 폴더에서 바로 파일을 읽고 고칩니다. 채팅 대화에는 폴더를 붙일 수 없습니다. 대화에 첨부한 파일과, 프로젝트 안의 대화라면 그 프로젝트에 추가한 폴더를 읽기만 합니다. 설정 → Cowork → 신뢰할 수 있는 Cowork 폴더 는 Claude가 써도 되는 폴더의 허용 목록일 뿐입니다. 앱 안내문대로 「폴더를 신뢰해도 새 작업에 추가되지는 않습니다」. 작업마다 폴더를 붙여야 하고, 붙일 때 허용을 묻는 창이 다시 뜰 수 있습니다. 이 PC에서 Cowork의 가상 머신을 돌릴 수 없으면, 첫 화면에서 보낸 메시지가 Cowork 작업이 아니라 채팅 대화로 시작되어 폴더를 쓸 수 없습니다. 폴더를 붙일 수 없거나 Claude가 계속 폴더에 접근할 수 없다고 하면 아래 트러블슈팅 10)을 확인하십시오. API 키가 이 PC의 앱 설정에 저장됩니다 앱이 키를 이 PC에 저장합니다. macOS에서는 앱이 처음 시작할 때 키를 키체인으로 옮겨 봉인합니다. 다른 OS에서는 키가 설정 파일에 남을 수 있습니다. 여러 사람이 쓰는 PC에서는 권장하지 않습니다. 키를 바꾸면 같은 창에서 다시 입력하고 Apply Changes → Save & Restart를 하십시오 (CLI로 설정했다면 bizrouter setup claude-desktop 을 다시 실행). Claude 계정·구독과는 별개입니다 이 연동의 호출은 BizRouter 크레딧으로 과금되며 Claude 구독의 사용 한도와 무관합니다. Anthropic 계정이 필요한 앱 기능은 타사 추론 모드에서 제한될 수 있습니다. 원래대로 돌리기 앱을 다시 시작해 나오는 로그인 화면에서 Anthropic 로그인을 고르면 표준 Claude 앱으로 돌아갑니다. BizRouter 설정을 바꾸려면 개발자 → 타사 추론 설정… 에서 값을 고치거나 설정을 삭제하십시오.

opencodex 연동

로컬 프록시 기반 멀티 클라이언트 연동 opencodex 는 Codex CLI·App·SDK와 Claude Code를 다양한 LLM에 연결해 주는 오픈소스 로컬 프록시입니다. BizRouter를 provider로 등록하면 API 키에 허용된 모든 모델을 두 도구에서 그대로 사용할 수 있습니다. 1. 설치 2. BizRouter provider 등록 웹 대시보드에서 등록하는 방법이 가장 간단합니다: 대시보드에서 Add Provider → 커스텀 OpenAI 호환 엔드포인트를 선택하고 Provider ID는 bizrouter , Adapter는 openai-chat , Base URL은 https://api.bizrouter.ai/v1 로 설정하고 BizRouter API 키를 입력하십시오. 키에 허용된 모델 목록을 자동으로 불러옵니다. 또는 ~/.opencodex/config.json 을 직접 편집해도 됩니다 ( ocx init 대화형 설정도 지원): 3. 프록시 실행 및 적용 Codex 모델 피커에는 bizrouter/ prefix가 붙고, 모델 ID 안의 / 는 - 로 바뀐 별칭이 표시됩니다. 예: bizrouter/anthropic-claude-sonnet-5 (원래 형태인 bizrouter/anthropic/claude-sonnet-5 를 직접 입력해도 동일하게 라우팅됩니다.) opencodex는 BizRouter가 개발·운영하는 도구가 아닌 서드파티 오픈소스입니다. 프록시 없이 연결하려면 Codex CLI·Claude Code 탭의 직접 연동 방법을 사용하십시오.

Cline 연동

OpenAI Compatible 제공자 설정 Cline의 기본 제공 OpenAI Compatible 제공자를 선택하고 BizRouter 모델 ID를 직접 입력하십시오. 항목 값 API Provider OpenAI Compatible Base URL https://api.bizrouter.ai/v1 API Key sk-br-v1-YOUR_API_KEY Model ID BizRouter 모델 페이지에서 사용할 모델 ID를 복사해 직접 입력하십시오. Base URL에는 /chat/completions 를 붙이지 마십시오. Cline이 요청 경로를 자동으로 붙여 호출합니다.

AI SDK (Vercel) 연동

BizRouter provider 설정 예시 AI SDK (Vercel)에서 @bizrouter/ai-sdk-provider 를 사용해 BizRouter provider를 연결할 수 있습니다. Runtime 요구사항 현재 package는 Node.js 22 이상, AI SDK ^7.0.0 , Zod ^3.25.76 또는 ^4.1.8 을 요구합니다. 1. 패키지 설치 2. 환경변수 설정 3. provider 연결

OpenCode 연동

bizrouter opencode 한 줄, 또는 opencode.json 설정 파일 사용 가장 간단한 방법은 BizRouter CLI입니다. bizrouter opencode 는 설정 파일을 고치지 않고 이번 실행에만 BizRouter provider를 주입하며, 키가 쓸 수 있는 채팅 모델 전체를 실제 context/output 한도와 함께 OpenCode 모델 목록에 넣습니다. 자세한 옵션은 BizRouter CLI 문서 에 있습니다. 설정 파일에 영구 저장하려면 bizrouter setup opencode 를 실행하십시오. 직접 작성할 때는 아래처럼 OpenCode에 내장된 @ai-sdk/openai-compatible provider로 BizRouter의 OpenAI 호환 엔드포인트를 지정합니다. 1. 환경변수 설정 2. 설정 파일 작성 $HOME/.config/opencode/opencode.json 파일을 생성하십시오: 위 설정은 예시입니다. 모델 ID와 context/output limit는 GET /v1/models 결과를 기준으로 관리하십시오. @bizrouter/ai-sdk-provider는 OpenCode용이 아닙니다 OpenCode의 npm provider로 이 패키지를 지정하지 마십시오. OpenCode가 싣고 있는 AI SDK 스펙(v2·v3)과 맞지 않아 1.x는 답을 마친 뒤 대화를 다시 보내고, 2.x는 로드되지 않습니다. 이 패키지는 Vercel AI SDK 애플리케이션 전용입니다.

트러블슈팅

1) Claude Code에서 404가 나는 경우 ANTHROPIC_BASE_URL 이 https://api.bizrouter.ai/claude 인지 확인하십시오. 2) 인증 오류가 나는 경우 ANTHROPIC_AUTH_TOKEN 에 BizRouter API 키가 들어갔는지, ANTHROPIC_API_KEY 가 빈 문자열인지 확인하십시오. 시작할 때 「auth may not work as expected」 경고가 뜨거나 401이 나면 이전 claude.ai 로그인이 남아 있는 것이므로 /logout 을 실행하십시오. 2-1) Claude Code /model 선택창에 BizRouter 모델이 안 보이는 경우 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 이 설정됐는지 확인하십시오. claude --debug 로 실행한 뒤 ~/.claude/debug/ 의 로그에서 [gatewayDiscovery] 줄을 보면 조회 결과(모델 수, 404, 타임아웃)가 남습니다. 목록에는 ID에 claude 또는 anthropic이 들어간 모델만 나타납니다. 3) Cline 모델 오류 OpenAI Compatible 제공자와 https://api.bizrouter.ai/v1 를 사용한 뒤, BizRouter 모델 ID를 직접 입력하십시오. 4) Codex CLI에서 모델 목록 경고가 나는 경우 base_url 이 https://api.bizrouter.ai/v1 인지, wire_api 가 responses 인지 확인하십시오. 모델 ID는 openai/gpt-5.3-codex 처럼 provider prefix를 포함해야 합니다. 5) Codex 앱에서 「Missing environment variable: BIZROUTER_API_KEY」가 나는 경우 config.toml이 환경 변수에서 키를 읽도록 되어 있는데, 시작 메뉴·Dock에서 연 앱은 터미널의 환경 변수를 받지 못합니다. bizrouter setup codex --app 을 실행해 키를 파일에 저장한 뒤 앱을 완전히 종료하고 다시 여십시오. 6) Codex 앱 모델 선택창에 BizRouter 모델이 안 보이는 경우 앱을 완전히 종료하고 다시 열었는지 확인하십시오. 그래도 같으면 bizrouter doctor 로 모델 목록 파일이 있는지, 파일의 키가 지금 쓰는 키와 같은지 확인하고 bizrouter setup codex --app 을 다시 실행하십시오. 7) Claude 앱에서 모델 목록이 비어 있거나 연결 오류가 나는 경우 Gateway base URL 이 https://api.bizrouter.ai/claude 인지 확인하십시오. 앱이 입력한 주소 뒤에 /v1/models 를 직접 붙이므로 /v1 까지 적으면 /claude/v1/v1/models 가 되어 404가 납니다. 주소 앞뒤 공백도 지우십시오. bizrouter doctor 를 실행하면 앱에 저장된 주소가 맞는지 알려 주고, bizrouter setup claude-desktop 이 맞게 다시 씁니다. 8) Claude 앱에서 인증 오류(401)가 나는 경우 Gateway API key 에 BizRouter API 키가 앞뒤 공백 없이 들어갔는지, 키가 폐기되거나 사용 범위가 제한되지 않았는지 확인하십시오. Gateway auth scheme 은 기본값 Bearer 그대로 두면 됩니다(x-api-key도 동작합니다). 9) Claude 앱에 「개발자」 메뉴가 안 보이는 경우 도움말 → 문제 해결 → 개발자 모드 활성화… 를 다시 고르십시오(Windows는 ☰ 메뉴). 설정을 적용한 뒤 메뉴가 사라질 수 있으며, 같은 항목을 다시 켜면 돌아옵니다. 10) Claude 앱이 폴더에 접근할 수 없다며 파일 작업을 못 하는 경우 폴더 접근은 앱이 PC 안에서 정하는 일이라 BizRouter 연결과는 관계가 없습니다. 대개 아래 중 하나입니다. 작업에 폴더가 붙지 않았습니다. 설정의 신뢰할 수 있는 Cowork 폴더 에 넣는 것만으로는 작업에 붙지 않습니다. Cowork 작업의 입력창이나 Code( </> )의 새 세션에서 폴더를 고르십시오(Claude 앱 탭의 「연결한 뒤: 내 PC 폴더로 작업하기」). 메시지가 Cowork 작업이 아니라 채팅으로 시작되었습니다. 이 PC에서 Cowork의 가상 머신을 돌릴 수 없으면 첫 화면의 메시지가 채팅 대화가 되고, 채팅에는 폴더를 붙일 수 없습니다. Windows는 하드웨어 가상화와 「가상 머신 플랫폼」(Virtual Machine Platform) 기능이 켜져 있어야 합니다. 앱을 설치할 때 관리자 승인 창을 승인하지 않으면 Cowork가 빠진 버전이 설치되므로, 그렇게 설치했다면 관리자 승인을 받아 다시 설치하십시오. 가상화 문제로 Cowork를 쓸 수 없는 동안에는 Code 화면에서 같은 폴더로 작업할 수 있습니다. Cowork 작업이 시작되지 않고 「Claude의 워크스페이스를 다운로드하지 못했습니다」가 보입니다. 사내 방화벽이나 프록시가 downloads.claude.ai 를 막거나 파일을 중간에 끊고 있지 않은지 확인하십시오.

cli BizRouter CLI 가장 쉬운 방법입니다. 명령 앞에 bizrouter만 붙이면 Claude Code·Codex·OpenCode·Hermes·DeepSeek Harness가 BizRouter로 연결됩니다. 설정 파일은 바꾸지 않습니다. 설치 curl -fsSL https://bizrouter.ai/install.sh | bash 또는 npm install -g bizrouter 로그인 bizrouter login 한 번만 실행 bizrouter claude · bizrouter codex · bizrouter opencode · bizrouter hermes · bizrouter deepseek 아래 탭의 환경 변수·설정 파일을 손으로 적는 대신 CLI가 실행할 때마다 넘겨줍니다. 자세한 옵션은 BizRouter CLI 문서를 참고하십시오. claude-code Claude Code CLI Claude Code CLI는 Anthropic 호환 경로를 사용합니다. Base URL https://api.bizrouter.ai/claude 요청 경로 /v1/messages 모델 목록 /v1/models /model 선택창 자동 채움 인증 ANTHROPIC_AUTH_TOKEN Claude Code는 반드시 ANTHROPIC_BASE_URL=https://api.bizrouter.ai/claude로 설정하고, ANTHROPIC_API_KEY는 빈 문자열로 두십시오. codex-cli Codex CLI Codex CLI는 Responses API 경로를 사용합니다. Base URL https://api.bizrouter.ai/v1 요청 경로 /responses 인증 BIZROUTER_API_KEY 환경변수 Wire API responses Codex CLI 모델은 provider prefix가 포함된 BizRouter 모델 ID를 사용하십시오. OpenAI 외 모델도 지원합니다. 예: openai/gpt-5.3-codex, anthropic/claude-sonnet-5 codex-app Codex 앱 (Windows·Mac) Codex 데스크톱 앱은 Codex CLI와 같은 config.toml을 읽습니다. 명령 한 줄이 그 파일에 BizRouter provider와 모델 목록을 넣어 줍니다. 명령 bizrouter setup codex --app bizrouter login 이후 한 번 설정 파일 config.toml Windows %USERPROFILE%\.codex · macOS ~/.codex 인증 BizRouter API 키 config.toml에 저장 (환경 변수는 앱이 받지 못함) 되돌리기 bizrouter setup codex --undo 설정은 앱이 시작할 때 한 번 읽습니다. 명령을 실행한 뒤 Codex 앱을 완전히 종료하고 다시 여십시오. claude-desktop Claude 앱 (Windows·Mac) Claude 데스크톱 앱의 「타사 추론」 모드에 BizRouter를 게이트웨이로 등록합니다. Claude 계정 로그인 없이 BizRouter API 키로 동작합니다. 가장 쉬운 방법 bizrouter setup claude-desktop bizrouter login 이후 한 번 · 앱을 완전히 종료한 뒤 다시 열기 직접 입력 개발자 → 타사 추론 설정… 먼저 도움말 → 문제 해결 → 개발자 모드 활성화… Inference provider Gateway Gateway base URL https://api.bizrouter.ai/claude /v1을 붙이지 않습니다 Gateway API key BizRouter API 키 sk-br-v1-… Gateway auth scheme Bearer 기본값 그대로 직접 입력했다면 Apply Changes → Save & Restart로 앱을 다시 시작하고, 로그인 화면에서 타사(게이트웨이) 시작을 고르십시오. 설정 창의 항목 이름은 한국어로 번역되지 않고 영어로 보입니다. opencodex opencodex opencodex 로컬 프록시 하나로 Codex CLI·App과 Claude Code를 BizRouter에 동시에 연결합니다. 패키지 @bitkyc08/opencodex npm 패키지 Base URL https://api.bizrouter.ai/v1 Adapter openai-chat 인증 API Key 등록 시 1회 입력 API 키 하나만 등록하면 해당 키에 허용된 모든 모델이 Codex와 Claude Code에 자동으로 나타납니다. cline Cline Cline에서는 OpenAI Compatible 제공자에 BizRouter 모델 ID를 직접 입력합니다. Base URL https://api.bizrouter.ai/v1 요청 경로 /chat/completions 인증 Authorization: Bearer vercel Vercel AI SDK (Vercel)에서 @bizrouter/ai-sdk-provider 패키지로 BizRouter provider를 연결합니다. 패키지 @bizrouter/ai-sdk-provider Base URL https://api.bizrouter.ai/ai-sdk 인증 BIZROUTER_API_KEY 환경변수 또는 직접 주입 opencode OpenCode bizrouter opencode 한 줄로 연결합니다. 수동 설정은 OpenCode 내장 @ai-sdk/openai-compatible provider를 씁니다. 명령 bizrouter opencode 설정 파일 무변경 패키지 @ai-sdk/openai-compatible Base URL https://api.bizrouter.ai/v1 인증 BIZROUTER_API_KEY 환경변수

주식회사 AI3 | 서울 강남구 영동대로85길 34 | support@bizrouter.ai