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 탭이 비어 있어요.

채우는 방법은 두 가지예요. 기본은 쓰는 사람이 직접 아래 두 가지를 하는 거예요. 회사가 Claude Team 또는 Enterprise 플랜이면 관리자가 조직 단위로 한 번에 켤 수도 있어요.

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

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

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

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

조직 단위로 한 번에 켜기 (Claude Team · Enterprise)

회사가 Claude Team 또는 Enterprise 플랜을 쓴다면, 관리자가 Claude 조직 설정에 값을 한 번 넣는 것으로 구성원 전체의 기록을 받을 수 있어요. 구성원은 터미널에서 아무것도 하지 않아도 돼요. 설정 파일을 만질 수 없는 Cowork 기록도 이 방법으로만 받을 수 있어요.

워크스페이스 소유자만 할 수 있어요.

① 토큰 발급하기 — AI 사용 모니터링 화면 위의 Claude 조직 연결을 열고 토큰 발급을 눌러요. 이름을 적고, 구성원에게 알릴 책임이 조직에 있다는 확인에 체크해요.

② Cowork 에 넣기 — Claude 관리자 설정의 데이터 및 개인정보 보호 → 모니터링에 세 값을 넣고 저장해요.

리소스 속성처럼 위에 없는 칸은 비워 둬도 돼요.

③ Claude Code 에 넣기 — Claude 관리자 설정의 Claude Code → 관리형 설정에 아래 내용을 통째로 붙여넣어요.

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://axrouter.ai/v1/agent/otlp",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer <발급받은 토큰>",
    "OTEL_LOG_USER_PROMPTS": "1",
    "OTEL_LOG_ASSISTANT_RESPONSES": "1",
    "OTEL_LOG_TOOL_DETAILS": "1"
  }
}

④ 구성원에게 알리기 — 수집 사실은 조직이 직접 알려야 해요. 구성원마다 따로 동의를 받지 않기 때문이에요. 함께 알려 줄 것이 세 가지 있어요.

• 설정한 뒤 새로 시작한 세션부터 들어와요. 데스크톱 앱은 한 번 껐다 켜야 해요
• 터미널의 Claude Code 는 처음 실행할 때 승인 창이 한 번 떠요. 수락해야 적용돼요
• Claude 에 회사 계정으로 로그인해야 해요. 그 이메일이 AXHub 가입 이메일과 같아야 그 사람의 기록으로 쌓여요

⑤ 확인하기 — 구성원이 세션을 시작하면 Claude 조직 연결의 토큰 카드에 마지막 수신 시각이 찍히고, Code Agent 탭에 기록이 쌓여요.

토큰 카드 아래에 가입 이메일과 달라 저장하지 못한 계정이 보이면, 그 이메일로 AXHub 에 가입한 구성원이 없다는 뜻이에요. 구성원으로 초대하면 그 뒤에 시작한 세션부터 쌓여요. 지난 기록은 되살리지 않아요.

기록을 원하지 않는 구성원은 axhub axrouter revoke-consent --execute로 본인 수집을 멈출 수 있어요. 조직 전체 수집을 멈추려면 토큰 카드의 메뉴에서 해제를 눌러요. 해제는 되돌릴 수 없어서, 다시 받으려면 새 토큰을 발급해 Claude 조직 설정에 넣어야 해요.

6. 사용량 보기

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

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

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

쓰는 사람이 막혔다고 할 때