AXRouter 관리하기

관리자 콘솔의 AXRouter 그룹 다섯 메뉴를 다뤄요.
사람마다 각자 산 AI 키로 쓰면 회사는 얼마를 쓰는지도, 무엇을 주고받는지도 알 수 없어요. AXRouter는 그 호출을 전부 한 통로로 모아요.

순서

앞 단계가 끝나야 다음 단계에서 고를 것이 생겨요. 이 순서대로 하세요.

1. 모델 연결하기 (BYOK)

**모델 연결(BYOK)**에서 회사가 이미 산 공급사 키를 등록해요. 등록한 키로 AXRouter가 대신 호출해 줘요. 키는 암호화해서 보관돼요.

1. 목록에서 공급사를 골라요. 위쪽이 등록됨, 아래가 공급사 추가예요
2. 이름과 API 키를 넣어요
3. 등록 전에 키 시도해보기로 모델을 하나 골라 실제로 호출해 봐요
4. 등록을 눌러요

2. 가드레일 만들기

AI 가드레일 화면의 가드레일 탭에서 만들어요. 가드레일은 키에 걸리는 규칙 묶음이에요. 카드 세 장으로 나뉘어 있어요.

한도는 주기별로 켜요. 여러 주기를 동시에 켜면 전부 동시에 걸려요 — 하루 한도와 월 한도를 같이 두는 식이에요. 하나도 안 켜면 비용 제한 없이 호출돼요. 만료는 "발급 후 며칠"로 정해요.

허용 모델은 비워 두면 전체 허용이에요. 필요한 것만 골라 두면 그 밖의 모델은 호출이 막혀요.

민감정보 탐지는 잡아낼 항목을 고르고, 패턴 테스트에 문장을 넣어 실제로 걸리는지 미리 확인할 수 있어요.

3. 정책 만들고 사람에게 붙이기

가드레일은 만들어 둔 규칙일 뿐이에요. 사람에게 닿게 하는 건 정책이에요.

정책 탭에서 정책 만들기를 눌러요. 처음엔 이름만 정하고, 만든 뒤 상세에서 채워요.

붙이는 방법은 두 가지예요.

• 정책 쪽에서 — 정책 상세의 개인 배정 멤버에서 사람을 넣어요
• 사람 쪽에서 — 팀원 또는 팀 상세의 AI 가드레일 정책 탭에서 골라요. 팀에 붙이면 팀원 전체에 적용돼요

4. 키 발급하고 도구에 넣기

API 키 화면에 회사에서 발급된 키가 전부 나와요. 목록에서 키 · 소유자 · 가드레일 · 사용액 · 예산 · 만료 · 상태를 봐요. 소유자가 워크스페이스면 회사 공용 키예요.

회사 키 발급을 누르면 이름과 가드레일을 정해서 공용 키를 만들어요. 개인 키는 각자 자기 화면에서 발급해요.

도구에 넣기

쓰는 도구의 base URL과 API 키만 바꾸면 그때부터 이 통로를 지나요. 키는 ax-로 시작하는 값을 통째로 넣어요.

Claude Code처럼 Anthropic 규약을 쓰는 도구는 주소를 그대로 씁니다.

ANTHROPIC_BASE_URL=https://axrouter.ai
ANTHROPIC_AUTH_TOKEN=<발급받은 키>

OpenAI 호환 도구는 뒤에 **/v1**을 붙여요.

base_url = https://axrouter.ai/v1
api_key  = <발급받은 키>

키를 코드에 직접 적기보다 환경변수로 두는 편이 안전해요. 이 안내는 콘솔의 AI 도구에 키 넣는 방법에도 그대로 있어서, 쓰는 사람에게 그 화면을 열어 보라고 하면 돼요.

발급한 뒤에도 목록에서 가드레일 변경과 폐기를 할 수 있어요.

터미널에서 발급하기

개인 키는 터미널의 axhub 명령어 도구(CLI)로도 다룰 수 있어요.

axhub axrouter keys issue --name "내 키" --purpose "로컬 개발용"
axhub axrouter keys list                        # 내 키 목록
axhub axrouter keys revoke <key_id> --execute   # 폐기

여기서도 키 값은 발급할 때 한 번만 찍혀요. 회사 하나에만 속해 있지 않다면 --tenant <회사 슬러그>를 붙여요.

5. Code Agent 기록 켜기

Claude Code 같은 개인 구독형 도구는 우리 키를 쓰지 않아요. 각자 산 구독으로 돌기 때문에 4단계의 키와 무관하고, 그래서 아무것도 안 하면 모니터링 화면의 Code Agent 탭이 비어 있어요.

채우려면 쓰는 사람이 직접 두 가지를 해야 해요. 관리자가 대신 켤 수 없어요.

① 동의하기 — 콘솔의 AI 활용 기록 페이지(/{회사 슬러그}/ai-usage)에서 본인이 동의해요. 메뉴에는 없고 주소로 들어가는 화면이라, 관리자가 링크를 안내해 주는 편이 좋아요.

② 수집 켜기 — 그다음 터미널에서 켜요.

axhub axrouter status                          # 회사별 이용 가능 여부와 내 동의 상태
axhub axrouter monitor --tenant <회사 슬러그>    # 수집 켜기

끄는 방법이 두 가지인데 뜻이 달라요.

6. 사용량 보기

AI 대시보드는 회사 전체가 얼마를 썼는지 기간별로 보여 줘요.

• 비용과 토큰 중에 골라 봐요
• 모델별 · 키별 · 멤버별 · 그룹별로 끊어서 볼 수 있어요
• 팀과 사람 순위가 함께 나와서, 어디서 많이 쓰는지 바로 보여요

AI 사용 모니터링은 실제로 무엇을 주고받았는지를 봐요. 탭이 두 개예요 — Code Agent(5단계에서 켠 개인 구독 도구)와 API Keys(4단계에서 발급한 키). 화면 위에서 본문 보존 기간과 API 키 요청 로깅 켜짐 여부를 확인하고 설정에서 바꿔요. 내보내기도 여기서 해요.

쓰는 사람이 막혔다고 할 때