Codex 규칙을 Markdown에 적어 두면 이런 의문이 생긴다. “같은 OpenAI 계정으로 다른 PC에 로그인하면 이 규칙도 자동으로 따라오지 않을까?”
결론부터 말하면, ChatGPT와 로컬 Codex는 규칙이 저장되는 층이 다르다.
ChatGPT의 사용자 지정 지침과 메모리는 계정 중심의 개인화 기능이다. 반면 Codex의 $CODEX_HOME/AGENTS.md와 ~/.codex/config.toml은 Codex가 실행되는 환경에 실제로 존재하는 파일이다.
같은 회사 제품이어도 규칙이 사는 주소는 다르다.
1. 같은 계정이라고 로컬 설정까지 같아지는 것은 아니다
| 항목 | 주된 위치 또는 범위 | 다른 PC에 같은 내용이 자동 복사된다고 봐도 되는가 |
|---|---|---|
| ChatGPT 사용자 지정 지침 | ChatGPT 계정 | 계정 중심으로 사용됨 |
| ChatGPT 메모리 | ChatGPT 개인화 | 계정 문맥으로 사용됨 |
$CODEX_HOME/AGENTS.md |
Codex 실행환경 파일 | 아니오 |
$CODEX_HOME/AGENTS.override.md |
Codex 실행환경 파일 | 아니오 |
~/.codex/config.toml |
Codex 로컬 설정 | 아니오 |
저장소의 AGENTS.md |
프로젝트 파일 | Git으로 가져오면 공유 가능 |
OpenAI는 Codex CLI를 사용자의 컴퓨터에서 작동하는 로컬 소프트웨어 에이전트로 설명한다. 또한 Codex가 ~/.codex/config.toml, $CODEX_HOME의 AGENTS 파일, Git 또는 프로젝트 최상위 폴더에서 현재 작업 폴더까지의 지시 파일을 읽는다고 공개했다.[1]
즉 Codex에서는 “계정이 기억했나?”보다 “이 환경에 파일이 있나?”가 중요하다.
2. ChatGPT는 “계정이 기억한다”는 이해에 더 가깝다
OpenAI 공식 도움말에 따르면 ChatGPT의 사용자 지정 지침은 모든 대화에 즉시 적용되며 웹, 데스크톱, iOS, Android에서 사용할 수 있다.[2]
메모리는 ChatGPT 개인화 설정에서 관리되며, 대화, 파일, 연결된 앱에서 유용한 문맥을 이어 받아 같은 설명을 반복하는 일을 줄여 준다.[3]
여러 ChatGPT 계정을 전환할 때도 대화, 메모리, 기록, 결제, 작업공간, 설정은 계정별로 분리된다고 OpenAI가 설명한다.[4]
따라서 ChatGPT에서는 “개인화가 계정에 붙어 있다”는 생각이 꽤 정확하다.
다만 화면 모양, 알림, 운영체제 권한처럼 장치별 설정까지 모두 똑같다는 뜻은 아니다.
3. Codex의 AGENTS.md는 프로필이 아니라 현장 작업표준서다
AGENTS.md를 사용자 소개글이 아니라 작업장 벽에 붙은 표준작업서라고 생각하면 쉽다.
PC A에 다음 파일이 있다고 하자.
~/.codex/AGENTS.md
- 완료 전에 테스트한다
- 관련 없는 기존 변경을 지우지 않는다
- force push하지 않는다
이 내용은 별도 동기화가 없다면 PC A의 파일시스템에 있다.
같은 OpenAI 계정으로 PC B에 로그인했다고 해서 PC A의 ~/.codex가 자동으로 생기지는 않는다.
계정은 “누가 쓰는가”를 연결한다.
로컬 파일은 “이 환경에서 어떻게 일할 것인가”를 정한다.
4. 프로젝트 AGENTS.md는 Git이 다른 PC로 운반할 수 있다
프로젝트의 AGENTS.md를 Git에 기록하면 규칙도 프로젝트 이력의 일부가 된다.
Git의 프로젝트
└── project/
├── AGENTS.md
├── src/
└── docs/
↓ clone / pull
PC A PC B
└── project/ └── project/
└── AGENTS.md └── AGENTS.md
이건 OpenAI 계정 동기화가 아니다.
Git이 버전 관리 중인 파일을 운반한 것이다.
빌드 방법, 테스트 방법, 코딩 규칙, 금지 작업, 검토 조건 같은 프로젝트 규칙을 코드와 함께 옮길 수 있다.
공장은 이사했는데 작업표준서만 예전 공장에 남는 참사를 막는다.
5. Codex는 공통 규칙과 더 구체적인 프로젝트 규칙을 함께 읽는다
OpenAI 기술 설명에 따르면 Codex는 여러 곳의 사용자 지시를 모은다. $CODEX_HOME의 AGENTS.override.md와 AGENTS.md를 포함하고, Git 또는 프로젝트 최상위 폴더에서 현재 작업 폴더까지 내려오며 지시 파일을 확인한다. 프로젝트 문서에는 기본 32 KiB 제한도 있다.[1]
따라서 다음처럼 나누는 것이 자연스럽다.
~/.codex/AGENTS.md
모든 프로젝트 공통 규칙
project/AGENTS.md
이 프로젝트 규칙
project/server/AGENTS.md
이 영역의 추가 규칙
모든 내용을 하나의 거대한 Markdown 헌법에 넣는 것보다 관리하기 쉽다.
6. 여러 PC에 사본을 두는 것은 좋다. 다만 정본은 하나여야 한다
여러 컴퓨터를 쓴다면 각 PC에 필요한 Codex 공통 설정을 두고, 각 프로젝트에도 Git에서 받은 AGENTS.md가 있는 구성이 합리적이다.
Git: codex-config/global-AGENTS.md ← 공통 규칙의 정본
│
┌─────┴─────┐
↓ ↓
PC A ~/.codex/AGENTS.md PC B ~/.codex/AGENTS.md
Git: project/AGENTS.md ← 프로젝트 규칙의 정본
↓ clone/pull ↓ clone/pull
PC A project/AGENTS.md PC B project/AGENTS.md
한 PC가 고장 나도 다른 사본과 Git 이력이 남는다.
하지만 각 PC의 파일을 따로 편집하고 전부 “정본”이라고 부르면 곧 이렇게 된다.
PC A = v18
PC B = v16 + 정체불명 추가
PC C = v11 “이게 최신이었나?”
이건 중복 보관이 아니라 디지털 고고학이다.
7. 동기화와 백업은 같은 말이 아니다
같은 파일이 세 곳에 있다고 백업이 완성되는 것은 아니다.
실수로 삭제한 파일이 동기화 도구를 통해 세 PC에서 동시에 사라지면, 삭제 작업만 아주 안정적으로 복제된 것이다.
튼튼한 구성에는 세 가지가 필요하다.
- 어떤 파일이 최신인지 분명한 정본
- 다른 기기에서 실제로 쓸 수 있는 복제본
- 잘못된 변경 전으로 돌아갈 수 있는 버전 이력
텍스트 설정은 Git으로 버전을 관리하기 좋다.
단, API 토큰, 비밀키, 쿠키, 비밀번호, 개인정보를 함께 기록하면 안 된다.
규칙을 백업하다가 비밀까지 여행 보내는 건 웃을 일이 아니다.
8. 무엇을 어디에 둘까
| 내용 | 권장 위치 | 이유 |
|---|---|---|
| ChatGPT의 지속적인 응답 선호 | 사용자 지정 지침 | 계정 개인화에 적합 |
| 대화에서 이어 갈 문맥 | 메모리 | ChatGPT의 지속 문맥에 적합 |
| 모든 로컬 Codex 작업의 공통 원칙 | $CODEX_HOME/AGENTS.md |
넓은 로컬 범위에 적용 가능 |
| Codex의 로컬 동작 설정 | ~/.codex/config.toml |
Codex가 설정 자료로 읽음 |
| 한 프로젝트의 빌드·테스트·안전 규칙 | repo/AGENTS.md |
프로젝트와 함께 버전 관리 가능 |
| 특정 하위 폴더의 추가 규칙 | repo/subdir/AGENTS.md |
더 구체적인 현장 문맥 제공 |
| 공통 Codex 규칙의 복구용 정본 | 비밀정보를 뺀 Git 관리 영역 | 여러 PC에서 버전 관리하기 쉬움 |
ChatGPT의 모든 선호를 Codex로 복사하거나, 프로젝트 매뉴얼 전체를 ChatGPT 메모리에 넣을 필요는 없다.
각 층의 역할이 다르다.
9. 자주 생기는 사고
새 PC에서 Codex가 갑자기 다르게 움직인다. 옛 PC의 AGENTS.md와 config.toml을 옮겼는지 확인한다. 모델이 갑자기 성격을 바꾼 게 아니라 설명서를 두고 왔을 수 있다.
같은 프로젝트가 PC마다 다르게 움직인다. 프로젝트 규칙을 기기마다 손으로 고치면 내용이 벌어진다. 가능한 규칙은 Git으로 옮긴다.
공통 AGENTS.md를 세 PC에서 각각 수정한다. 세 파일이 모두 최신이라고 주장하기 시작한다. 백업 세 개가 아니라 정당 세 개가 생긴 셈이다.
토큰도 같이 Git에 기록한다. 하지 말자. 그것은 편의 기능이 아니라 보안사고 예고편이다.
10. 완성형은 계정·PC·Git의 세 층이다
[ChatGPT 계정층]
사용자 지정 지침 / 메모리
↓
웹 / 데스크톱 / 모바일
[Codex PC층]
PC A ~/.codex/AGENTS.md + config.toml
PC B ~/.codex/AGENTS.md + config.toml
↑
필요하면 안전한 정본에서 동기화
[프로젝트 Git층]
project/AGENTS.md
↓ clone / pull
PC A / PC B / 지원되는 실행환경
최종 답은 간단하다.
ChatGPT는 “계정이 기억한다”는 모델이 유용하다. 로컬 Codex Markdown은 “이 PC에 파일이 있어야 한다”는 모델이 안전하다. 프로젝트 AGENTS.md는 Git을 통해 다른 PC로 이동할 수 있다.
여러 PC에 사본을 두면 장애 대응에 유리하다. 다만 버전이 관리되는 정본은 하나로 두자.
AGENTS.md는 순간이동을 못 한다.
대신 Git이 기차표를 끊어 줄 수 있다.
공식 자료
- OpenAI, “Unrolling the Codex agent loop openai.com
- OpenAI Help Center, “ChatGPT Custom Instructions help.openai.com
- OpenAI Help Center, “Memory FAQ help.openai.com
- OpenAI Help Center, “Use multiple accounts with account switching help.openai.com
