환경변수와 PATH가 뭐야 — API 키 보관과 'command not found'의 정체

환경변수는 프로그램이 실행될 때 참조하는 시스템 설정값으로, API 키 같은 민감한 정보를 코드에 직접 쓰지 않고 안전하게 보관하는 표준 방법입니다.

2026년 7월 기준, AI 도구를 조금이라도 다루다 보면 "환경변수를 설정하세요"라는 안내를 꼭 만나게 됩니다.

이 글을 읽으면 환경변수와 PATH가 무엇인지, 왜 API 키를 여기에 넣는지, 터미널에 자꾸 뜨는 "command not found"의 정체가 무엇인지 한 번에 이해할 수 있습니다.

환경변수는 컴퓨터 전체가 공유하는 "메모지"입니다. API 키는 이 메모지에 적어두고 코드는 값을 불러 쓰면 유출 위험이 크게 줄고, PATH는 그 메모지 중 "명령어를 어느 폴더에서 찾을지" 알려주는 특별한 항목입니다.

환경변수는 무엇인가

환경변수는 "이름=값" 형태로 저장되는 시스템 설정값입니다.

예를 들어 OPENAI_API_KEY=sk-... 처럼 이름과 값을 짝지어 둡니다.

이렇게 저장해두면 컴퓨터에서 돌아가는 프로그램들이 필요할 때 이 값을 꺼내 씁니다.

쉽게 말해 컴퓨터 전체가 함께 보는 메모지에 설정값을 적어두는 셈입니다.

개인적으로는 이 개념 하나만 잡아도 AI 도구 설치 안내의 절반은 막힘없이 따라갈 수 있다고 봅니다.

API 키를 환경변수에 넣으면 왜 더 안전할까

API 키는 특정 서비스를 내 계정으로 쓰게 해주는 비밀번호 같은 값입니다.

이 키를 코드 파일에 그대로 적어두면 위험합니다.

코드를 깃허브 같은 곳에 올리는 순간 키가 그대로 공개되기 때문입니다.

그래서 키는 환경변수나 .env 파일에 넣고, 코드는 그 값을 불러 쓰는 방식을 씁니다.

이렇게 하면 코드에는 "값을 가져와라"는 문장만 남고, 실제 키 값은 코드 밖에 있습니다.

구분	코드에 직접 적기	환경변수에 넣기
키 노출	코드 공유 시 그대로 유출	코드 밖에 있어 노출 안 됨
키 교체	코드를 일일이 수정	설정값 한 곳만 변경
협업·배포	사람마다 키가 섞임	환경별로 값만 다르게

PATH와 "command not found"의 정체

PATH는 환경변수 중에서도 특별한 하나입니다.

"명령어를 실행할 때 프로그램을 어느 폴더에서 찾을지" 알려주는 경로 목록이기 때문입니다.

터미널에서 python이나 node를 치면 바로 실행되는 이유가 여기 있습니다.

그 프로그램이 든 폴더가 PATH에 등록돼 있어서, 컴퓨터가 알아서 찾아 실행하는 것입니다.

"command not found"(명령어를 찾을 수 없음)는 대개 이 PATH에 경로가 없어서 생깁니다.

프로그램을 아직 설치하지 않았거나, 설치는 했는데 그 폴더가 PATH에 등록되지 않은 경우입니다.

맥·윈도우는 어떻게 다를까

맥과 리눅스는 export 명령을 쓰거나 셸 설정 파일(.zshrc)에 값을 적어 둡니다.

윈도우는 시스템 속성에 있는 "환경 변수" 창에서 이름과 값을 추가합니다.

# 맥·리눅스에서 환경변수 설정하기 (터미널)
export OPENAI_API_KEY="여기에_키_값"

# 설정한 값 확인하기
echo $OPENAI_API_KEY

# .zshrc에 적어두면 터미널을 켤 때마다 자동 적용

자주 묻는 질문

환경변수에 넣으면 왜 더 안전한가요?

키 값이 코드 안에 남지 않고 코드 밖의 설정으로 빠지기 때문입니다.

코드를 깃허브에 올리거나 남에게 공유해도 키가 함께 새어 나가지 않습니다.

키를 바꿔야 할 때도 코드를 뒤질 필요 없이 설정값 한 곳만 고치면 됩니다.

command not found가 자꾸 뜨면 어떻게 하나요?

먼저 그 프로그램이 실제로 설치돼 있는지 확인합니다.

설치돼 있는데도 안 되면, 그 프로그램의 폴더가 PATH에 등록됐는지 살펴봐야 합니다.

설치 안내문에 "PATH에 추가하세요"라는 문구가 있다면 대개 이 단계를 놓친 것입니다.

정리

환경변수는 컴퓨터가 공유하는 메모지이고, PATH는 그중 명령어의 위치를 알려주는 항목입니다.

API 키는 코드에 박지 말고 환경변수나 .env에 넣어 두는 것이 기본입니다.

"command not found"를 만나면 설치 여부와 PATH 등록부터 확인하면 대부분 풀립니다.

AI가 "환경변수를 설정하세요"라고 안내할 때, 이제 그 말이 무슨 뜻인지 알 수 있을 것입니다.

 

 

참고한 자료

환경변수·PATH의 개념과 설정 방식은 각 운영체제와 도구의 공식 문서를 기준으로 정리했으며, 명령어 형식과 설정 경로는 버전·환경에 따라 달라질 수 있어 발행 전 공식 문서 확인이 필요합니다.