LLM API 키 발급받기

1 Claude 키 발급받기

브라우저에서 platform.claude.com을 엽니다. 구글 계정으로 계속하기를 누르는 것이 가장 빠릅니다. 이메일로 가입하면 인증 번호를 받는 절차가 한 번 더 있습니다.

로그인하면 조직 이름을 정하라고 합니다. 혼자 쓴다면 본인 이름으로 두면 됩니다. 나중에 결제와 팀원 관리가 이 조직 단위로 묶입니다.

왼쪽 메뉴에서 API 키를 누릅니다. 처음이라면 키가 하나도 없는 빈 화면이 나옵니다. 오른쪽 위 키 생성 버튼이 출발점입니다. 왼쪽 메뉴에는 조직, 멤버, 워크스페이스, 결제, 사용량 제한, API 키가 차례로 있습니다. 지금 필요한 것은 API 키와 결제 둘입니다.

키 생성을 누르면 세 가지를 묻습니다.

1. 워크스페이스 — 키를 담아 둘 서랍입니다. 처음에는 Default 하나뿐이니 그대로 둡니다. 나중에 용도별로 서랍을 나누면 서랍마다 지출 한도를 따로 걸 수 있습니다.
2. 이름 — 이 키를 어디에 쓰는지 적습니다. 내-첫-실습처럼 나중에 봐도 알아볼 이름이 좋습니다. 반년 뒤 “이 키 지워도 되나”를 판단하는 근거가 이 이름 하나입니다.
3. 만료 — 기한이 지나면 키가 저절로 죽습니다. 이 항목은 만들 때만 정할 수 있고 나중에 바꿀 수 없습니다. 선택지는 3시간, 1일, 7일, 30일, 사용자 지정, 안 함 여섯 가지입니다. 원문에서 맨 아래 안 함이 붉은색인 이유는 그 선택이 가장 위험하기 때문입니다.

세 가지를 채우면 창 아래에 만료 시각이 문장으로 나옵니다. 확인하고 추가를 누릅니다. 원문 예시는 만료를 3시간으로 고르면 “이 API 키는 (날짜) 오전 1시 4분에 만료됩니다”처럼 정확한 시각을 알려 준다고 적혀 있습니다. 여러분의 시각은 고른 만료에 따라 달라집니다.

여기서 결제 창이 뜬다면 정상입니다. 크레딧 잔액이 0원이면 추가를 눌렀을 때 키가 만들어지는 대신 크레딧을 사라는 창이 먼저 뜹니다. Claude는 잔액이 없으면 키 자체를 만들 수 없습니다. 이것이 이 단계에서 가장 많이 당황하는 지점입니다.

금액은 20달러, 100달러, 500달러 중에서 고르거나 기타로 직접 넣습니다. 연습이 목적이라면 가장 작은 금액으로 충분합니다. 원문 화면에서 회색으로 덮인 부분은 청구지 주소와 카드 입력란입니다.

결제를 마치고 다시 키 생성을 하면 이번에는 키가 만들어지고, 키 문자열이 화면에 딱 한 번 나타납니다. 이때 반드시 복사해서 안전한 곳에 붙여 넣으세요. 창을 닫으면 다시는 볼 수 없고, 잃어버리면 새로 만드는 수밖에 없습니다. 보관 방법은 4단계에서 다룹니다.

결제 화면은 왼쪽 메뉴의 결제에서 언제든 다시 열 수 있습니다. 크레딧은 API, Claude Code, 워크벤치를 쓸 때 함께 줄어듭니다. 자동 재충전 임계값도 이 화면에서 정합니다.

워크스페이스를 나누면 사고가 작아집니다. 왼쪽 메뉴의 워크스페이스에서 서랍을 새로 만들 수 있습니다. 연습용 서랍에 작은 한도를 걸어 두면, 프로그램에 버그가 생겨 요청이 폭주해도 그 서랍의 한도까지만 손해가 납니다. 처음에는 Default 하나뿐입니다. 오른쪽 위 워크스페이스 생성으로 용도별 서랍을 추가합니다.

키를 받았으면 실제로 되는지 확인합니다. 터미널에 아래를 붙여 넣고, 첫 줄의 따옴표 안에만 여러분의 키를 넣으세요. 확인용으로는 가장 싼 모델인 claude-haiku-4-5를 썼습니다.

export ANTHROPIC_API_KEY="여기에_발급받은_키를_붙여넣기"

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕"}]}'

답변 문장이 섞인 JSON이 돌아오면 성공입니다.

사용량 제한이 궁금하다면 왼쪽 메뉴의 사용량 제한을 보세요. 모델별로 1분에 몇 번, 몇 토큰까지 보낼 수 있는지 표로 나옵니다. 처음에는 평가 티어에서 시작하고 쓴 금액이 쌓이면 자동으로 올라갑니다. 프로그램이 429 오류를 뱉으면 이 표의 숫자를 넘긴 것입니다. 표의 구체 숫자는 계정·시점에 따라 달라 [확인 필요]입니다.

2 GPT 키 발급받기

platform.openai.com에 접속합니다. ChatGPT를 쓰고 있었다면 같은 계정으로 그대로 로그인됩니다. 다만 ChatGPT 구독료와 API 요금은 별개이므로, 여기서 다시 결제를 등록해야 합니다.

왼쪽 메뉴에서 API Keys를 누릅니다. 오른쪽 위 Create new secret key가 출발점입니다. 왼쪽 위에 지금 선택된 프로젝트 이름이 뜹니다. 키를 만들기 전에 이 이름이 내가 원하는 프로젝트인지 반드시 확인하세요.

버튼을 누르면 네 가지를 묻습니다.

1. Owned by — You는 내 계정에 묶인 키입니다. 내가 조직에서 빠지면 이 키도 죽습니다. Service account는 사람이 아니라 프로그램 몫의 키라, 담당자가 회사를 떠나도 살아 있습니다. 혼자 연습할 때는 You로 둡니다.
2. Name — 선택 항목이지만 반드시 적으세요. 이름 없는 키가 세 개쯤 쌓이면 어느 것을 지워도 되는지 알 수 없게 됩니다.
3. Project — 이 키를 넣을 칸입니다. 요금이 이 칸으로 청구됩니다.
4. Permissions — All은 전부 허용, Restricted는 기능별로 골라서 허용, Read only는 읽기만 허용입니다. 연습은 All로 시작하고, 남에게 넘기거나 서버에 올릴 키는 필요한 것만 켜세요.

네 항목을 채우고 Create secret key를 누릅니다. 키가 만들어지면 Save your key 창이 뜹니다. 여기에 딱 한 번 키 전체가 보입니다. “다시 볼 수 없으니 안전한 곳에 저장하라”고 분명히 적혀 있습니다. Copy를 누르고 곧바로 안전한 곳에 붙여 넣으세요. Done을 누르기 전에 반드시 복사하세요. 이 창을 닫는 순간 키를 다시 보는 방법은 없습니다. 놓쳤다면 그 키는 지우고 새로 만드는 것이 유일한 해결책입니다.

다음은 결제입니다. 왼쪽 아래 Settings에서 Billing으로 들어갑니다. 결제 없이는 호출이 실패합니다. Add to credit balance로 충전합니다. 원문 화면 아래 주황색 띠는 자동 충전이 꺼져 있다는 안내입니다. 연습 단계에서는 꺼 둔 채로 두는 편이 안전합니다.

카드가 거절되면 국내 전용 카드일 가능성이 큽니다. 해외 결제가 되는 Visa 또는 Mastercard로 바꾸고, 카드사 앱에서 해외 온라인 결제가 막혀 있지 않은지 확인하세요. 우회로는 없습니다. 인터넷에서 파는 남의 키를 사면 계정이 정지될 수 있으니 쓰지 마세요.

export OPENAI_API_KEY="여기에_발급받은_키를_붙여넣기"

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","input":"안녕"}'

모델 이름 gpt-5.6-luna는 원문(2026년 8월 기준)에 적힌 확인용 값입니다. 콘솔에서 목록이 바뀌어 있으면 그 목록의 확인용 모델로 [확인 필요]입니다.

3 Gemini 키 발급받기

세 곳 중 가장 쉽습니다. 무료 한도가 있어 카드 없이 시작할 수 있습니다. aistudio.google.com/apikey에 구글 계정으로 접속합니다. 오른쪽 위 API 키 만들기가 출발점입니다. 왼쪽 메뉴의 비율 제한과 결제는 나중에 한도를 확인할 때 씁니다.

버튼을 누르면 이름과 프로젝트를 묻습니다. 처음이라면 기본 프로젝트가 이미 만들어져 있으니 그대로 두고 이름만 정하면 됩니다. 모든 Gemini 키는 반드시 어떤 구글 클라우드 프로젝트에 매달립니다. 요금과 권한이 그 프로젝트 단위로 관리됩니다.

키를 만들면 API 키 세부정보 창이 뜹니다. 여기에 키 값과 복사 버튼이 있습니다. 이 창은 나중에 목록에서 키를 눌러 다시 열 수 있습니다. 오른쪽 아래 키 복사로 가져가고, 필요 없어지면 왼쪽 아래 키 삭제로 없앱니다. 키 접두사 문자열은 원문에 없습니다. [확인 필요]

export GEMINI_API_KEY="여기에_발급받은_키를_붙여넣기"

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"안녕"}]}]}'

모델 이름 gemini-3.6-flash는 원문(2026년 8월 기준) 확인용 값입니다. 콘솔 목록이 바뀌면 [확인 필요]입니다.

새 키를 넣었는데 옛 키로 호출된다면 컴퓨터에 GOOGLE_API_KEY가 남아 있는 것입니다. 구글 라이브러리는 GEMINI_API_KEY와 GOOGLE_API_KEY 둘 다 읽는데, 둘 다 있으면 GOOGLE_API_KEY가 이깁니다. 옛 것을 지우고 하나만 남기세요.

4 키를 안전하게 보관하기

키를 받았으면 어디에 둘지가 다음 문제입니다. 가장 흔한 사고는 해킹이 아니라 실수로 인터넷에 올리는 것입니다. 깃허브에 코드를 올렸는데 그 안에 키가 들어 있는 경우가 압도적으로 많습니다. 자동으로 훑는 프로그램이 몇 분 만에 찾아냅니다.

macOS 또는 리눅스에 저장하기

# 셸 설정 파일 끝에 한 줄 추가
echo 'export ANTHROPIC_API_KEY="여러분의_키"' >> ~/.zshrc

# 새로 연 터미널부터 적용됩니다. 지금 적용하려면
source ~/.zshrc

# 잘 들어갔는지 확인
echo $ANTHROPIC_API_KEY

Windows에 저장하기 (PowerShell)

# 사용자 환경변수로 영구 저장
setx ANTHROPIC_API_KEY "여러분의_키"

# PowerShell 창을 새로 연 뒤 확인
echo $env:ANTHROPIC_API_KEY

프로젝트별로 두려면 .env 파일

# .env 파일 내용
ANTHROPIC_API_KEY=여러분의_키
OPENAI_API_KEY=여러분의_키
GEMINI_API_KEY=여러분의_키

# .gitignore 파일에 이 줄이 반드시 있어야 합니다
.env

이름을 정확히 맞추세요. 각 회사의 공식 라이브러리는 정해진 이름의 환경변수를 저절로 찾습니다. Claude는 ANTHROPIC_API_KEY, OpenAI는 OPENAI_API_KEY, Gemini는 GEMINI_API_KEY입니다.

키가 새어 나갔다고 의심되면 순서가 있습니다. 먼저 콘솔에서 그 키를 삭제(폐기)합니다. 그다음 새 키를 만들고, 마지막으로 사용 내역에 이상한 호출이 없었는지 확인합니다. 새 키부터 만들고 옛 키를 방치하면 도둑이 계속 쓸 수 있습니다. 삭제가 먼저입니다.

5 요금 사고 막기

API 요금은 쓴 만큼 나갑니다. 평소에는 몇백 원 수준이지만, 프로그램이 무한 반복에 빠지면 하룻밤에 수십만 원이 나갈 수 있습니다. 세 가지만 해 두면 대부분 막힙니다.

1. 자동 충전을 끕니다 — 잔액이 떨어지면 자동으로 결제되는 기능입니다. 켜져 있으면 사고가 나도 멈추지 않고 계속 돈이 들어갑니다. 연습 단계에서는 꺼 두세요. 잔액이 바닥나면 프로그램이 멈추는데, 그 멈춤이 안전장치입니다.
2. 월 상한과 알림을 겁니다 — Claude는 사용량 제한, OpenAI는 Limits 화면에서 정합니다. 정해 둔 금액에 닿으면 메일이 오고 호출이 막힙니다. Gemini 쪽 월 상한 화면의 정확한 라벨은 원문에 없습니다. [확인 필요]
3. 연습용 키를 따로 씁니다 — Claude는 워크스페이스, OpenAI는 프로젝트로 칸을 나눕니다. 실습용 칸에 작은 한도를 걸어 두면 손해가 그 칸을 넘지 않습니다.