CLI·코딩 에이전트
bizrouter CLI와 코딩 에이전트를 처음 쓸 때 자주 확인하는 권한과 보안에 관한 내용입니다.
자주 묻는 질문
CLI가 무엇인가요? 개발자만 쓰는 건가요?
터미널에 명령을 쳐서 쓰는 프로그램입니다. 주로 개발자가 설치하지만, 설치와 로그인은 두 줄이고 이후에는 늘 쓰던 도구 이름 앞에 bizrouter만 붙이면 됩니다. 관리자는 콘솔 화면만 쓰셔도 됩니다.
코딩 에이전트가 무엇인가요?
Claude Code, Codex, OpenCode, Hermes, DeepSeek Harness처럼 개발자의 터미널에서 코드를 읽고 고치고 실행해 주는 AI 프로그램입니다. 이 프로그램들이 모델을 호출할 때 BizRouter를 거치게 하는 것이 이 CLI의 첫 역할입니다.
Codex 앱이나 Claude 앱 같은 데스크톱 앱에서도 쓸 수 있나요?
네. 데스크톱 앱은 터미널에서 실행하지 않아 명령 앞에 bizrouter를 붙이는 방식이 통하지 않으므로, 앱의 설정을 한 번 써 두는 명령을 씁니다. bizrouter setup codex --app, bizrouter setup claude-desktop 한 줄이면 되고, 되돌리기는 각각 --undo 입니다. 터미널 없이 앱의 설정 창에 직접 입력하는 방법도 개발 도구 연동 문서에 있으니, 명령이 맞지 않으면 그 방법을 쓰십시오. 이 연동은 계정 로그인 대신 BizRouter API 키로 모델을 호출하므로 사용량은 BizRouter 크레딧으로 계산되고, 계정 로그인이 있어야 켜지는 일부 앱 기능은 제한될 수 있습니다.
bizrouter claude는 평소의 Claude Code와 무엇이 다른가요?
같은 프로그램이 그대로 실행됩니다. 그 실행에서 모델을 호출하는 주소와 인증만 BizRouter로 바뀌어, 화면과 사용법은 똑같은데 과금·모델 정책·감사 로그는 BizRouter 콘솔에 남습니다. 설정 파일은 바뀌지 않으므로 bizrouter 없이 실행하면 평소대로 동작합니다. 다만 bizrouter claude로 나눈 대화는 BizRouter 전용 모델 ID를 기록하므로 bizrouter claude --resume으로 이어 가야 하며, Claude Code가 종료할 때 안내하는 claude --resume <id>를 그대로 실행하면 "There's an issue with the selected model" 오류가 납니다.
왜 로그인할 때 API 키를 자동으로 만들어 주나요?
코딩 에이전트는 모델을 호출할 키가 필요합니다. 승인 화면에서 「이 기기용 API 키도 함께 발급」을 켜 두면 기기 이름이 붙은 키가 만들어져 어느 컴퓨터가 쓰는 키인지 콘솔에서 바로 보입니다. 원치 않으면 체크를 끄면 됩니다.
API 키만 알면 다른 키를 만들거나 정책을 바꿀 수 있게 되나요?
아닙니다. API 키는 예전과 같이 모델 호출에만 쓰입니다. 콘솔을 다루는 명령과 에이전트 도구는 브라우저에서 승인한 사람의 로그인 세션으로 움직이고, 할 수 있는 일은 그 사람이 웹 콘솔에서 할 수 있는 것과 정확히 같습니다. 「사용량 조회 API」 키도 별개이니 그대로 두면 됩니다.
에이전트가 마음대로 설정을 바꾸지는 않나요?
조회는 자유롭지만, 만들기·바꾸기·삭제는 사용자에게 내용을 설명하고 동의를 받은 뒤에만 실행되도록 도구 자체가 막습니다. 전체 API 키를 파일이나 대화에 남기지 않는 규칙도 매뉴얼과 도구 설명에 들어 있습니다. 모든 변경은 로그인한 사람의 권한(관리자 또는 구성원) 안에서만 가능합니다.
노트북을 잃어버리면요?
콘솔 「내 계정 → 로그인된 기기」에서 그 기기의 CLI 세션을 종료하고, 「서비스 API 키」에서 기기 이름이 붙은 키를 삭제하면 끝입니다. 세션은 30일이 지나면 자동으로 만료되며, 조직이 미사용 자동 로그아웃을 정했다면 그보다 일찍 만료될 수 있습니다.
Claude Max나 ChatGPT 구독과 무엇이 다른가요?
구독이 아니라 쓴 만큼 크레딧이 차감되는 API 요금입니다. bizrouter claude나 bizrouter codex로 실행하면 Claude Code와 Codex가 구독 계정 대신 BizRouter API 키로 모델을 호출하고, 사용량은 모델별 토큰 단가로 계산됩니다. 구독 요금제의 사용량 한도 대신 크레딧 잔액과 요청 한도가 적용됩니다.