시작하기 전에 준비할 것
- 1이메일 계정 구글 계정이 있으면 세 곳 모두 그 계정으로 로그인할 수 있어 가장 편합니다.
- 2휴대폰 문자 인증에 씁니다. Claude와 OpenAI는 가입 과정에서 번호를 확인합니다.
- 3해외 결제가 되는 카드 Visa 또는 Mastercard를 권합니다. Claude와 OpenAI는 결제 없이는 키를 쓸 수 없습니다. 국내 전용 카드는 자주 거절됩니다.
- 4카드가 아직 없다면 Gemini부터 Google Gemini에는 무료 사용 한도가 있어 결제 등록 없이 오늘 바로 시작할 수 있습니다. 3단계로 건너뛰세요.
| 비교 항목 | Claude (Anthropic) | GPT (OpenAI) | Gemini (Google) |
|---|---|---|---|
| 콘솔 주소 | platform.claude.com | platform.openai.com | aistudio.google.com |
| 무료로 호출 | 불가 크레딧 충전 필요 | 불가 크레딧 충전 필요 | 가능 무료 한도 있음 |
| 만료일 지정 | 가능 3시간부터 선택 | 불가, 직접 폐기 | 불가, 직접 폐기 |
| 신분증 인증 | 불필요 | 최신 모델은 필요 | 불필요 |
| 가장 자주 막히는 곳 | 크레딧을 안 사면 키를 못 만듭니다 | 국내 카드가 거절됩니다 | 옛날 키가 곧 차단됩니다 |
지금 쓸 회사 하나만 고르고 그 단계만 하세요. 한 곳당 10분입니다. 무엇을 쓸지 아직 모르겠거나 카드가 없으면 3단계 Gemini로 가세요. 무료 한도가 있어 오늘 바로 됩니다.
Claude 키 발급받기
브라우저에서 platform.claude.com을 엽니다. 구글 계정으로 계속하기를 누르는 것이 가장 빠릅니다. 이메일로 가입하면 인증 번호를 받는 절차가 한 번 더 있습니다.
platform.claude.com입니다. Claude Pro를 구독 중이어도 이 콘솔에서는 잔액이 0으로 시작합니다.로그인하면 조직 이름을 정하라고 합니다. 혼자 쓴다면 본인 이름으로 두면 됩니다. 나중에 결제와 팀원 관리가 이 조직 단위로 묶입니다.
왼쪽 메뉴에서 API 키를 누릅니다. 처음이라면 키가 하나도 없는 빈 화면이 나옵니다. 오른쪽 위 키 생성 버튼이 출발점입니다.
키 생성을 누르면 세 가지를 묻습니다. 워크스페이스, 이름, 만료입니다.
내-첫-실습처럼 나중에 봐도 알아볼 이름이 좋습니다. 반년 뒤 "이 키 지워도 되나"를 판단하는 근거가 이 이름 하나입니다.
만료를 얼마로 잡아야 하나
연습용이라면 3시간이나 1일로 잡으세요. 실수로 키를 인터넷에 올려도 몇 시간 뒤에는 쓸모없는 문자열이 됩니다. 강의나 워크숍에서 여러 사람이 만지는 키도 행사 기간에 맞춰 짧게 잡습니다.
안 함은 서버에서 계속 돌아가는 프로그램에만 씁니다. 이 경우 키가 영원히 살아 있으므로 유출되면 알아서 멈추는 안전장치가 없습니다. 대신 사람이 주기적으로 새 키로 갈아 줘야 합니다.
세 가지를 채우면 창 아래에 만료 시각이 문장으로 나옵니다. 확인하고 추가를 누릅니다.
결제를 마치고 다시 키 생성을 하면 이번에는 키가 만들어지고, 키 문자열이 화면에 딱 한 번 나타납니다. 이때 반드시 복사해서 안전한 곳에 붙여 넣으세요. 창을 닫으면 다시는 볼 수 없고, 잃어버리면 새로 만드는 수밖에 없습니다. 보관 방법은 4단계에서 다룹니다.
결제 화면은 왼쪽 메뉴의 결제에서 언제든 다시 열 수 있습니다.
키를 받았으면 실제로 되는지 확인합니다. 터미널에 아래를 붙여 넣고, 첫 줄의 따옴표 안에만 여러분의 키를 넣으세요.
동작 확인 (터미널)
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이 돌아오면 성공입니다. 확인용으로는 가장 싼 모델인 claude-haiku-4-5를 썼습니다.
- 키 문자열이
sk-ant-api03-로 시작한다. - 위 curl 명령이 오류 없이 답변을 돌려준다.
- 키를 메모장이 아니라 안전한 곳에 적어 두었다(4단계에서 정리합니다).
GPT 키 발급받기
platform.openai.com에 접속합니다. ChatGPT를 쓰고 있었다면 같은 계정으로 그대로 로그인됩니다. 다만 ChatGPT 구독료와 API 요금은 별개이므로, 여기서 다시 결제를 등록해야 합니다.
왼쪽 메뉴에서 API Keys를 누릅니다. 오른쪽 위 Create new secret key가 출발점입니다.
버튼을 누르면 네 가지를 묻습니다.
키가 만들어지면 Save your key 창이 뜹니다. 여기에 딱 한 번 키 전체가 보입니다.
다음은 결제입니다. 왼쪽 아래 Settings에서 Billing으로 들어갑니다. 결제 없이는 호출이 실패합니다.
최신 모델을 쓰려면 신분증 인증이 필요합니다
가장 성능이 높은 모델은 인증된 조직만 쓸 수 있습니다. Settings의 General 화면 아래쪽 Verifications에서 진행합니다. 혼자 개발한다면 Individual, 사업자라면 Business의 Start를 누릅니다.
여권이나 운전면허증 같은 정부 발행 신분증과 얼굴 확인이 필요합니다. 신분증 하나로는 90일에 조직 하나만 인증할 수 있으니, 조직을 여러 개 운영한다면 어디에 쓸지 먼저 정하세요. 인증 후 권한이 퍼지는 데 최대 15분 걸립니다.
동작 확인 (터미널)
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":"안녕"}'
- 키 문자열이
sk-proj-로 시작한다. - Billing 화면에 잔액이 0보다 크다.
- 위 curl 명령이 답변을 돌려준다.
Gemini 키 발급받기
세 곳 중 가장 쉽습니다. 무료 한도가 있어 카드 없이 시작할 수 있습니다. aistudio.google.com/apikey에 구글 계정으로 접속합니다.
버튼을 누르면 이름과 프로젝트를 묻습니다. 처음이라면 기본 프로젝트가 이미 만들어져 있으니 그대로 두고 이름만 정하면 됩니다.
키를 만들면 API 키 세부정보 창이 뜹니다. 여기에 키 값과 복사 버튼이 있습니다. 이 창은 나중에 목록에서 키를 눌러 다시 열 수 있습니다.
무료 한도는 어디까지인가
결제를 등록하지 않아도 1분당 요청 수와 토큰 수 안에서는 무료로 쓸 수 있습니다. 연습과 시제품 만들기에는 대체로 충분합니다. 한도를 넘기면 요청이 거부될 뿐, 저절로 돈이 나가지는 않습니다.
다만 무료 구간에서는 보낸 내용이 모델 개선에 쓰일 수 있습니다. 고객 데이터나 공개하면 안 되는 원고를 무료 한도로 보내지 마세요. 이 한 줄이 무료로 쓸지 말지를 가르는 실질 기준입니다. 결제 계정을 연결하면 유료 등급으로 올라가면서 한도도 함께 올라갑니다.
동작 확인 (터미널)
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":"안녕"}]}]}'
GOOGLE_API_KEY가 남아 있는 것입니다. 구글 라이브러리는 GEMINI_API_KEY와 GOOGLE_API_KEY 둘 다 읽는데, 둘 다 있으면 GOOGLE_API_KEY가 이깁니다. 옛 것을 지우고 하나만 남기세요.- 키를 복사해 두었다.
- 위 curl 명령이 답변을 돌려준다.
- 예전에 만든 Gemini 키가 있다면 새 키로 갈아 끼웠다.
키를 안전하게 보관하기
키를 받았으면 어디에 둘지가 다음 문제입니다. 가장 흔한 사고는 해킹이 아니라 실수로 인터넷에 올리는 것입니다. 깃허브에 코드를 올렸는데 그 안에 키가 들어 있는 경우가 압도적으로 많습니다. 자동으로 훑는 프로그램이 몇 분 만에 찾아냅니다.
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
ANTHROPIC_API_KEY, OpenAI는 OPENAI_API_KEY, Gemini는 GEMINI_API_KEY입니다. 이 이름으로 저장해 두면 코드에서 키를 언급할 필요조차 없어집니다.터미널을 새로 열어 echo $ANTHROPIC_API_KEY를 쳤을 때 키가 나오고, 프로젝트 폴더의 .gitignore에 .env가 적혀 있으면 됩니다.
요금 사고 막기
API 요금은 쓴 만큼 나갑니다. 평소에는 몇백 원 수준이지만, 프로그램이 무한 반복에 빠지면 하룻밤에 수십만 원이 나갈 수 있습니다. 세 가지만 해 두면 대부분 막힙니다.
- 자동 충전이 의도한 상태다(연습 중이라면 꺼짐).
- 월 상한과 알림 금액을 정해 두었다.
- 키 이름만 보고도 어디에 쓰는 키인지 알 수 있다.
자주 막히는 곳
401 오류가 납니다
대부분 키 문자열 문제입니다. 복사할 때 앞뒤에 공백이나 줄바꿈이 딸려 오지 않았는지 보세요. Claude에서 만료를 짧게 잡았다면 이미 기한이 지났을 수도 있습니다. 만료된 키는 되살릴 수 없고 새로 만들어야 합니다.
카드가 계속 거절됩니다
국내 전용 카드는 대부분 막힙니다. 해외 결제가 가능한 Visa 또는 Mastercard를 쓰고, 카드사 앱에서 해외 온라인 결제 차단이 걸려 있지 않은지 확인하세요. 일부 체크카드나 가상 카드도 거절됩니다.
키를 만들려는데 결제 창이 뜹니다
Claude에서 잔액이 0일 때 나오는 정상 동작입니다. 크레딧을 사야 키를 만들 수 있습니다. 돈을 쓰지 않고 먼저 연습하고 싶다면 무료 한도가 있는 Gemini로 시작하세요.
키를 복사하기 전에 창을 닫았습니다
다시 볼 방법은 없습니다. 그 키는 콘솔에서 지우고 새로 만드세요. 셋 다 같습니다.
실수로 깃허브에 키를 올렸습니다
커밋을 되돌려도 소용없습니다. 올라간 순간 이미 노출된 것으로 봐야 합니다. 먼저 콘솔에서 그 키를 지우고, 새 키를 만든 뒤, 사용 내역에 낯선 호출이 없는지 확인하세요.
최종 점검표
여기까지 다 되면 끝난 것입니다
- 세 곳의 키를 받았거나, 지금 필요한 곳의 키를 받았다.
- 각 키로 curl 명령을 실행해 답변이 돌아오는 것을 확인했다.
- 키를 코드가 아니라 환경변수나 .env 파일에 넣었다.
.gitignore에.env가 적혀 있다.- 자동 충전이 의도한 상태이고, 월 상한과 알림을 걸어 두었다.
- 키 이름만 봐도 어디에 쓰는 키인지 알 수 있다.
- Gemini 키가 새 방식으로 만든 키다.