Claude Code, Codex, Cursor에서 AI 지침을 공유하는 방법

공유 지침을 검토와 버전 관리가 이루어지는 원본에 보관하고, 각 도구가 지원하는 형식으로 전달한 뒤 새 작업에서 확인하세요. 파일 복사는 전달 단계일 뿐입니다. 중요한 결과는 다음 작업에서 올바른 지침이 적용되는 것입니다.

각 도구는 어떤 파일을 사용하나요?

Codex: 프로젝트 경로를 따라 AGENTS.md를 읽습니다. 더 구체적인 지침과 재정의 파일이 실제로 읽는 내용에 영향을 줄 수 있습니다.
Claude Code: 프로젝트 지침에 CLAUDE.md를 사용하며, 팀은 소스 관리를 통해 공유할 수 있습니다.
Cursor: 간단한 프로젝트 지침에는 AGENTS.md, 세부 규칙에는 .cursor/rules를 지원합니다. Team 및 Enterprise 요금제에서는 조직 수준의 Team Rules도 제공합니다.

로딩 방식과 적용 범위는 서로 다릅니다. 도구별 설정을 분리하고 기존 설정을 바꾸기 전에 아래 공식 문서를 확인하세요.

주요 차이점 요약:

도구	공유 프로젝트 파일	적용 범위	개인 파일
Codex	`AGENTS.md`	프로젝트 경로를 따라 읽으며, 하위 폴더의 `AGENTS.md`가 해당 폴더의 지침을 보완합니다	`~/.codex/AGENTS.md`
Claude Code	`CLAUDE.md`	프로젝트 루트이며, 하위 폴더의 파일은 그 폴더를 사용할 때 읽습니다	`CLAUDE.local.md`와 `~/.claude/CLAUDE.md`
Cursor	`AGENTS.md` 또는 `.cursor/rules/*.mdc`	규칙은 `globs`와 `alwaysApply`로 범위를 선언하고, Team Rules는 프로젝트 전체에 적용됩니다	Cursor 설정의 User Rules

최소 예제

규칙은 도구마다 한 번씩 작성하고 문구를 똑같이 유지하세요. 검토자가 파일을 한 줄씩 비교할 수 있습니다.

Codex용 AGENTS.md이며 Cursor도 읽습니다:

# Reports
- Write calendar dates as YYYY-MM-DD.
- If a date is ambiguous, ask before writing it.

Claude Code용 CLAUDE.md:

# Reports
- Write calendar dates as YYYY-MM-DD.
- If a date is ambiguous, ask before writing it.

보고서 파일에만 적용되는 Cursor 규칙 .cursor/rules/reports.mdc:

---
description: Date format for project reports
globs: reports/**
alwaysApply: false
---
- Write calendar dates as YYYY-MM-DD.
- If a date is ambiguous, ask before writing it.

세 파일을 함께 커밋하고, 변경 사항은 하나의 변경으로 검토하세요.

규칙 하나와 담당자 한 명으로 시작하세요

폐기할 수 있는 예제 프로젝트에서 “이 프로젝트의 보고서 날짜는 YYYY-MM-DD로 작성한다. 날짜가 모호하면 먼저 확인한다”라는 규칙을 만드세요. 각 도구가 지원하는 프로젝트 파일에 적절한 지침을 넣고, 담당자 한 명이 공통 규칙 변경을 함께 검토합니다. 기존 파일을 덮어쓰거나 개인 지침을 팀 규칙으로 복사하지 마세요.

하나의 저장소에서 작업하는 작은 팀이라면 Git으로 검토하는 파일만으로 충분할 수 있습니다. 공유 문구의 기준이 되는 원본을 하나 정하세요. 스크립트가 다른 파일을 생성한다면 생성된 파일임을 표시하고, 두 사본을 따로 수정하지 말고 원본을 검토하세요. 도구별 형식과 적용 범위는 유지합니다.

지침이 적용됐는지 어떻게 확인하나요?

올바른 프로젝트와 지침 버전이 각 도구에 전달됐는지 확인합니다.
해당 프로젝트에서 별도의 새 작업을 시작합니다. 형식 규칙을 반복하지 않고 2026년 9월 14일자 보고서를 요청합니다.
결과가 2026-09-14를 사용하는지 확인하고 작업과 규칙 버전을 증거로 기록합니다.
모호한 날짜와 다른 프로젝트도 테스트합니다. 도구가 확인 질문을 하는지, 프로젝트 규칙이 잘못된 범위로 퍼지지 않았는지 확인합니다.

이는 권장 검증 절차이며 벤치마크나 모델 동작 보장이 아닙니다. 파일 로딩과 이후의 올바른 응답은 별개의 관찰 결과입니다. 실패하면 실제로 읽은 지침, 충돌 규칙, 프로젝트 범위와 도구 버전을 먼저 점검하세요.

검토에서 인계까지 짧게 해 보는 연습

이 연습은 위의 확인을 검토된 규칙 하나, 작업 하나, 인계 한 번, 결과 확인 한 번으로 확장한 것입니다. 현재 onemind 문서를 바탕으로 쓴 제안이며, 이번 개정에서는 실제 AI 서비스로 실행하지 않았습니다. 결과는 각 도구의 버전과 모델 동작에 따라 달라집니다.

폐기할 수 있는 Project 폴더를 사용하고, 고객 콘텐츠는 넣지 말고, 위의 날짜 규칙만 공유 규칙으로 두세요. 작업 단계에는 Claude Code와 Codex를 사용합니다. Cursor에는 Matrix 작업을 배정할 수 없으므로 파일 단계로만 확인합니다. 각 작업은 전달 후 새로 시작하는 작업이며, 규칙을 작성한 대화의 연속이 아닙니다.

검토. 날짜 규칙을 해당 Project의 Mind 변경으로 제안하고 검토자가 승인하게 합니다. 승인된 버전을 기록합니다. Mind와 검토를 참고하세요.
전달. 그 Mind를 Claude Code의 바인딩된 폴더에 동기화하고, 동기화 활동에서 해당 도구와 폴더가 전달됨으로 표시될 때까지 기다립니다. 대기 중이나 적용 중은 전달이 아닙니다. Mind Sync를 참고하세요.
첫 번째 작업. Matrix에서 해당 Project에 “reports/weekly.md에 2026년 9월 14일자 주간 보고서 작성” 같은 작업을 만들고, 규칙을 반복하지 않은 채 Claude Code에 배정합니다. 도구가 권한을 요청하면 그 도구가 실행되는 Mac의 소유자만 답할 수 있습니다.
Codex에 먼저 전달한 뒤 인계. 작업이 도구 실행 종료로 표시되면, 같은 승인 버전의 Mind를 Codex 자신의 바인딩된 Project 폴더에 전달하고 동기화 활동에서 Codex와 그 폴더가 전달됨으로 표시될 때까지 기다립니다. 팀원의 Mac에는 자체 바인딩된 로컬 폴더가 있으며, Claude Code의 전달 기록은 Codex에 대해 아무것도 말해 주지 않습니다. 이 전달이나 그 버전을 알 수 없으면 계속하기 전에 멈추고 먼저 해결하세요. 인계는 작업과 최신 결과를 전달할 뿐 리포지토리 파일도, Claude Code의 전체 대화도 전달하지 않습니다. Codex가 무엇이든 편집하기 전에, 검토된 reports/weekly.md가 팀의 일반적인 파일 검토 또는 Git 절차를 거쳐 Codex 자신의 바인딩된 폴더나 워크트리에 이미 있어야 합니다. 없으면 멈추고 먼저 맞추세요. 끝난 작업은 실행 아래의 입력란에서 다른 도구로 넘깁니다. 작업 메뉴의 인계는 아직 배정됨, 작업 중, 차단됨 상태인 작업만 재배정합니다. 이어서 진행할 곳에서 같은 Project에 연결된 Codex를 선택하고, 그 메시지에 파일 경로와 검토된 첫 줄, Codex에 필요한 결정을 적습니다. Codex가 다른 팀원의 것이면 먼저 그 소유자의 승인이 필요하며, 작업은 승인 대기 중으로 표시됩니다. 같은 메시지에서 Codex에 규칙을 반복하지 않고 reports/weekly.md의 검토된 첫 줄을 그대로 두고 2026년 9월 21일자 줄을 하나 추가해 달라고 요청합니다. Matrix 대화를 참고하세요.
결과 확인. 작업의 변경사항 탭에서 diff를 읽습니다. 도구 소유자가 변경 사항 공유를 사용하면 팀원도 같은 스냅샷을 읽을 수 있습니다. 도구를 실행한 Mac에서는 터미널에 실행 출력이 표시되고 미리보기로 로컬 개발 서버를 볼 수 있습니다. 다른 기기에서는 공유된 변경 사항만 보입니다. 작업, 두 결과, Mind 버전을 기록합니다.

다음이 모두 맞으면 성공입니다

각 도구의 작업을 시작하기 전에 동기화 활동이 그 도구 자신의 바인딩된 폴더에 대해 전달됨을 표시했습니다.
Claude Code가 reports/weekly.md에 쓴 첫 결과는 2026-09-14를 사용하고, Codex의 인계 결과는 검토된 그 첫 줄을 그대로 둔 채 2026-09-21을 추가합니다. 두 작업 요청 모두 형식 규칙을 반복하지 않았습니다.
작업 로그에 Codex에게 인계 행이 있습니다.
두 Mac 중 어느 것도 소유하지 않은 팀원이 공유된 변경 사항과 작업 로그를 읽을 수 있습니다.
사람이 출력을 검토했습니다. 실행 종료는 도구가 완료를 보고했다는 뜻이지 작업이 수락됐다는 뜻은 아닙니다.

다음 중 하나라도 있으면 실패로 봅니다

어느 한 도구가 다른 날짜 형식으로 썼거나 규칙을 물어봤습니다. 문구를 추가하기 전에 승인된 버전, 해당 도구와 폴더의 동기화 상태, 작업이 바인딩된 폴더에서 실행됐는지, CLAUDE.md 가져오기나 .cursor/rules 같은 충돌하는 로컬 파일, 도구 버전을 확인하세요.
Codex가 Claude Code 대화에만 있던 결정에 의존했습니다. 그 결정을 인계에 추가하고 다시 실행하세요. 이는 예상된 동작이지 결함이 아닙니다.
실행이 차단됨 또는 실패로 표시되거나, 기기를 계속 기다리거나, 이어서 진행할 곳에 Codex가 없습니다. Mac이 온라인이고 로그인되어 있는지, Codex가 같은 Project에 연결되어 있는지 확인하고, 계속 오프라인이면 재배정하며, 인계가 가능한 작업 상태는 Matrix 작업에서 확인하세요. 답하지 않은 권한 요청은 만료되어 거부로 처리됩니다.

이 확인의 한계. 규칙 하나, 도구 둘, 인계 한 번만 관찰하므로 도구가 지침을 얼마나 자주 따르는지는 측정하지 못합니다. 전달, 한 번의 올바른 결과, 이후의 동작은 각각 별개의 관찰입니다. 실행 중에 Mac이 잠자기 상태가 되거나 onemind가 종료되면 도구 소유자에게 실행이 중단됨 알림이 오고 다시 시작을 선택할 수 있습니다. 자동으로 다시 시작되지는 않습니다. 반복 실행이나 예약 실행은 이 연습의 범위 밖입니다. 더 자세한 흐름은 중요한 내용을 빠뜨리지 않고 AI 작업 넘기기를 읽어 보세요.

onemind는 어떤 역할을 하나요?

onemind는 팀이 여러 AI 도구에서 지침과 교훈을 검토하고 버전을 관리하도록 돕습니다. 유지할 지침을 Mind에 담고 Team 또는 Project 범위를 명확히 한 뒤, 수정 제안을 배포 전에 검토하세요. 이후 별도의 작업에서 사용됐는지 확인합니다.

평가할 점은 검토와 유지 관리 과정이 팀의 반복 수정을 줄이는지입니다. 파일 기반 구성만으로 요구를 충족할 수도 있습니다. onemind는 모델이 모든 지침을 항상 따르도록 보장하지 않습니다. 접근 제어와 테스트는 여전히 필요합니다.

자주 묻는 질문

지침을 공유하면 채팅 기록도 동기화되나요?

아니요. 프로젝트 지침 파일만으로 다른 도구의 대화 기록이 전달되지는 않습니다.

모든 도구에 같은 파일을 전달해야 하나요?

공통 규칙은 같은 의미를 가질 수 있지만 형식, 개인 설정과 프로젝트 범위는 다를 수 있습니다. 모두 복사하기보다 충돌을 명확히 해결하세요.

무엇부터 해볼 수 있나요?

반복되는 수정 하나와 프로젝트 하나를 선택하세요. onemind를 열고 현재 도구의 설정 방법을 확인한 뒤, 수정이 검토와 전달을 거쳐 이후 작업에 쓰이는지 추적하세요. onemind는 데스크톱 브라우저와 macOS를 지원합니다. 현재 요금을 확인해 팀에 맞는 플랜을 선택하세요.

인계할 때 무엇을 적어야 하나요?

다음 도구에 필요한 결정, 파일, 아직 답하지 않은 질문입니다. 인계는 작업과 최신 결과를 전달할 뿐 첫 번째 도구의 전체 대화는 전달하지 않으며, 팀원의 도구를 사용하려면 먼저 그 소유자의 승인이 필요합니다. 첫 인계 전에 Matrix 작업을 읽어 보세요.

공식 자료

도구의 동작은 바뀔 수 있습니다. 최신 Codex 지침 가이드, Claude Code 메모리 문서, Cursor 규칙 문서를 확인하세요. 이 글은 평가할 작업 절차를 설명하며 고객 사례가 아닙니다.