클로드 코드·Cursor 팀 사용량 관리 — 개발자마다 키 나누고 상한 정하기

Claude Code 팀 비용은 어디서 사람마다 상한을 거느냐로 갈려요. 구독 좌석, Anthropic 콘솔 API, 원포트 지갑의 키가 각각 다른 자리에서 막아요.

「여러 개 발급」은 키 이름 뒤에 번호가 붙어요(키 1, 키 2…). 받은 CSV 에 누구에게 몇 번 키를 줬는지 적어 두면, 사람이 나갈 때 그 키를 찾기 쉬워요.

Anthropic 도 게이트웨이를 쓸 땐 개발자마다 자격 키를 따로 주라고 안내해요. 그래야 사용이 사람에게 붙고, 누가 나가도 그 키 하나만 끄면 돼요.

한 지갑에 켜 둘 수 있는 키는 기본 50개예요. 기한이 지난 키도 자리를 차지하니, 「기한 지난 키 폐기」로 한 번에 비워요. 그래도 더 필요하면 도입 문의로 알려 주세요.

1. 1회사·기관은 오피스오더의 「원포트 AI API 크레딧」을 사요. 견적서와 결제 길은 「사는 곳·서류」에서 봐요.
2. 2지갑 주인 계정으로 오피스오더에 로그인해 「AI API」 화면의 「키 관리」로 가요.
3. 3「새 키 발급」의 「키 이름」에 개발자 이름을 적고 「키 만들기」를 눌러요. 사람마다 이름이 붙어 있어야 나중에 찾기 쉬워요.
4. 4한 번에 여러 개가 필요하면 「여러 개 발급」을 열어 이름 앞머리, 「만들 개수」, 키별 월 한도, 키별 하루 한도, 「이 날까지 사용」을 적고 「일괄 발급」을 눌러요.
5. 5키 원문은 만들 때 한 번만 보여요. 바로 그 개발자에게 전해요.

키 줄의 「한도 수정」에서 월 사용 한도, 하루 사용 한도, 「이 날까지 사용」을 정하고 「저장」을 눌러요. 비운 칸은 한도 없이 지갑 잔액까지 써요.

월 한도는 한국 시간 1일에, 하루 한도는 0시에 다시 열려요. 고른 날이 지나면 그 키는 저절로 닫혀요.

한 개발자가 한도에 닿으면 그 키만 멈추고 나머지는 그대로 써요. 분당 요청 수 제한은 두지 않아요.

이번 달 한도는 호출을 시작할 때 그 호출이 쓸 수 있는 최대 몫까지 맞대 봐요. 그래서 남은 한도가 조금이면 다 쓰기 전에 막힐 수 있어요.

하루 한도는 그날 쓴 양이 닿을 때 막아서, 마지막 호출과 그 순간 동시에 보낸 호출만큼 넘을 수 있어요.

개발자가 많으면 「관리 키」를 만들어 /v1/keys 로 키를 만들고 한도를 바꿔요.

개발자 각자 자기 컴퓨터의 ~/.claude/settings.json(Windows 는 %USERPROFILE%\.claude\settings.json)에 아래 env 블록을 넣고 자기 키로 바꿔요.

키를 프로젝트의 .claude/settings.json 에 넣지 마세요. 저장소에 올라가 팀 전체가 같은 키를 쓰게 돼요.

주소는 https://oneport.kr 까지만 적어요. Claude Code 가 /v1/messages 를 스스로 붙여요.

VS Code 확장으로 쓰면 이 파일 대신 VS Code 사용자 설정의 claudeCode.environmentVariables 에 같은 두 값을 넣어요. 확장은 그 설정으로 로그인 여부를 먼저 봐요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://oneport.kr",
    "ANTHROPIC_AUTH_TOKEN": "sk-so-개발자_본인_키"
  }
}

Cursor 는 Claude Code 와 달리 OpenAI 호환 주소를 넣는 방식으로 붙여요. 설정 순서는 API 페이지의 「Cursor · Cline · 그 밖의 도구」 안내에 있어요.

파일을 직접 고치는 Agent 모드에서는 지금 GPT 모델이 안 되고 Claude 모델은 돼요. Agent 모드엔 Claude 모델 이름을 넣어요.

개발자마다 나눠 준 키와 키마다 건 한도는 Cursor 에서 불러도 그대로 걸려요. 한 사람이 Claude Code 와 Cursor 를 같이 쓰면 두 도구가 한 키의 한도를 함께 사용해요.

Cursor 공식 도움말(2026년 10월 17일 확인)은 자기 키 칸으로 OpenAI·Anthropic·Google·Azure OpenAI·AWS Bedrock 만 적고 주소를 바꾸는 칸은 적어 두지 않았어요. Cursor 화면이 바뀌면 칸 이름이 다를 수 있어요.

원포트는 이용자가 고른 모델을 다른 모델로 바꾸어 답하지 않아요(이용약관 제37조⑥). 그래서 사용하는 크레딧은 개발자가 고른 모델의 차감 단가를 따라요.

Anthropic 문서는 코딩 대부분은 Sonnet 으로 하고 Opus 는 복잡한 설계 판단에 쓰라고 권해요. 기본 모델은 settings.json 의 model 칸이나 ANTHROPIC_MODEL 로 정해요.

회사가 Claude Code 관리 설정을 배포한다면 availableModels 로 고를 수 있는 모델을 좁히고, 기본 모델까지 묶으려면 enforceAvailableModels 도 켜요.

Claude Code 길로는 Claude 모델만 불러요. Anthropic 은 게이트웨이로 Claude 아닌 모델에 보내는 것을 지원하지 않고, 원포트 같은 제3자 게이트웨이를 보증하거나 관리하지 않아요.

크레딧은 원화(부가세 포함)로 사요. 1 크레딧 = 부가세 포함 2원어치예요. 웹 채팅과 API 키가 한 지갑의 크레딧을 함께 사용해요.

기관 구매는 세금계산서(사업자등록번호나 고유번호 필요)나 현금영수증 중 하나를 골라요. 같은 거래에 둘을 겹쳐 발급하지 않아요.

견적서(직인 포함)는 주문 전에 상품 화면에서, 청구서·거래명세서는 주문 화면에서 받아요.

개발자가 Claude Pro·Max 구독도 갖고 있으면 어느 쪽으로 쓰나요? — ANTHROPIC_AUTH_TOKEN 이 들어 있는 동안은 구독 로그인 대신 그 키로 요청하고, 구독 사용량 한도는 적용되지 않아요. 변수를 지우면 구독 로그인으로 돌아가요.