byteforce

CPN 한국어 자습서 · 러닝패스 2 / 4 — Building with the Claude API

API로 Claude에 접근하기

API 키 발급받기

Getting an API key

다음 장에서 API로 첫 요청을 보내려면 비밀 API 키가 필요합니다. 이 장에서는 Anthropic 콘솔에서 키를 발급받는 과정을 단계별로 따라가고, 키를 안전하게 다루는 법을 정리합니다. (이 레슨은 영상이 아닌 단계별 가이드입니다.)

이 장에서 배우는 것What you'll learn

약 3분
1

Anthropic 콘솔(console.anthropic.com) 접속하기

2

[Get API Key] → [Create Key]로 키 생성

3

workspace와 키 이름 설정하기

4

키는 한 번만 표시 — 복사해 안전하게 보관하기

먼저, 이 장에 나오는 용어
API 키 (API key)
Anthropic API 요청을 인증하는 비밀 문자열입니다. 비밀번호처럼 다뤄야 합니다.
콘솔 (Anthropic Console)
console.anthropic.com. 키 발급과 사용량 관리 등을 하는 웹 대시보드입니다.
workspace
콘솔에서 키와 사용량을 묶어 관리하는 단위입니다. 기본값은 ‘Default’입니다.
환경 변수 (environment variable)
키 같은 비밀 값을 코드 밖에 두고 불러오는 방법입니다. (예: ANTHROPIC_API_KEY)

콘솔에서 키 발급하기

Create your key

키 발급은 다섯 단계입니다. 아래에서 단계를 눌러 콘솔 화면을 따라가 보세요.

콘솔에서 키 발급하기 · 단계를 눌러 따라가기
console.anthropic.com/dashboard

Good afternoon

키를 안전하게 다루기

Keep your key safe

API 키는 비밀번호와 같습니다. 다음을 지켜 주세요.

보안 수칙
  • 키를 클라이언트 앱 코드나 공개 저장소(GitHub 등)에 넣지 마세요. 노출되면 누구나 무단으로 쓸 수 있습니다.
  • 키는 발급 시 한 번만 표시됩니다. 창을 닫았다면 다시 볼 수 없으니, 옛 키를 삭제하고 새로 발급하세요.
  • 환경 변수(ANTHROPIC_API_KEY)에 보관하고, 코드에서는 변수로 불러옵니다.
  • 키가 유출되면 콘솔에서 즉시 폐기(delete)하고 새로 발급하세요.
키를 환경 변수로 보관 · 코드엔 직접 쓰지 않기
# 1) 발급한 키를 환경 변수로 저장 (터미널)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# 2) 코드에서는 키를 직접 쓰지 않습니다.
#    Anthropic 클라이언트가 환경 변수에서 자동으로 읽습니다.
from anthropic import Anthropic
client = Anthropic()   # ANTHROPIC_API_KEY 를 자동으로 사용
연결

앞 장에서 본 것처럼, 비밀 키는 서버에서만 다루고 클라이언트에 노출하지 않습니다. 환경 변수는 그 비밀 값을 코드와 분리해 두는 표준 방법입니다.

스스로 점검

Check yourself

정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.

Q1API 키가 처음 표시될 때 해야 할 일은?

Q2API 키를 두면 안 되는 곳은?

Q3키 발급 창을 실수로 닫았다면?