📖 한국경영교육연구소 AI ACADEMY · 용어·통역 사전
환경변수 (.env) (environment variable)
💬 쉬운 뜻
API 키·비밀번호 같은 ‘비밀 값’을 코드 안에 직접 적지 않고, 코드 밖 별도 금고 파일(보통 .env)에 따로 빼서 보관하는 방법이에요. 식당 비법 양념 레시피를 메뉴판에 적어 손님에게 보여주지 않고 주방 금고에만 넣어두는 것과 같아요. 코드(메뉴판)는 남에게 보여주거나 깃허브에 올려도, 비밀(.env 금고)은 빼고 올리니 안전하죠. 코드에선 “금고에서 그 값 꺼내 와”라고만 적어요.
🧭 이 상황에서
외부 서비스(AI·문자발송·결제·지도) 키를 받아 쓸 때 꼭 만나는 말이에요. 키를 코드에 그냥 적으면 깃허브에 올리는 순간 전 세계에 비밀이 공개돼 도용·요금폭탄으로 이어져요. 그래서 키는 .env라는 금고 파일에 넣고, 그 파일은 ‘올리지 않기 목록(.gitignore)’에 넣어 새어나가지 않게 해요.
⌨️ 이럴 땐 이렇게 입력
- 지금 코드에 API 키가 그대로 적혀 있어. 이걸 .env 환경변수로 빼고, 코드에서는 그 값을 불러 쓰도록 바꿔줘.
- .env 파일이 깃허브에 안 올라가게 .gitignore에 넣어주고, 대신 키 없이 빈 칸만 있는 예시 파일(.env.example)도 만들어줘.
- 이 키를 화면(클라이언트)이 아니라 서버에서만 .env로 읽어 쓰게 해줘.
🔮 AI가 이렇게 답하면 = 이런 뜻
AI가 “키를 환경변수(.env)로 분리하고 코드에서는 process.env로 읽게 했다”고 하면 = 비밀 값을 코드 밖 금고에 빼두고, 코드는 “금고에서 꺼내 쓴다”고만 적었다는 뜻이에요. 그래서 코드를 공유해도 비밀은 안 따라가요.
➡️ 다음엔 이렇게
“키는 .env로 빼줘”라고 시키고, 반드시 “.env는 깃허브에 안 올라가게 해줘”를 같이 말하세요. 배포(호스팅)할 땐 키를 코드에 다시 넣지 말고 “이 호스팅에서 환경변수를 설정하는 법 알려줘”라고 하면 됩니다.
💬 김지백 강사의 현장 팁
여러 API 키(음성·이미지 생성 등)를 코드에 직접 박았다가, 키가 새면 큰일이라 늘 불안했어요. 키를 .env 금고 파일로 빼고 그 파일은 깃허브에 안 올라가게 막은 뒤로는, 코드를 공유하거나 두 컴퓨터를 오가도 마음이 편해졌어요. 키는 처음부터 .env로 빼두는 걸 습관으로 만들면 사고가 안 납니다.
한국경영교육연구소 · AI ACADEMY — 외부강사 김지백 · 시연 교실 홈