터미널에서 `export API_KEY=”내_API_키”`라고 입력해 환경변수를 설정했는데, 터미널을 닫았다 다시 열거나 맥을 재부팅하니 모든 설정이 사라져 매번 다시 입력해야 하는 답답한 상황을 겪고 계신가요?
이러한 문제는 `export` 명령이 현재 셸 세션에서만 유효한 임시적인 설정이기 때문에 발생합니다.
이 글에서는 맥에서 API 키를 안전하게, 그리고 영구적으로 환경변수로 설정하여 다시는 매번 설정하는 번거로움 없이 쾌적한 개발 환경을 만드는 구체적인 방법을 단계별로 설명합니다.
– `export`는 현재 셸 세션에서만 유효한 임시 설정이며, 영구 설정을 위해서는 셸 설정 파일(예: `.zshrc`)을 편집해야 합니다.
– 대부분의 최신 맥 사용자는 Zsh 셸의 `.zshrc` 파일에 API 키를 `export KEY=”VALUE”` 형식으로 추가하여 영구 설정할 수 있습니다.
– API 키가 외부에 노출되거나 Git 저장소에 실수로 커밋되지 않도록 `.gitignore` 파일을 활용하는 등 강력한 보안 조치가 필수입니다.
맥에서 API 키를 터미널 종료 후에도 유지되도록 .bash_profile 또는 .zshrc 파일에 환경변수를 영구적으로 설정하는 방법을 설명합니다.
`export` 명령은 왜 임시적일까요?
터미널에서 `export` 명령어를 사용하여 환경변수를 설정하면, 해당 변수는 현재 실행 중인 셸 세션에서만 유효합니다. 즉, 터미널 창을 닫거나 새로운 터미널 세션을 시작하면 이전에 설정했던 모든 환경변수 정보는 휘발되어 사라지게 됩니다. 이는 셸의 기본적인 작동 방식이며, 일회성 테스트나 특정 작업에만 필요한 변수를 설정할 때 유용하게 사용되지만, 영구적인 설정을 필요로 하는 경우에는 적합하지 않습니다.
이러한 임시성은 보안상의 이유와 시스템의 유연성을 위해 설계되었습니다. 모든 환경변수가 항상 영구적으로 유지된다면, 불필요한 변수들이 계속 쌓이거나 예기치 않은 충돌을 일으킬 수 있습니다. 하지만 API 키처럼 반복적으로 사용해야 하는 중요한 값들은 매번 수동으로 설정하는 것은 개발 생산성을 심각하게 저해하는 요소가 됩니다.
Photo by Jakub Zerdzicki on Pexels
맥 환경변수 설정 파일, 어떤 것을 사용해야 할까요?
맥 환경에서 환경변수를 영구적으로 설정하려면 셸이 시작될 때 자동으로 읽어들이는 설정 파일에 변수를 추가해야 합니다. 맥OS는 다양한 셸을 지원하지만, 최신 버전의 맥OS (Catalina 이상)는 기본 셸로 Zsh를 사용하고 있으며, 그 이전 버전은 Bash를 사용했습니다. 따라서 현재 사용 중인 셸에 맞는 설정 파일을 선택하는 것이 중요합니다.
대부분의 맥 사용자는 Zsh 셸을 사용하고 있을 것이며, 이때 환경변수는 `~/.zshrc` 파일에 설정합니다. Bash 셸을 사용한다면 `~/.bash_profile` 또는 `~/.profile` 파일에 설정해야 합니다. 파일의 위치는 사용자 홈 디렉토리(`~`)이며, 파일 이름 앞에 점(.)이 붙어 있어 숨김 파일로 처리됩니다. 터미널에서 `echo $SHELL` 명령을 입력하면 현재 사용 중인 셸을 확인할 수 있습니다.
| 셸 종류 | 설정 파일 | 비고 |
|---|---|---|
| Zsh (기본, 최신 macOS) | `~/.zshrc` | 새로운 터미널 창이 열릴 때마다 실행 |
| Bash (이전 macOS) | `~/.bash_profile` | 로그인 셸로 Bash를 사용할 때 실행 (일반적으로 `~/.profile` 포함) |
| 범용 (Bash, Zsh 등) | `~/.profile` | 모든 POSIX 호환 셸에서 읽힘. `~/.bash_profile`이 `~/.profile`을 불러오기도 함 |
API 키 영구 설정, 3단계로 끝내기
이제 여러분의 API 키를 영구적으로 설정하는 3단계를 자세히 설명하겠습니다. 대부분의 경우 `~/.zshrc` 파일을 사용하게 될 것입니다. 만약 Bash 셸을 사용한다면 `~/.bash_profile`로 대체하여 진행하세요.
- 단계 1: 셸 설정 파일 열기 — 터미널을 열고 다음 명령어를 입력하여 셸 설정 파일을 텍스트 편집기로 엽니다. `nano` 대신 `vi`나 `code`(VS Code 사용자)를 사용해도 좋습니다.
nano ~/.zshrc만약 `.zshrc` 파일이 없다면, `touch ~/.zshrc` 명령으로 파일을 먼저 생성할 수 있습니다.
- 단계 2: API 키 추가하기 — 파일이 열리면 가장 마지막 줄에 다음 형식으로 API 키를 추가합니다. `YOUR_API_KEY_NAME`은 여러분이 사용할 환경변수 이름이고, `YOUR_ACTUAL_API_KEY_VALUE`는 실제 API 키 값입니다. 여러 개의 API 키를 추가할 수 있습니다.
export YOUR_API_KEY_NAME="YOUR_ACTUAL_API_KEY_VALUE" export ANOTHER_API_KEY="ANOTHER_VALUE"변경 사항을 저장하고 편집기를 닫습니다. `nano`의 경우 `Ctrl+X`, `Y`, `Enter` 순으로 입력하면 저장됩니다.
- 단계 3: 변경 사항 적용 — 새로운 환경변수가 즉시 적용되도록 현재 셸 세션에 변경 사항을 `source` 명령으로 불러옵니다. 이 과정은 3초도 걸리지 않습니다.
source ~/.zshrc이제 `echo $YOUR_API_KEY_NAME` 명령으로 설정이 제대로 되었는지 확인할 수 있습니다. 터미널을 닫았다 다시 열어도 API 키가 사라지지 않는 것을 볼 수 있습니다.
API 키는 절대 외부에 노출되어서는 안 되는 민감한 정보입니다. 위 단계에서 실제 API 키 값을 직접 파일에 입력하는 것은 개인 개발 환경에만 적용해야 하며, 버전 관리 시스템(Git)에 절대 커밋되지 않도록 각별히 주의해야 합니다.
더 안전한 API 키 관리를 위한 팁
API 키를 셸 설정 파일에 영구적으로 설정하는 것은 편리하지만, 보안 측면에서 몇 가지 추가적인 고려 사항이 있습니다. 특히 여러 프로젝트를 진행하거나 팀 단위로 개발할 경우, 키 관리 방식을 표준화하는 것이 중요합니다.
가장 기본적인 보안 조치는 `.gitignore` 파일을 활용하는 것입니다. 프로젝트 루트에 `.env` 파일을 생성하고 그 안에 API 키를 저장한 후, `.env` 파일을 `.gitignore`에 추가하면 실수로 Git 저장소에 키가 올라가는 것을 방지할 수 있습니다. 애플리케이션에서는 `python-dotenv`나 `dotenv` 같은 라이브러리를 사용하여 `.env` 파일의 변수를 쉽게 불러올 수 있습니다. 이 방법은 프로젝트별로 다른 API 키를 관리할 때 90% 이상의 개발자에게 권장됩니다.
CI/CD(지속적 통합/지속적 배포) 환경에서는 환경변수를 각 플랫폼(예: GitHub Actions, GitLab CI, Jenkins)의 Secret 관리 기능을 통해 안전하게 설정해야 합니다. 이 방식은 API 키가 코드베이스에 전혀 노출되지 않으므로 더욱 강력한 보안을 제공합니다.
맥에서 `export` 명령은 임시적인 환경변수 설정이며, 영구적으로 API 키를 관리하려면 `.zshrc` 또는 `.bash_profile`과 같은 셸 설정 파일에 `export` 구문을 추가해야 합니다. 이 3단계 과정을 통해 매번 재설정하는 번거로움을 해결하고, `.gitignore` 및 `.env` 파일을 활용하여 중요한 API 키의 보안을 강화하는 것이 핵심입니다.
지금 바로 적용해 보세요.
- Zsh 문서: Parameters and Options — Zsh 셸의 환경변수 및 옵션 설정에 대한 공식 문서입니다.
- Git 문서: .gitignore — `.gitignore` 파일을 사용하여 특정 파일을 Git 저장소에서 제외하는 방법을 설명합니다.
동영상으로 보는 맥에서 API 키 환경변수 설정 방법
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. export 명령어로 설정한 API 키가 터미널을 닫으면 사라지는 이유는 무엇인가요?
A. export 명령어는 현재 터미널 세션에만 환경변수를 설정합니다. 터미널을 닫으면 해당 세션이 종료되므로 설정된 환경변수도 함께 사라지게 됩니다. 영구적으로 사용하려면 쉘 초기화 파일에 등록해야 합니다.
Q. 맥에서 API 키를 영구적으로 설정하려면 어떤 파일에 추가해야 하나요?
A. 사용하는 쉘에 따라 다릅니다. macOS의 기본 쉘인 Zsh을 사용한다면 `~/.zshrc` 파일에, Bash를 사용한다면 `~/.bash_profile` 또는 `~/.profile` 파일에 변수를 추가해야 합니다. 이 파일들은 터미널 시작 시 자동으로 실행됩니다.
Q. 환경변수 설정 파일을 수정한 후 변경사항을 바로 적용하려면 어떻게 해야 하나요?
A. 환경변수 파일을 수정한 후에는 터미널을 새로 열거나, `source ~/.zshrc` (또는 해당 쉘 초기화 파일) 명령어를 실행하여 변경사항을 즉시 적용해야 합니다. `source` 명령어는 현재 쉘에 해당 스크립트를 실행하도록 지시합니다.
Q. API 키를 환경변수 파일에 직접 저장하는 것이 보안상 안전한가요?
A. API 키를 쉘 초기화 파일에 직접 저장하는 것은 편리하지만, 해당 파일을 외부에 노출하지 않도록 주의해야 합니다. 보안을 강화하려면 `.gitignore`에 추가하고, 민감한 키는 환경변수 대신 별도의 `.env` 파일이나 Secret 관리 도구를 사용하는 것을 고려할 수 있습니다.