“뭘 설치해야 하지?”
“어디서부터 시작해야 하지?”

이 글은 그런 고민을 줄이기 위해 작성했다.
맥에서 Node.js 기반으로 Codex를 실행할 수 있는 최소한의 환경을
한 단계씩, 실패하지 않는 경로로 세팅해본다.

이 글에서 만드는 최종 상태

이 글을 끝까지 따라 하면 다음 상태가 된다.

• 터미널에서 Node.js 사용 가능
• Node 기반 프로젝트 생성 완료
• Codex를 실행할 수 있는 준비 상태
• 이후 AI 자동화 스크립트를 바로 추가할 수 있는 구조

최종 폴더 구조는 단순하다.

ai-workspace/
  ├─ package.json
  ├─ scripts/
   │   └─ test.js
  └─ README.md

`

1. 사전 준비: 맥 기본 환경 확인

macOS 확인

터미널을 열고 아래 명령어를 실행한다.

sw_vers

macOS 버전 정보가 나오면 정상이다.

이미 터미널을 사용하고 있다면, 이 단계는 확인만 하고 넘어가도 된다.

2. Homebrew 설치

맥에서 개발 환경을 세팅할 때
Homebrew는 사실상 기본 도구다.

아래 명령어를 그대로 복사해 실행한다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 중간에:

• 비밀번호 입력
• 엔터 입력 요청

이 나올 수 있다.
화면 안내 그대로 진행하면 된다.

설치 확인:

brew --version

버전이 출력되면 성공이다.

3. Node.js 설치 (권장 방식: nvm)

Node.js는 **버전 관리 도구(nvm)**를 사용하는 것이 가장 안전하다.

nvm 설치

brew install nvm

nvm 디렉토리 생성

mkdir ~/.nvm

환경 변수 설정

사용 중인 쉘이 zsh라면 ~/.zshrc에 아래 내용을 추가한다.

export NVM_DIR="$HOME/.nvm"
[ -s "$(brew --prefix nvm)/nvm.sh" ] && . "$(brew --prefix nvm)/nvm.sh"
[ -s "$(brew --prefix nvm)/etc/bash_completion.d/nvm" ] && . "$(brew --prefix nvm)/etc/bash_completion.d/nvm"

적용:

source ~/.zshrc

Node.js 설치

nvm install --lts 
nvm use --lts

설치 확인:

node -v
npm -v

버전 번호가 출력되면 정상이다.

4. 필수 CLI 도구 설치

AI 작업과 자동화를 하다 보면
반드시 쓰게 되는 기본 도구들이다.

brew install git jq ripgrep

• git: 코드 및 작업 이력 관리
• jq: JSON 데이터 가공
• ripgrep: 대용량 파일 검색

지금 당장 쓰지 않더라도,
Codex와 함께 작업하다 보면 자연스럽게 필요해진다.

5. Codex용 Node 프로젝트 생성

이제 실제 작업 공간을 만든다.

mkdir ai-workspace cd ai-workspace npm init -y

현재 구조를 확인한다.

ls

package.json

아직은 비어 있지만,
이 폴더가 앞으로 AI 업무가 쌓이는 공간이 된다.

6. Node 스크립트로 정상 동작 확인

scripts

폴더를 만들고 테스트 파일을 추가한다.

mkdir scripts nano scripts/test.js

아래 내용을 입력한다.

console.log("Node 기반 AI 업무환경 준비 완료");

저장 후 실행:

node scripts/test.js

출력 결과:

Node 기반 AI 업무환경 준비 완료

이 문장이 보이면,
Node 기반 AI 작업 환경은 제대로 준비된 상태다.

정리하며

이 글에서는
Codex를 사용하기 위한 Node 기반 최소 환경을 준비했다.

아직 AI는 등장하지 않았다.
하지만 중요한 토대는 이미 만들어졌다.

다음 글에서는 이 환경 위에서:

• Codex를 실제로 실행해보고
• Node 스크립트와 결합해
• 반복되는 업무를 자동화하는 예제를 만들어볼 예정이다.

조급할 필요는 없다.
환경이 준비되면, 그다음은 생각보다 빠르다.