클로드 코드 API 키 발급 방법: 콘솔에서 만들고 연결하기

클로드 코드(Claude Code)에서 쓸 API 키를 발급받으려면 Claude 콘솔(Console)에 접속해 계정 설정의 API Keys 화면에서 새 키를 만든 다음, 그 키를 환경 변수(environment variable — 터미널이 기억해 두는 값)로 등록해 클로드 코드에 연결하면 됩니다. 이 글은 콘솔 접속부터 실제 연결 확인까지 그대로 따라 할 수 있도록 순서대로 안내하며, 예상 소요 시간은 10분 안팎입니다.

이 글로 할 수 있게 되는 것

이 글을 따라 하면 클로드 코드에서 바로 쓸 수 있는 API 키를 직접 발급받고, 터미널에 연결해 로그인 없이 클로드 코드를 실행하는 상태까지 만들 수 있습니다. 콘솔 가입, 키 생성, 환경 변수 등록, 연결 확인까지 전체 과정에 걸리는 시간은 대략 10분입니다.

시작 전 준비물

시작하기 전에 아래 항목을 미리 확인해 두면 중간에 막히지 않습니다.

• 이메일로 가입할 수 있는 Claude 계정 (아직 없다면 콘솔 접속 화면에서 바로 가입 가능)
• 터미널(명령줄 창)을 열 수 있는 컴퓨터 — macOS, Linux, WSL, 또는 Windows
• 클로드 코드 CLI(명령줄 도구)를 아직 설치하지 않았다면 설치할 준비 — 방법은 아래 단계에서 안내합니다
• 기존에 쓰던 Claude Pro·Max 구독이 없어도 괜찮습니다. API 키는 구독과 별개로 단독 발급·사용이 가능합니다

용어 빠른 풀이

• API(Application Programming Interface) — 프로그램끼리 정해진 규칙대로 데이터를 주고받게 해 주는 접점입니다.
• API 키 — 요청을 보낼 때마다 함께 제출하는, 나를 증명하는 비밀 문자열입니다. 비밀번호처럼 다른 사람에게 노출되면 안 됩니다.
• 콘솔(Console) — API 키 발급, 사용량·한도 확인 등을 관리하는 웹 화면입니다. 이 글에서는 platform.claude.com 주소로 안내하며, 같은 계정 체계를 console.anthropic.com 이라는 이름으로도 접할 수 있습니다.
• 환경 변수(environment variable) — 터미널에 저장해 두면 여러 프로그램이 공통으로 참조할 수 있는 값입니다. API 키를 코드에 직접 적지 않고 환경 변수로 두는 것이 안전합니다.
• CLI(Command Line Interface) — 마우스 클릭 대신 명령어를 입력해 조작하는 도구입니다. 클로드 코드의 터미널 실행 프로그램이 여기에 해당합니다.

단계별로 API 키 발급하고 연결하기

1. Claude 콘솔 접속 및 로그인 — 브라우저에서 platform.claude.com에 접속해 이메일로 가입하거나 로그인합니다. 이렇게 보이면 성공: 콘솔 대시보드 화면으로 이동합니다.
2. 계정 설정의 API Keys 화면으로 이동 — 콘솔의 Account Settings 안에서 API Keys 메뉴를 찾아 들어갑니다(경로: platform.claude.com/settings/keys). 메뉴 위치나 정확한 버튼 이름은 화면 업데이트에 따라 조금씩 달라질 수 있으니, 눈에 보이는 "키 만들기"류 버튼을 클릭하면 됩니다.

   플랫폼 주소: platform.claude.com/settings/keys

   이렇게 보이면 성공: 기존에 만든 키 목록(처음이면 빈 목록)이 보이는 화면이 뜹니다.
3. 새 키 생성 — 키를 만드는 버튼을 눌러 이름을 정하고, 키의 만료 기간(expiration)을 함께 선택합니다. 만료 기간은 키를 만들 때 직접 고르는 항목이므로, 용도에 맞게 설정합니다. 이렇게 보이면 성공: 새 키가 화면에 문자열 전체로 한 번 표시됩니다.
4. 키 복사 및 안전하게 보관 — 화면에 표시된 키 문자열 전체를 지금 바로 복사해 비밀번호 관리자 등 안전한 곳에 저장합니다. 주의: 이 화면을 벗어나면 키 전체를 다시 확인하지 못할 수 있으니, 반드시 지금 복사해 두세요.
5. 터미널에 환경 변수로 등록 — 터미널을 열고 아래 명령어의 따옴표 안을 방금 복사한 키로 바꿔 입력합니다(macOS·Linux 기준).

   export ANTHROPIC_API_KEY="발급받은-키-붙여넣기"

   이렇게 보이면 성공: 같은 터미널 창에서 echo $ANTHROPIC_API_KEY를 입력했을 때 방금 등록한 키 문자열이 그대로 출력됩니다.
6. 클로드 코드 설치(아직 없다면) 후 실행 — 운영체제에 맞는 명령어로 설치한 뒤, 프로젝트 폴더로 이동해 claude를 실행합니다.

   운영체제·설치 방법	설치 명령어
   macOS·Linux·WSL	curl -fsSL https://claude.ai/install.sh | bash
   Windows PowerShell	irm https://claude.ai/install.ps1 | iex
   Windows CMD	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   Homebrew(macOS)	brew install --cask claude-code
   WinGet(Windows)	winget install Anthropic.ClaudeCode

   설치 후 실행:

   cd 내-프로젝트-경로
   claude

   이렇게 보이면 성공: 환경 변수에 ANTHROPIC_API_KEY가 설정돼 있으면 클로드 코드가 별도 로그인 화면 대신 방금 등록한 키를 승인(approve)할지 물어봅니다. 승인하면 바로 클로드 코드 프롬프트가 뜨고 질문을 입력할 수 있습니다.

구독 로그인과 API 키, 무엇이 다른가요

클로드 코드는 Claude 구독(Pro·Max) 로그인과 API 키 두 가지 방식으로 인증할 수 있으며, 둘 중 하나만 있으면 됩니다. 평소 터미널에서 개인적으로 쓴다면 구독 로그인만으로 충분하고, 자동화·CI/CD(코드가 자동으로 빌드·테스트되는 파이프라인)나 여러 서비스에 연동하려면 API 키가 필요합니다.

자주 막히는 지점과 해결법

설치와 연결 과정에서 자주 발생하는 문제는 대부분 운영체제 콘솔 종류 착각이나 환경 변수 미등록에서 비롯됩니다.

• Windows에서 설치 명령어가 실행되지 않을 때 — The token '&&' is not a valid statement separator 오류가 뜨면 PowerShell 창에 CMD용 명령어를 넣은 것입니다. 반대로 'irm' is not recognized as an internal or external command이 뜨면 CMD 창에 PowerShell용 명령어를 넣은 것입니다. 프롬프트가 PS C:\로 시작하면 PowerShell, C:\만 있으면 CMD이니 이를 보고 맞는 명령어를 다시 입력하세요.
• claude 실행 시 로그인 화면이 계속 뜰 때 — 환경 변수가 지금 열려 있는 터미널 세션에 등록되지 않은 경우입니다. echo $ANTHROPIC_API_KEY(macOS·Linux) 또는 파워쉘에서 $env:ANTHROPIC_API_KEY를 입력해 값이 비어 있는지 확인하고, 비어 있다면 5단계의 export 명령을 다시 실행하세요. 새 터미널 창을 열면 등록이 초기화되므로 그때마다 다시 설정해야 합니다.
• API 호출 시 인증 오류가 날 때 — 키를 복사하는 과정에서 앞뒤에 공백이 섞였거나, 다른 조직·워크스페이스에서 만든 키를 잘못 붙여넣은 경우가 흔합니다. 콘솔의 API Keys 화면에서 키를 다시 확인하고, 필요하면 새 키를 발급해 처음부터 다시 복사·등록하세요.

응용: 발급한 키로 할 수 있는 다음 단계

같은 API 키로 클로드 코드뿐 아니라 Messages API를 직접 호출하는 나만의 프로그램도 만들 수 있습니다. 예를 들어 아래처럼 터미널에서 curl 명령으로 직접 호출해 볼 수 있습니다.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "안녕하세요, 잘 작동하나요?"}
    ]
  }'

키를 여러 프로젝트에서 나눠 쓰고 싶다면 콘솔의 Workspaces 기능으로 키를 용도별로 묶어 관리할 수 있고, 현재 조직의 요청 한도(분당 요청 수·분당 토큰 수·월 지출 한도)는 콘솔의 Limits 화면에서 확인할 수 있습니다. 한도가 부족하면 같은 화면에서 한도 상향을 요청할 수 있습니다. 더 다양한 클로드 코드 활용법은 가이드 카테고리에서 이어서 확인해 보세요.

자주 묻는 질문

Q. 클로드 코드를 쓰려면 API 키가 꼭 필요한가요?
아니요, 꼭 필요하지는 않습니다. 개인이 터미널에서 클로드 코드를 쓴다면 Claude 구독(Pro·Max) 계정으로 로그인만 해도 충분하며, API 키는 자동화나 CI/CD처럼 종량제 인증이 필요할 때 발급받으면 됩니다.

Q. 발급받은 API 키를 나중에 다시 확인할 수 있나요?
콘솔의 API Keys 화면에서 키 목록 자체는 계속 확인할 수 있지만, 키 문자열 전체는 생성 직후에만 표시되는 경우가 많습니다. 화면을 벗어나기 전에 반드시 복사해 안전한 곳에 저장해 두세요.

Q. API 사용 요금은 구독 요금제와 별개인가요?
네, 별개입니다. API는 사용한 토큰 수만큼 과금되는 종량제이고, Claude Pro·Max 같은 월 정액 구독과는 요금 체계가 다릅니다. 정확한 모델별 단가는 변동될 수 있으니 공식 요금 페이지에서 최신 값을 확인하세요.

Q. 발급한 키의 사용량 한도는 어디서 확인하나요?
콘솔의 Limits 화면에서 현재 조직의 분당 요청 수(RPM), 분당 토큰 수(TPM), 월 지출 한도를 확인할 수 있고, 더 높은 한도가 필요하면 같은 화면에서 상향을 요청할 수 있습니다.

관련 글

• Claude API 키 발급·요금·사용법 완전정리 (2026)
• Claude API 시작하기: 첫 호출까지 (개발자 입문)
• Claude API 에러 처리·재시도·rate limit 완전 가이드
• Claude API 비전 — 이미지·PDF 입력 처리 방법
• Claude API 무료로 쓸 수 있을까? — 무료 크레딧·무료 대안·비용 구조 (2026)