🚀 FDE · 온보딩 · 개발 · L03

AI API 키 발급

작성일자 2026-07-24 · 수정일자 2026-07-24 · 강의차수 L03 · 예상소요 10분

목표 이 강의가 끝나면 학습자가 keyforge 에서 AI API 키를 발급받아 .env 에 넣을 수 있다.

1. 무엇을 하나

AI 를 쓰려면 API 키(AI 를 쓸 수 있게 해 주는 비밀 열쇠)가 필요합니다. 이 키는 회사 도구 keyforge 에서 직접 발급받습니다. 발급받은 키를 복사해서, 다음 강의에서 쓰도록 프로젝트의 .env 에 넣는 것까지 합니다.

브라우저에서 아래 주소로 들어갑니다.

https://keyforge-dev.popupstudio.ai

각 그림에서 빨간 네모가 누를 곳입니다.

2. 로그인

Google 계정으로 계속하기 를 눌러, 회사에서 안내한 Google 계정으로 로그인합니다. (다음 화면에서 회사 계정을 고르고 허용을 누르면 됩니다.)

keyforge 로그인 화면: 'Google 계정으로 계속하기' 로 로그인

3. 새 키 발급 시작

로그인하면 API 키 관리 화면이 나옵니다. 오른쪽 위의 +새 키 발급 을 누릅니다.

대시보드: 오른쪽 위 '+새 키 발급' 버튼

4. 키 만들기

작은 창이 열립니다. 여기서 세 가지를 합니다.

① 발급할 AI 플랫폼을 체크합니다. 지금은 OpenAI 와 LangSmith 두 개만 체크하세요. (OpenAI 는 AI 처리에, LangSmith 는 AI 가 잘 도는지 기록·확인하는 데 씁니다.) 아래 그림에는 네 개가 다 체크돼 있는데, 그건 나중에 여러 플랫폼이 필요할 때의 예시입니다. 앞으로는 그림처럼 필요한 것을 골라 체크하면 되고, 지금은 두 개면 충분합니다.

플랫폼 선택 (그림은 네 개 모두 체크한 예시)

② 프로젝트 이름을 정해 입력합니다. (영문·숫자와 _ - 만 됩니다. 예: my_project1)

프로젝트 이름 입력

③ 아래쪽 발급 을 누릅니다.

발급 버튼

5. 키 복사

발급되면 아래 목록에 체크한 플랫폼마다 한 줄씩 키가 나타납니다. (그림은 네 개를 다 발급한 예시라 Anthropic 은 승인이 필요해 대기 로, 나머지는 활성 으로 보입니다. 지금 두 개만 체크했다면 OpenAI·LangSmith 두 줄만 나옵니다.) 활성 키 줄에는 아래 세 가지 버튼이 있습니다(그림의 빨간 네모).

복사: 그 줄의 키를 복사합니다.
값 보기: 가려진 키 전체를 화면에 보여 줍니다(확인용, 눌러도 됩니다).
폐기: 키를 못 쓰게 만듭니다(무효화). 누르지 마세요.

발급한 두 키를 다음 단계에서 .env 에 넣습니다. OpenAI 줄의 복사 와 LangSmith 줄의 복사 를 씁니다. 한 번에 하나씩 복사해서 넣고, 다시 와서 다음 키를 복사하면 됩니다.

발급된 키 목록 (그림은 네 개 발급 예시), 각 줄에 복사·값 보기·폐기

6. `.env` 에 넣기

복사한 키를 프로젝트의 .env 에 붙여넣습니다. (VS Code 에서 합니다.)

VS Code 에서 프로젝트를 엽니다: File(파일) → Open Folder(폴더 열기) 로 홈 폴더 안의 my_project 를 선택합니다.
왼쪽 파일 목록에서 src 폴더를 펼치고 .env 를 클릭해 엽니다.
.env 안에는 아래 같은 줄들이 있습니다. 각 키를 ← 로 표시한 줄의 = 바로 뒤에 붙여넣습니다. (앞뒤 줄을 보고 위치를 찾으세요. 발급 안 한 플랫폼 줄은 비워 둡니다.)

# OpenAI API Settings
OPENAI_API_KEY=              # ← OpenAI 키를 여기에 (실습 필수)
OPENAI_MODEL=gpt-4o-mini
OPENAI_TEMPERATURE=0.1

# Anthropic (Claude) Configuration
ANTHROPIC_API_KEY=           # ← Anthropic 키를 여기에 (관리자 승인 후)
ANTHROPIC_MODEL=claude-sonnet-4-20250514

# Google Gemini Configuration
GOOGLE_API_KEY=              # ← Gemini 키를 여기에
GOOGLE_MODEL=gemini-2.5-flash

# LangSmith (optional)
LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
LANGCHAIN_API_KEY=           # ← LangSmith 키를 여기에
LANGCHAIN_PROJECT=my_project

저장합니다(Windows Ctrl+S / macOS ⌘+S).

키는 .env 에만 두고 코드에 직접 쓰지 않습니다. .env 는 GitHub 에 올라가지 않아 키가 새지 않습니다.

마무리

핵심 정리: keyforge 에서 OpenAI · LangSmith 키를 발급받아, src/.env 의 OPENAI_API_KEY 와 LANGCHAIN_API_KEY 에 각각 넣었습니다.
주의 사항: 키를 .env 에 안 넣거나 앞뒤에 빈칸·오타가 있으면 다음 강의에서 AI 호출이 실패합니다.
다음 시간: 만든 기능에 AI Agent 연동.

이 강의를 학습하셨나요?