OpenAI API 키 발급과 환경변수 설정 가이드 (2026)

한 줄 요약

ChatGPT만 쓰던 사람이 코드로 AI를 부르려면 openai api key가 필요하다. 발급은 platform.openai.com에서 5분이면 끝나고, 그다음 환경변수에 한 번만 저장하면 모든 프로젝트가 같은 키를 쓴다. 이 글은 발급부터 OS별 환경변수 설정, 자주 막히는 함정까지 한 번에 정리한다.

1. 키 발급이 왜 필요한가

chatgpt.com의 ChatGPT는 OpenAI 모델을 웹 UI로 쓰는 도구다. 코드에서 같은 모델을 부르려면 OpenAI API 플랫폼을 별도로 가입해 키를 발급받아야 한다. 두 서비스는 결제·요금·사용량이 완전히 분리되어 있다.

API는 토큰 단위 종량제다. 무료 트라이얼 크레딧이 신규 가입자에게 일부 제공되지만 금액·기간은 자주 바뀌므로 platform.openai.com의 Billing 페이지를 직접 확인하는 게 맞다. 사용 중인 ChatGPT Plus 구독이 있다고 API가 같이 쓰이지 않는다는 점이 한국 신규 사용자가 가장 자주 헷갈리는 부분이다.

2. 발급 5단계 흐름

실제 발급 절차는 다음 순서로 진행된다. 신규 계정이라면 1단계부터, 기존 API 사용자라면 3단계로 바로 진입한다.

1. 결제 수단 등록: platform.openai.com → Settings → Billing에서 카드 추가. 무료 크레딧만 쓸 거라도 결제 수단 등록을 요구하는 경우가 늘었다.
2. API 키 페이지 이동: 좌측 메뉴 "API keys" 또는 platform.openai.com/api-keys 직접 접속.
3. "+ Create new secret key" 클릭. 키는 생성 직후 한 번만 전체 표시된다.
4. 이름·프로젝트·권한(Permissions)을 설정. 보안상 키는 프로젝트별로 분리하고 필요한 권한만 부여하는 것이 권장된다.
5. 발급된 키를 복사해 환경변수 OPENAI_API_KEY에 저장. 이후 코드는 환경변수만 참조한다.

3. OS별 환경변수 설정

OS마다 영구 저장 방법이 다르다. 공통 원칙은 코드에 키를 직접 박지 않고 환경변수로만 두는 것이다.

Windows (PowerShell) — 영구 저장:

setx OPENAI_API_KEY "sk-proj-..."
# 새 셸에서 적용됨. 현재 셸에는 적용 안 됨

macOS / Linux (zsh / bash):

echo 'export OPENAI_API_KEY="sk-proj-..."' >> ~/.zshrc
source ~/.zshrc
# bash 사용자는 ~/.bashrc 또는 ~/.bash_profile

프로젝트 단위로 분리하고 싶다면 .env 파일과 python-dotenv 같은 라이브러리 조합이 가장 안전하다. .gitignore에 .env 추가는 필수.

4. 자주 막히는 함정 3가지

같은 키도 여러 환경에서 깨지는 포인트는 거의 이 세 가지다.

1. setx로 저장했는데 같은 셸에서 안 보인다: 정상 동작이다. setx는 새로 여는 셸부터 적용. 현재 셸은 $env:OPENAI_API_KEY = "..."(PowerShell) 또는 set OPENAI_API_KEY=...(cmd)로 임시 적용.
2. 크레딧 0인데 키만 발급: 결제 수단 등록 + 최소 결제(또는 잔여 크레딧) 없으면 API 호출 시 insufficient_quota 오류. Billing → Add credit balance에서 5달러부터 충전 가능.
3. 키 노출: GitHub에 실수로 푸시하면 봇이 즉시 스캔해 도용한다. 이미 푸시했다면 platform.openai.com에서 즉시 revoke + 새 키 재발급.

5. 보안 주의와 다음 단계

발급이 끝났다면 두 가지를 추가로 해두는 것이 나중에 사고를 막는다. 첫째, 월 사용량 한도를 Billing → Limits에서 설정. 가벼운 개인 프로젝트는 월 5~10달러 캡으로 시작. 둘째, 키를 프로젝트별로 분리 발급. 한 키가 노출돼도 다른 프로젝트는 영향받지 않는다.

키가 정상적으로 동작하는지 빠르게 확인하려면 curl https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY" 한 줄로 모델 목록을 받아 본다. 200 응답이 오면 모든 준비가 끝난 것이다.

함께 보면 좋은 글

• OpenAI Agents SDK 파이썬 5분 시작 가이드
• ChatGPT 프롬프트 작성법 5원칙 완벽 정리
• ChatGPT 커스텀 GPT 만드는 법 5분 완벽 가이드

참고 자료

• OpenAI API Keys 페이지
• OpenAI Platform Quickstart 공식 문서
• 키 노출 시 OpenAI 공식 가이드

---

작성자: AI·개발자 도구를 실무에서 쓰며 정리하는 블로그

최종 업데이트: 2026-04-22

주의: OpenAI 결제·UI는 자주 바뀐다. 화면 라벨 차이가 있다면 platform.openai.com 공식 문서의 최신 버전 확인.