맥 터미널에서 `export API_KEY=abc` 명령어로 API 키 환경변수를 설정했는데, 터미널을 닫았다 다시 열 때마다 사라져서 매번 재설정하고 계신가요?
이는 `export` 명령어가 현재 세션에서만 임시로 유효하기 때문이며, 터미널 세션이 종료되면 그 정보도 함께 휘발됩니다.
이 글에서는 맥 환경에서 API 키를 터미널을 닫아도 사라지지 않고, 안전하게 영구적으로 설정하는 구체적인 방법을 3단계에 걸쳐 안내합니다.
– `export` 명령어는 일회성임을 이해하고, 쉘 설정 파일(`.zshrc` 또는 `.bash_profile`)에 환경변수를 등록합니다.
– 설정 파일에 API 키를 추가한 후, `source` 명령어로 변경사항을 즉시 적용할 수 있습니다.
– 민감한 API 키는 절대로 Git 저장소에 올리지 않도록 `.gitignore` 파일에 추가하여 보안을 강화해야 합니다.
맥북에서 API 키 환경변수가 터미널 재시작 시 사라지는 문제를 해결하려면 `.zshrc` 또는 `.bash_profile` 파일에 `export` 명령어로 영구 설정하세요.
왜 환경변수가 사라질까? `export` 명령어의 한계
많은 개발자가 API 키나 데이터베이스 비밀번호 같은 중요한 정보를 환경변수로 설정하여 사용합니다. 이는 코드에 직접 민감 정보를 노출하는 것을 막기 위한 좋은 보안 관행 중 하나입니다. 하지만 맥 터미널에서 `export` 명령어로 환경변수를 설정하고 나면, 터미널 창을 닫거나 새 터미널을 열 때마다 이전에 설정했던 변수가 사라지는 경험을 하게 됩니다.
이러한 현상이 발생하는 이유는 `export` 명령어가 현재 터미널 세션에서만 유효한 ‘임시 환경변수’를 설정하기 때문입니다. 쉽게 말해, 현재 실행 중인 쉘 프로세스와 그 자식 프로세스에만 해당 변수가 적용되고, 쉘 프로세스가 종료되면 변수도 함께 사라지는 것이죠. 이는 명령 프롬프트나 파워쉘에서 변수를 설정할 때도 동일하게 나타나는 일반적인 동작입니다.
따라서 터미널을 열 때마다 특정 환경변수가 자동으로 로드되어 항상 사용할 수 있도록 하려면, 쉘이 시작될 때마다 읽는 특별한 설정 파일에 변수를 정의해야 합니다. 이 파일들은 일반적으로 사용자의 홈 디렉터리에 위치하며, 사용 중인 쉘의 종류에 따라 이름이 달라집니다. 맥 사용자 대부분은 기본 쉘로 `zsh` 또는 `bash`를 사용합니다.
맥 환경변수 영구 설정 3단계 가이드
이제 API 키를 터미널을 닫아도 사라지지 않도록 영구 설정하는 구체적인 방법을 알아보겠습니다. 이 과정은 단 3단계로 이루어져 있으며, 5분 내외로 완료할 수 있습니다. 대부분의 최신 macOS 버전은 `zsh`를 기본 쉘로 사용하지만, 혹시 모를 경우를 대비해 본인의 쉘 종류를 먼저 확인하는 것이 좋습니다.
- 현재 쉘 종류 확인 및 설정 파일 열기 — 터미널에서 `echo $SHELL` 명령어를 입력하여 현재 사용 중인 쉘을 확인하세요. 만약 `/bin/zsh`가 나오면 `.zshrc` 파일을, `/bin/bash`가 나오면 `.bash_profile` 파일을 수정할 것입니다.
쉘 설정 파일을 열기 위해 다음 명령어를 사용하세요:
`zsh` 사용자: `nano ~/.zshrc` 또는 `open ~/.zshrc`
`bash` 사용자: `nano ~/.bash_profile` 또는 `open ~/.bash_profile`
만약 해당 파일이 없다면, `touch ~/.zshrc` 또는 `touch ~/.bash_profile` 명령어로 파일을 새로 생성할 수 있습니다.
- API 키 환경변수 추가 — 열린 파일의 맨 아래에 다음 형식으로 API 키를 추가합니다. `YOUR_API_KEY_HERE` 부분은 실제 API 키 값으로 변경하세요. 키 값에 공백이나 특수 문자가 포함될 수 있으므로, 큰따옴표로 감싸는 것이 안전합니다.
export API_KEY="YOUR_API_KEY_HERE"예시:
export MY_OPENAI_KEY="sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`nano` 에디터를 사용했다면 `Ctrl + O`를 눌러 저장하고, `Enter`를 누른 후 `Ctrl + X`를 눌러 종료합니다.
- 변경사항 적용 및 확인 — 파일을 저장한 후, 터미널에 다음 명령어를 입력하여 변경된 설정 파일을 현재 쉘에 즉시 적용합니다.
`zsh` 사용자: `source ~/.zshrc`
`bash` 사용자: `source ~/.bash_profile`
이제 `echo $API_KEY` 명령어를 입력하여 API 키가 제대로 설정되었는지 확인하세요. 터미널을 닫았다 다시 열어도 API 키가 정상적으로 출력된다면 성공입니다.
API 키 보안 강화: `.gitignore` 활용
환경변수를 영구 설정하는 것도 중요하지만, API 키와 같은 민감한 정보는 소스 코드 관리 시스템(예: Git)에 절대로 포함되어서는 안 됩니다. 실수로 공개 저장소에 푸시될 경우, 보안 사고로 이어질 수 있습니다. 이를 방지하기 위한 가장 기본적인 방법은 `.gitignore` 파일을 활용하는 것입니다.
프로젝트 루트 디렉터리에 `.gitignore` 파일을 생성하거나 이미 있다면 열고, 환경변수 파일이나 환경변수를 로드하는 파일(예: `.env` 파일)의 이름을 추가하여 Git 추적 대상에서 제외해야 합니다. 이렇게 하면 Git은 해당 파일을 무시하고, 원격 저장소에 푸시되지 않습니다.
만약 환경변수를 직접 쉘 설정 파일에 넣지 않고, 프로젝트 내에서 `.env` 파일을 통해 관리한다면, 해당 `.env` 파일을 `.gitignore`에 추가하는 것이 좋습니다.
예시: `.gitignore` 파일에 `/.env` 추가.
`.gitignore` 파일에 추가하는 것만으로도 99% 이상의 실수로 인한 노출을 방지할 수 있습니다. 팀 프로젝트에서는 모든 팀원이 이 규칙을 따르도록 안내하는 것이 중요합니다. 혹시라도 이미 커밋했다면, Git 기록에서 민감 정보를 삭제하는 복잡한 과정을 거쳐야 하므로 처음부터 주의하는 것이 최선입니다.
API 키 설정 시 주의사항 및 관리 팁
API 키를 환경변수로 설정하고 관리할 때 몇 가지 추가적인 주의사항과 팁을 기억해두면 좋습니다.
절대로 API 키를 공개된 저장소, 예를 들어 GitHub Public Repository에 직접 커밋하지 마세요. 이는 가장 흔하게 발생하는 보안 사고의 원인 중 하나입니다. 한 번 공개된 키는 취약점으로 악용될 가능성이 매우 높으며, 키를 즉시 교체해야 합니다.
첫째, 필요한 경우에만 API 키를 환경변수로 등록하세요. 모든 개발 환경에 필요한 키가 아니라면 특정 프로젝트에서 `.env` 파일 등을 활용하는 것이 더 효율적일 수 있습니다. 둘째, 사용하지 않는 API 키는 즉시 만료시키거나 삭제하는 습관을 들이세요. 유효한 키가 많을수록 노출 위험도 증가합니다. 마지막으로, 서비스 제공자가 제공하는 API 키 관리 대시보드를 주기적으로 확인하여, 의심스러운 활동이 있는지 모니터링하는 것이 좋습니다.
환경변수는 개발 환경을 설정하는 데 매우 유용한 도구이지만, 보안과 직결되는 만큼 신중하게 다루는 것이 중요합니다. 이 글에서 제시된 방법을 통해 더욱 안전하고 효율적인 개발 환경을 구축하시길 바랍니다.
맥 터미널에서 `export` 명령어로 설정한 환경변수가 사라지는 문제는 쉘 설정 파일(`.zshrc` 또는 `.bash_profile`)에 API 키를 영구적으로 등록하여 해결할 수 있습니다. 파일을 수정한 후에는 `source` 명령어로 변경사항을 적용하고, `echo` 명령어로 확인하는 3단계 과정을 거칩니다.
무엇보다 중요한 것은 민감한 API 키가 실수로 공개되지 않도록 `.gitignore` 파일을 활용하여 Git 추적 대상에서 제외하는 보안 관행입니다.
지금 바로 적용해 보세요.
- Zsh Documentation – Startup Files — Zsh 쉘의 시작 파일(`~/.zshrc` 등)에 대한 공식 문서입니다.
- Bash Reference Manual – Bash Startup Files — Bash 쉘의 시작 파일(`~/.bash_profile` 등)에 대한 공식 설명입니다.
- GitHub Docs – Ignoring files — `.gitignore` 파일을 사용하여 Git에서 파일을 무시하는 방법에 대한 공식 가이드입니다.
동영상으로 보는 맥북 API 키 환경변수 영구 설정
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 터미널을 닫으면 설정했던 API 키 환경변수가 사라지는 이유는 무엇인가요?
A. 이는 환경변수를 현재 세션에만 적용되는 방식으로 설정했기 때문입니다. `export` 명령어를 사용하여 터미널에서 직접 설정하면, 해당 터미널 세션이 종료될 때 변수도 함께 소멸됩니다. 영구적인 설정을 위해서는 특정 셸 설정 파일에 정의해야 합니다.
Q. 맥에서 API 키를 영구적으로 설정하려면 어떤 셸 설정 파일을 수정해야 하나요?
A. 대부분의 최신 macOS는 기본 셸로 Zsh를 사용하므로, 사용자 홈 디렉토리(`~`)의 `.zshrc` 파일에 설정하는 것이 일반적입니다. Bash를 사용하는 경우 `.bash_profile` 또는 `.profile` 파일을 사용하며, 셸 종류에 따라 적절한 파일을 선택해야 합니다.
Q. 선택한 파일(.zshrc 등)에 API 키를 추가한 후, 어떻게 적용하고 확인할 수 있나요?
A. 파일에 `export API_KEY=”YOUR_API_KEY_HERE”` 와 같이 추가한 후, `source ~/.zshrc` (또는 해당 파일) 명령어를 실행하여 변경사항을 즉시 적용할 수 있습니다. 이후 `echo $API_KEY` 명령으로 값이 제대로 출력되는지 확인하여 설정 여부를 검증하세요.
Q. API 키를 .zshrc 같은 설정 파일에 직접 저장하는 것이 보안상 안전한가요?
A. 개인 개발 환경에서는 일반적으로 허용되지만, 중요한 API 키의 경우 보안에 유의해야 합니다. 공용 컴퓨터에서는 절대 직접 저장하지 마시고, 팀 프로젝트에서는 `.env` 파일과 같은 별도의 환경 설정 파일을 사용하고 `.gitignore`에 추가하여 버전 관리에 포함되지 않도록 하는 것이 더 안전합니다.
함께 읽으면 좋은 글