클로드(Claude) API 키 발급 — 콘솔에서 받는 순서와 안 될 때

Claude API 키는 Claude Console(platform.claude.com)의 API keys 화면에서 「Create key」로 만들어요. 키는 만들 때 한 번만 보이니 그 자리에서 환경변수나 비밀 관리 도구에 옮겨 두고, 잃으면 새로 만들어요.

학교·회사에서 Gemini·GPT 도 같이 쓰거나 원화로 사고 견적서를 받아야 하면, 키 하나로 여러 회사 모델을 부르는 원포트 키도 있어요.

「Create key」 창의 Linked account 가 키의 종류를 정해요. 나를 고르면 개인 키, 서비스 계정을 고르면 서비스 계정 키예요. 개인 키를 여럿이 돌려 쓰면 그 사람이 조직을 떠나는 순간 모두 같이 멈춰요.

만료는 3시간 · 1일 · 7일 · 30일 가운데 고르거나 기간을 직접 정해요. 비밀 관리 도구에 두고 직접 바꿔 끼울 키라면 Never 를 골라요. 조직에 최대 기간 정책이 있으면 그 안에서만 고를 수 있고 Never 는 보이지 않아요.

만료는 만든 뒤에 바꿀 수 없어요. 만료가 다가오면 만든 사람에게 메일이 와요 — 수명이 14일 이상인 키는 7일 전, 7일 이상인 키는 1일 전이고, 그보다 짧은 키는 알림 없이 끝나요.

워크스페이스를 하나 고르면 키가 그 워크스페이스에서만 돌고, 요청에 따로 적을 게 없어요. 고르지 않은 개인·서비스 계정 키는 요청마다 anthropic-workspace-id 헤더에 워크스페이스 ID 를 실어야 해요. ID 는 Console 의 Workspaces 화면 ID 칸에 있어요.

Console 은 사람마다 역할이 있고, 키를 만들고 관리하는 역할은 정해져 있어요. 버튼이 꺼져 있으면 조직 관리자에게 역할을 바꿔 달라고 하거나, 쓸 일에 맞는 서비스 계정 키를 만들어 달라고 해요.

Pro·Max·Team 구독과 Claude Console 은 다른 상품이라, 구독을 쓰고 있어도 API 를 부르려면 Console 을 따로 열어 키를 만들어요. Max·Team 에 딸려 오는 월 API 몫도 Console 조직을 구독에 연결해야 받아요. 어느 플랜에 얼마가 딸려 오는지는 구독과 API 를 견준 글에서 봐요.

키는 코드에 적지 말고 ANTHROPIC_API_KEY 환경변수에 넣어요. 공식 SDK 는 이 변수를 알아서 읽고, 직접 HTTP 로 부를 땐 Authorization: Bearer 헤더로 보내요(예전 x-api-key 헤더도 받아요).

아래 상자의 마지막 명령은 답을 만들지 않고 모델 목록만 받아 와요. 목록이 오면 키가 살아 있어요. 워크스페이스를 고르지 않은 개인·서비스 계정 키는 요청마다 워크스페이스 헤더가 필요해서, 이때 오는 400 은 키가 아니라 헤더 문제예요.

# macOS·Linux — zsh 는 ~/.zshrc, bash 는 ~/.bashrc 에 넣으면 새 터미널에서도 남아요
export ANTHROPIC_API_KEY="여기에_발급받은_키"

# Windows PowerShell — 넣은 뒤 새 터미널을 열어요
setx ANTHROPIC_API_KEY "여기에_발급받은_키"

# 키 확인(macOS·Linux 터미널) — 모델 목록만 받아 와요
# 워크스페이스를 고르지 않은 키는 마지막 줄 끝에 \ 를 붙이고 -H "anthropic-workspace-id: wrkspc_…" 줄을 더해요
curl https://api.anthropic.com/v1/models \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_API_KEY"

1. 1ANTHROPIC_API_KEY 를 넣은 터미널에서 claude 를 켜요.
2. 2처음 한 번 이 키를 쓸지 물어요. 고른 답을 기억해서, 거절했던 키는 다시 묻지 않아요. 나중에 바꾸려면 /config 의 「Use custom API key」를 켜고 꺼요.
3. 3/status 로 지금 어느 자격으로 붙었는지 봐요. 로그인과 키가 같이 있으면 안 쓰는 쪽에 표시가 붙어요.

오류 본문의 request_id 는 Anthropic 지원팀에 물을 때 함께 보내요.

Console 키는 Claude 모델만 불러요. Gemini·GPT 도 같이 쓰거나, 원화로 사서 견적서·세금계산서를 받아야 하면 원포트 AI 키를 만들어요.

모델을 정하지 않은 「원포트 AI API 크레딧」이나 제미나이 팩으로 산 크레딧은 모든 모델을 불러요. 클로드·GPT 팩으로 산 크레딧은 제미나이를 뺀 모든 모델을 불러요.

1. 1산 곳(스쿨오더·오피스오더)의 「AI API」 화면에서 「키 관리」로 가요. 쓰던 키가 없으면 산 뒤 메일로 「키 받기」 링크가 와요.
2. 2「새 키 발급」에 이름을 적고 「키 만들기」를 눌러요. 키는 sk-so- 로 시작해요.
3. 3만든 줄의 「한도 수정」에서 월·하루 사용 한도와 「이 날까지 사용」을 걸어요.
4. 4쓰던 Anthropic SDK 와 클로드 코드에 아래 변수를 넣어요. 주소 끝에 /v1 을 붙이지 않아요.

# Anthropic SDK · 직접 호출
ANTHROPIC_BASE_URL=https://oneport.kr
ANTHROPIC_API_KEY=sk-so-발급받은_원포트_키

# 클로드 코드
ANTHROPIC_BASE_URL=https://oneport.kr
ANTHROPIC_AUTH_TOKEN=sk-so-발급받은_원포트_키