코덱스 PC 연결 방법｜다른 컴퓨터에서 같은 프로젝트 이어서 작업하기

집에서 Codex로 홈페이지를 수정하다가 회사 노트북이나 다른 PC에서도 같은 작업을 이어서 하고 싶을 때가 있습니다. 이때 프로젝트 폴더를 USB나 구글 드라이브로 옮겨 다닐 필요는 없습니다.

가장 안정적인 방법은 작성한 코드를 GitHub에 저장하고, 다른 컴퓨터에서 같은 저장소를 내려받아 Codex로 여는 것입니다. Codex 대화 내용과 실제 홈페이지 코드는 서로 다른 개념이므로, 코드가 GitHub에 최신 상태로 올라가 있는지 확인하는 것이 중요합니다.

한눈에 보는 요약

• 다른 PC에 Codex 앱과 Git을 설치합니다.
• 기존에 사용하던 것과 같은 OpenAI 계정으로 Codex에 로그인합니다.
• GitHub에서 프로젝트 저장소를 새 PC로 내려받습니다.
• Codex에서 내려받은 프로젝트 폴더를 엽니다.
• 필요한 환경변수와 패키지를 설정한 뒤 실행합니다.
• 작업이 끝나면 GitHub에 다시 올려야 다른 PC에서도 최신 내용을 받을 수 있습니다.

코덱스 PC 연결에 필요한 것

다른 컴퓨터에서 기존 프로젝트를 이어서 작업하려면 아래 항목이 필요합니다.

준비 항목	용도
OpenAI 계정	Codex 앱 로그인
Codex 앱	코드 확인과 수정 작업
Git	GitHub에서 프로젝트를 받고 다시 올리는 도구
GitHub 계정	프로젝트 코드 보관과 PC 간 동기화
프로젝트 저장소 주소	새 PC에서 기존 프로젝트를 찾을 때 사용
환경변수 값	관리자 로그인, Supabase 등 비공개 설정

여기서 가장 많이 놓치는 부분은 환경변수입니다. ADMIN_PASSWORD, Supabase 비밀 키처럼 공개되면 안 되는 값은 보통 GitHub에 올리지 않습니다. 따라서 새 PC에서는 별도로 다시 설정해야 합니다.

1. 새 PC에 Codex 설치하기

먼저 OpenAI의 Codex 공식 안내 페이지에서 현재 운영체제에 맞는 Codex 앱을 확인합니다. Windows PC라면 Codex Windows 안내도 함께 확인하는 것이 좋습니다.

설치가 끝나면 기존에 사용하던 OpenAI 계정으로 로그인합니다. 같은 계정으로 로그인하면 Codex를 이용할 수 있지만, 프로젝트 파일까지 자동으로 새 PC에 복사되는 것은 아닙니다. 실제 코드는 다음 단계에서 GitHub를 통해 받아야 합니다.

2. Git과 GitHub 준비하기

새 컴퓨터에 Git이 없다면 Git 공식 홈페이지에서 설치합니다. 설치 과정은 기본 설정 그대로 진행해도 일반적인 사용에는 문제가 없습니다.

GitHub에도 로그인합니다. 비공개 저장소라면 저장소 소유자 계정으로 로그인해야 프로젝트를 내려받을 수 있습니다.

현재 프로젝트가 GitHub에 제대로 올라가 있는지는 저장소 화면에서 최근 수정한 파일과 커밋 날짜를 확인하면 됩니다.

3. GitHub 프로젝트를 새 PC로 받기

GitHub 저장소 화면에서 초록색 Code 버튼을 누른 뒤 HTTPS 주소를 복사합니다. 그다음 파일을 보관할 폴더에서 터미널이나 명령 프롬프트를 열고 아래처럼 입력합니다.

git clone GitHub저장소주소

예를 들면 다음과 같은 형태입니다.

git clone https://github.com/아이디/저장소이름.git

명령이 끝나면 저장소 이름과 같은 새 폴더가 생깁니다. 이 폴더 안에 홈페이지 코드와 이미지, 게시글 파일이 들어 있습니다.

명령어 사용이 어렵다면 GitHub Desktop을 설치해 Clone repository 기능으로 내려받아도 됩니다. 중요한 것은 구글 드라이브 복사본이 아니라 GitHub의 최신 저장소를 기준으로 작업하는 것입니다.

4. Codex에서 프로젝트 폴더 열기

Codex 앱을 실행하고 방금 내려받은 프로젝트 폴더를 엽니다. 폴더를 잘못 선택하면 Codex가 기존 코드 구조를 확인하지 못하므로 package.json, app, components 같은 프로젝트 파일이 보이는 최상위 폴더를 선택해야 합니다.

프로젝트를 연 뒤에는 Codex에게 다음처럼 요청할 수 있습니다.

현재 프로젝트 구조를 확인하고 기존 디자인을 유지한 채 수정해줘.

처음 여는 PC라면 Codex가 프로젝트 파일을 읽고 현재 상태를 파악하는 데 약간의 시간이 필요할 수 있습니다.

5. 패키지와 환경변수 설정하기

Next.js 프로젝트라면 처음 한 번은 프로젝트 폴더에서 아래 명령을 실행해 필요한 패키지를 설치합니다.

npm install

그다음 .env.example을 참고해 .env.local 파일을 만들고 필요한 값을 입력합니다.

ADMIN_ID=관리자아이디
ADMIN_PASSWORD=관리자비밀번호
NEXT_PUBLIC_SUPABASE_URL=Supabase주소
SUPABASE_SERVICE_ROLE_KEY=Supabase비밀키

실제 변수 이름은 프로젝트마다 다릅니다. 기존 PC의 .env.local을 확인하되, 비밀번호와 비밀 키를 메신저나 공개 저장소에 올리면 안 됩니다. 회사 PC라면 회사 보안 정책상 개인 비밀 키 저장이 허용되는지도 먼저 확인하는 편이 안전합니다.

6. 홈페이지 실행해 확인하기

설정이 끝나면 아래 명령을 실행합니다.

npm run dev

브라우저에서 보통 http://localhost:3000으로 접속하면 수정 전 홈페이지가 정상적으로 보이는지 확인할 수 있습니다.

문제가 생기는 경우	먼저 확인할 내용
사이트가 열리지 않음	터미널에 오류가 있는지 확인
관리자 로그인이 안 됨	`.env.local`의 아이디와 비밀번호 확인
이미지 업로드가 안 됨	Supabase 주소, 비밀 키, 버킷 이름 확인
예전 화면이 보임	GitHub에서 최신 코드를 받았는지 확인
명령어가 실행되지 않음	Node.js와 Git 설치 여부 확인

작업을 시작하기 전과 끝낸 뒤 해야 할 일

여러 PC에서 작업할 때는 작업 순서가 중요합니다.

작업 시작 전

git pull

다른 PC에서 올린 최신 코드를 먼저 받습니다.

작업이 끝난 뒤

수정한 내용을 확인한 후 GitHub에 커밋하고 푸시합니다. Codex에 “변경 내용을 확인하고 GitHub에 올려줘”라고 요청할 수도 있습니다.

한 PC에서 수정한 뒤 GitHub에 올리지 않으면 다른 PC는 그 변경 내용을 알 수 없습니다. 반대로 두 컴퓨터에서 최신 코드를 받지 않은 채 같은 파일을 동시에 수정하면 충돌이 생길 수 있습니다.

회사 PC에서 사용할 때 주의할 점

• 회사에서 개인 GitHub와 Codex 사용을 허용하는지 확인합니다.
• Supabase 비밀 키와 관리자 비밀번호를 다른 사람에게 보여주지 않습니다.
• 공용 PC에서는 로그인 상태를 남기지 않습니다.
• 작업이 끝나면 GitHub에 올렸는지 확인하고 로그아웃합니다.
• 회사 자료나 개인정보를 허가 없이 Codex에 입력하지 않습니다.

자주 묻는 질문

같은 OpenAI 계정으로 로그인하면 프로젝트가 자동으로 보이나요?

Codex를 이용할 수는 있지만 로컬 프로젝트 파일이 자동으로 복사되는 것은 아닙니다. GitHub에서 프로젝트를 내려받거나 직접 파일을 옮겨야 합니다.

구글 드라이브에 프로젝트 폴더를 넣어도 되나요?

단순 백업은 가능하지만 여러 PC에서 동시에 수정하면 동기화 충돌이나 node_modules 파일 문제가 생길 수 있습니다. 코드 작업은 GitHub를 기준으로 관리하는 방법이 더 안정적입니다.

다른 PC에서도 홈페이지 전체를 수정할 수 있나요?

프로젝트 코드와 환경변수가 준비되어 있다면 가능합니다. 디자인 수정, 게시글 추가, 기능 개선 후 GitHub에 올리면 Vercel이 새 버전을 배포하도록 구성할 수도 있습니다.

매번 npm install을 해야 하나요?

새 PC에서 처음 프로젝트를 받았을 때와 사용 패키지가 변경되었을 때 주로 실행합니다. 매번 실행할 필요는 없습니다.

작업 전에 꼭 git pull을 해야 하나요?

여러 컴퓨터를 번갈아 사용한다면 습관처럼 실행하는 것이 좋습니다. 최신 코드를 받지 않고 수정하면 이전 버전 위에 작업하게 될 수 있습니다.

마무리

코덱스 PC 연결의 핵심은 단순히 같은 계정으로 로그인하는 것이 아니라 GitHub를 중심으로 프로젝트 코드를 최신 상태로 맞추는 것입니다.

새 PC에 Codex와 Git을 설치하고, GitHub 저장소를 내려받은 다음 환경변수와 패키지만 설정하면 집과 회사의 다른 컴퓨터에서도 같은 홈페이지 작업을 이어갈 수 있습니다. 작업을 시작할 때는 git pull, 작업을 마친 뒤에는 커밋과 푸시를 기억하면 파일을 직접 복사하는 번거로움을 크게 줄일 수 있습니다.

Codex의 설치 화면과 지원 환경은 업데이트될 수 있으므로 실제 설치 전에는 OpenAI 공식 Codex 문서를 확인하는 것이 가장 정확합니다.