MemoryLake
모든 글로 돌아가기
Tutorial2026년 11월 20일·10 분 소요

컨텍스트 손실 없이 Claude Skills를 Codex로 마이그레이션하는 방법 (2026)

지난 1년 동안 여러분은 Claude에서 여러 개의 Skills를 구축했을 것입니다. 팀이 선호하는 방식으로 릴리스 노트를 포맷하는 것, 회의 녹취록을 실행 항목으로 변환하는 것, 또는 사내 규칙 목록에 따라 풀 리퀘스트를 확인하는 것 등이 있을 수 있습니다. 일부는 Claude 설정에 ZIP 파일로 업로드되어 있고, 다른 일부는 Claude Code용으로 작성되어 ~/.claude/skills에 위치해 있을 것입니다. 이제 Codex를 더 많이 사용하게 되면서, 동일한 Skills를 그곳에서도 사용하고 싶을 것입니다.

좋은 소식은 두 도구 모두 동일한 형식을 기반으로 한다는 점입니다. OpenAI의 Codex 문서는 "Skills는 개방형 에이전트 Skills 표준을 기반으로 구축됩니다"라고 명시하고 있습니다. Anthropic의 문서 또한 Claude Skills를 동일한 방식, 즉 SKILL.md 파일을 중심으로 한 지침, 스크립트 및 리소스 폴더로 설명합니다.

핵심은 세부 사항에 있습니다. 각 유형의 Claude Skill이 어디에 위치하는지, Codex 임포터가 어떤 것을 가져오는지, Codex가 어떤 frontmatter 필드를 읽는지, 그리고 어떤 Claude Code 기능이 이전되지 않는지 파악해야 합니다. 이 가이드는 이 모든 내용과 함께 파일이 이동할 때 각 Skill 뒤에 숨겨진 의도(reasoning)를 유지하는 방법까지 다룹니다.

각 도구에서 Skill의 정의

Anthropic 고객 센터는 Skill을 한 줄로 정의합니다. "Skills는 Claude가 전문화된 작업에서 성능을 향상하기 위해 동적으로 로드하는 지침, 스크립트 및 리소스 폴더입니다."

OpenAI의 정의도 이와 유사합니다. "Skill은 SKILL.md 파일과 선택적인 스크립트 및 참조가 포함된 디렉토리입니다. SKILL.md 파일에는 반드시 name과 description이 포함되어야 합니다."

두 도구 모두 일반적으로 동일한 방식으로 Skills를 로드합니다. Codex는 각 Skill의 이름과 설명을 먼저 확인하고, 사용하기로 결정했을 때 전체 지침을 로드합니다. Anthropic은 Claude의 버전 역시 '점진적 공개(progressive disclosure)' 방식으로 설명하며, Claude가 사용 가능한 Skills를 검토하고 관련 있는 것들을 로드한다고 말합니다.

따라서 Skill 폴더는 대부분 호환 가능합니다. 문제는 각 Skill을 Codex가 읽는 위치로 어떻게 옮기느냐와 그 과정에서 무엇을 수정해야 하느냐입니다.

Claude Skills가 저장되는 위치

Skills는 최대 세 곳에 저장될 수 있으며, 각각 이동 방식이 다릅니다.

Claude 앱 내 Skills. 이는 claude.ai 또는 Claude Desktop에서 채팅 중에 생성하거나 ZIP 파일로 업로드한 Skills입니다. 이들은 컴퓨터의 폴더가 아니라 사용자 계정에 저장됩니다. Anthropic 고객 센터에서는 복사본을 얻는 방법을 설명합니다. Skills 목록에서 해당 Skill을 찾아 상세 정보를 열고 다운로드하면 됩니다. 업데이트된 레이아웃에서 Skills 목록은 Customize 메뉴를 대체한 Plugins 항목 아래에 있습니다.

Claude Code 내 Skills. 개인용 Skills는 ~/.claude/skills/<skill-name>/SKILL.md에 위치합니다. 프로젝트용 Skills는 리포지토리의 .claude/skills/에 위치합니다. 플러그인 Skills는 플러그인 내부에 있습니다.

claude.ai에서 Claude Code로 동기화된 Skills. claude.ai 계정으로 Claude Code에 로그인하면, Claude Code는 계정의 Skills를 ~/.claude/skills/synced/로 다운로드합니다. 이는 앱 Skills의 복사본이며 별도의 원본이 아닙니다. 문서에 따르면 여기서 수정한 내용은 다시 저장되지 않으므로, 앱 버전을 원본으로 취급해야 합니다.

이동하기 전에 각 위치의 Skills 목록을 작성하고 중복된 것이 있는지 확인하세요.

Codex 임포터가 가져오는 항목

Codex에는 가져오기(import) 흐름이 있으며, 이는 마이그레이션의 일부를 처리합니다. OpenAI의 가져오기 문서에 따르면, ChatGPT 데스크톱 앱은 Claude Code, Claude Cowork 또는 Cursor에서 가져올 수 있으며, CLI는 Claude Code 또는 Cursor에서 가져올 수 있습니다. CLI에서는 유휴 세션 중에 /import를 실행합니다.

가져오기 대상 항목 테이블에는 Codex Skills로 들어가는 Skills와, 역시 Skills가 되는 슬래시 명령어가 포함되어 있습니다. 문서에는 마이그레이션 시 중요한 보장 사항이 추가되어 있습니다. "가져오기는 기존 에이전트 설정을 변경하거나 삭제하지 않습니다."

따라서 Claude Code에 있는 Skills의 경우, 임포터를 가장 먼저 시도해 보아야 합니다. Claude 앱에서 만든 Skills의 경우, 가져오기 문서에서 Claude 앱을 소스로 명시하지 않고 있습니다. Cowork를 사용하는 경우 데스크톱 앱의 가져오기 항목 목록에서 무엇을 제공하는지 확인하세요. 목록에 없는 항목은 Skill을 다운로드하여 수동으로 설치해야 합니다.

Claude Code 플러그인(Skills와 hooks, MCP 서버를 번들로 묶을 수 있는)을 임포터가 처리하는 방식은 Claude Code 플러그인을 Codex로 마이그레이션하기 가이드에서 다루었습니다.

Codex가 Skills를 읽는 위치

Codex는 다음 네 가지 유형의 위치에서 Skills를 읽습니다.

  • 리포지토리(Repository): 현재 폴더 및 리포지토리 루트까지의 모든 상위 폴더에 있는 .agents/skills.
  • 사용자(User): 모든 리포지토리에서 사용하려는 Skills를 위한 $HOME/.agents/skills.
  • 관리자(Admin): 공유 시스템 위치인 /etc/codex/skills.
  • 시스템(System): skill-creator 및 skill-installer를 포함하여 Codex에 번들로 제공되는 Skills.

경로는 Claude Code와 다릅니다. ~/.claude/skills/에 있는 개인용 Claude Code Skill은 Codex의 ~/.agents/skills/에 매핑됩니다. .claude/skills/에 있는 프로젝트 Skill은 리포지토리의 .agents/skills/에 매핑됩니다.

Codex는 중복된 이름을 처리하는 방식도 다릅니다. 문서에 따르면 "두 Skill이 동일한 name을 공유하는 경우, Codex는 이를 병합하지 않으며 두 가지 모두 Skill 선택기에 나타날 수 있습니다." Skill을 가져온 후 동일한 것을 수동으로 복사하면 두 개가 생길 수 있습니다.

유지되는 frontmatter 필드

이 부분에서 실제 수정 작업이 이루어집니다.

Anthropic의 문서는 Skill frontmatter를 두 그룹으로 나눕니다. Claude Code는 긴 필드 목록을 허용합니다. 하지만 claude.ai Skill 업로드 및 Skills API의 경우 name, description, license, compatibility, metadata, allowed-tools의 6가지만 허용됩니다.

이는 유용한 결과를 낳습니다. Claude 앱에 업로드한 Skills는 이미 공유 형식을 사용하고 있으므로, 수정이 거의 필요하지 않습니다.

Claude Code용으로 작성된 Skills는 argument-hint, disable-model-invocation, paths, context, model, effort, hooks와 같이 Claude Code만 작동하는 필드를 사용할 수 있습니다. Codex 문서는 name과 description을 요구하며 다른 필드에 대해서는 설명하지 않으므로, Codex에서 해당 필드들이 작동할 것이라고 기대하지 마세요.

일부 필드는 Codex에 상응하는 기능이 있습니다.

  • disable-model-invocation: true: Claude가 스스로 Skill을 호출하지 못하게 합니다. Codex에서는 agents/openai.yaml 파일에서 allow_implicit_invocation을 false로 설정하여 동일한 효과를 낼 수 있습니다. OpenAI 문서에 따르면, 이렇게 하면 Codex가 Skill을 암시적으로 호출하지 않으며, 명시적 호출은 여전히 작동합니다.
  • 누락된 name: Claude Code에서는 폴더 이름을 기본값으로 사용하므로 작동합니다. 하지만 Codex는 이를 필수적으로 요구하므로 이름을 추가해야 합니다.

수정하는 김에 설명(description)도 확인하세요. Codex는 많은 Skills가 설치되어 있을 때 설명을 축약하며, 문서에서는 다음과 같이 권장합니다. "설명이 축약되더라도 호스트가 Skill을 매칭할 수 있도록 핵심 사용 사례와 트리거 단어를 앞부분에 배치하세요."

본문(Body)에서 이전되지 않는 항목

Claude Code는 다른 도구가 지원하지 않는 Skill 지침 내 기능을 지원합니다. Anthropic 문서는 이를 다음과 같이 명시합니다. "동적 컨텍스트 주입과 같은 Claude Code 전용 본문 기능은 claude.ai 채팅이나 API를 통해 작동하지 않습니다."

Codex로 이동할 때도 동일하게 적용됩니다. 다음 항목들을 확인하세요.

  • 출력을 주입하는 셸 라인: 명령어 앞에 느낌표(!)를 붙여 작성합니다. Claude Code는 Skill이 로드되기 전에 이를 실행합니다.
  • 플레이스홀더: ${CLAUDE_PROJECT_DIR} 및 인자 대체(argument substitutions) 등.
  • 파일 참조: Claude Code가 첨부하는 @ 기호가 붙은 파일 참조.

- OpenAI의 가져오기 문서는 가져오기 후 검토해야 할 항목으로 동일한 범주를 나열합니다. "인자, 셸 보간(interpolation) 또는 파일 경로 플레이스홀더에 의존하는 프롬프트 템플릿 또는 명령어 스타일 프롬프트." 이러한 항목들은 일반 지침으로 재작성하거나, 명령어를 Skill의 scripts/ 폴더에 있는 스크립트로 옮기고 Codex에 실행 시점을 지시하도록 수정하세요.

Codex에서 Skills 켜고 끄기

Skills를 배치한 후, 일부는 사용 가능하지만 조용히 유지하고 싶을 수 있습니다. Codex는 ~/.codex/config.toml의 [[skills.config]] 항목을 사용하여 삭제하지 않고도 Skill을 비활성화할 수 있게 해줍니다. 각 항목은 경로로 특정 Skill을 가리키거나 지정된 이름의 모든 Skill과 매칭하여 비활성 상태로 설정합니다. OpenAI 문서는 하나 이상의 항목이 Skill과 매칭될 경우 마지막으로 매칭된 항목이 우선한다고 덧붙입니다.

추가한 Skill이 나타나지 않는 경우, 문서에 따르면 Codex는 Skill 변경 사항을 자동으로 감지하지만, "업데이트가 나타나지 않으면 Codex를 재시작하세요"라고 안내합니다. 구성 파일을 변경한 후에도 동일하게 적용됩니다.

Skills 내부의 도구 권한

Claude Code의 allowed-tools 필드는 Skill을 호출하는 턴에 대해 도구를 사전 승인합니다. OpenAI의 가져오기 문서는 "가져온 Skills 및 에이전트의 도구 제한 또는 권한"을 가져오기 후 검토해야 할 사항으로 나열합니다.

Codex는 샌드박싱, 승인 및 명령어 규칙을 포함한 자체 권한 모델을 가지고 있습니다. Claude Code에서 프롬프트 없이 실행되던 Skill이 Codex에서는 승인을 요청할 수 있습니다. 더 넓은 규칙을 추가하여 조용하게 만들기 전에, 그것이 원하는 동작인지 결정하세요.

워크스페이스 Skills 및 공유

ChatGPT에서도 Skills를 사용하는 경우, OpenAI의 Skill 제어 문서는 ChatGPT 워크스페이스 Skills, 로컬 파일 시스템 Skills, 플러그인의 세 가지 종류를 구분합니다. 그리고 다음과 같이 경고합니다. "Skill을 이동해도 ChatGPT 워크스페이스 소유권, 공유, 역할 할당, 플러그인 설치 상태 또는 커넥터 권한 부여는 이전되지 않습니다."

따라서 팀이 Claude에서 공유한 Skill은 Codex에서 공유된 상태로 도착하지 않습니다. 팀에게 동일한 Skill을 제공하려면, OpenAI 문서는 Codex와 ChatGPT 모두에서 작동하는 플러그인으로 패키징할 것을 권장합니다.

사람들이 흔히 먼저 시도하는 실수

Skills를 ~/.codex에 복사하기. Codex는 사용자 Skills를 ~/.agents/skills에서 읽습니다.

임포터가 Claude 앱 Skills를 찾을 것이라 기대하기. 해당 Skills는 다운로드하여 수동으로 설치해야 합니다.

Claude Code 전용 필드 유지하기. Codex는 name과 description을 요구하며 나머지는 설명하지 않습니다.

셸 주입 라인을 그대로 두기. 이는 Claude Code 전용 기능입니다.

동일한 Skill을 가져오고 복사하기. Codex는 두 가지를 모두 유지합니다.

수동 마이그레이션 단계

1단계: Claude Skills 목록 작성

Claude 앱의 Skills 목록, ~/.claude/skills, 그리고 각 리포지토리의 .claude/skills를 확인하세요.

2단계: Claude Code Skills에 대해 임포터 실행

Codex CLI에서 /import를 사용하거나, ChatGPT 데스크톱 앱 설정에서 Import를 사용하세요.

3단계: Claude 앱 Skills 다운로드

각 커스텀 Skill의 상세 페이지에서 저장하고 압축을 풉니다.

4단계: 각 Skill을 Codex가 읽는 위치에 배치

개인용 Skills는 ~/.agents/skills를, 리포지토리 Skills는 .agents/skills를 사용하세요.

5단계: frontmatter 편집

name과 description을 유지하고, 호출 설정은 agents/openai.yaml로 이동하세요.

6단계: Claude Code 전용 본문 기능 재작성

셸 주입 및 플레이스홀더를 지침이나 스크립트로 교체하세요.

7단계: 각 Skill 테스트

$ 또는 /skills로 호출한 다음, 일치하는 요청이 이를 트리거하는지 확인하세요.

더 나은 방법: Skills 뒤의 의도를 한 곳에 유지하기

Skill은 작업을 수행하는 방법을 기록합니다. 하지만 릴리스 노트가 왜 그런 구조를 따르는지, 어떤 리뷰어가 규칙을 요청했는지, 또는 특정 단계가 어떤 예외 상황을 처리하는지와 같은 그 뒤의 의도(reasoning)는 파일에 없을 수 있습니다. 파일이 새 도구로 이동하면 단계는 전달되지만, 논리적 근거는 누군가의 기억 속에만 남게 됩니다.

MemoryLake는 컨벤션, 결정 사항, 워크플로우 뒤의 이유와 같은 작업 컨텍스트를 위한 메모리 레이어입니다. 이를 한 곳에서 관리하며 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트에서 활용할 수 있습니다.

여러분은 자신의 언어로 직접 항목을 작성합니다. Claude Skills, Codex Skills 폴더, config.toml, 플러그인 또는 어떤 벤더의 스토어에서도 데이터를 읽거나 쓰거나 삭제하지 않습니다. Skills는 Anthropic과 OpenAI가 설명하는 방식 그대로 작동합니다.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 리포지토리 외부에 저장하세요.

에이전트에서 사용하기 위해 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔
에이전트에서 사용하기 위해 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔

2단계: 첫 번째 메모리 업로드

수동 마이그레이션의 1단계에서 나열한 Skills부터 시작하세요. 각 Skill에 대해 용도가 무엇인지, 왜 해당 규칙이 존재하는지 적으세요. 항목당 하나의 Skill을 작성합니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리가 되는 과정을 보여주는 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리가 되는 과정을 보여주는 MemoryLake 워크스페이스

3단계: AI 및 에이전트 연결

Codex, Claude Code 및 사용하는 다른 어시스턴트를 연결하세요. 어떤 도구에서 Skill을 실행하든 동일한 논리적 근거를 활용할 수 있습니다.

메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크를 나열한 MemoryLake 통합 화면
메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크를 나열한 MemoryLake 통합 화면

실제적인 변화

첫 번째 차이점은 편집이 쉬워진다는 것입니다. 규칙이 왜 존재하는지 알면, Codex용으로 재작성할 때 그 의미가 유지되는지 판단할 수 있습니다.

두 번째는 Skills가 더 깔끔해진다는 점입니다. 빠르게 변하는 사실들은 SKILL.md에서 분리하여 별도로 업데이트하는 노트에 보관할 수 있습니다.

세 번째는 도구 간의 일관성입니다. Claude Code와 Codex를 병행해서 사용하는 동안 동일한 논리적 근거를 두 곳 모두에서 사용할 수 있습니다.

Claude Skills를 Codex로 이동하기 위한 모범 사례

임포터부터 시작하세요. Claude Code Skills를 처리하며 Claude 설정은 변경하지 않습니다.

앱 Skills를 원본으로 취급하세요. Claude Code의 동기화된 복사본은 다시 저장되지 않습니다.

공유 필드를 사용하세요. name과 description은 두 도구 모두에서 작동합니다.

설명을 앞부분에 배치하세요. Codex가 설명을 축약할 수 있습니다.

중복된 이름을 피하세요. Codex는 이를 병합하지 않습니다.

공유 Skills는 플러그인으로 패키징하세요. 공유 설정은 파일과 함께 이동하지 않습니다.

결론

Claude와 Codex는 동일한 개방형 형식을 기반으로 Skills를 구축하므로, SKILL.md 파일이 포함된 Skill 폴더는 대부분 호환됩니다. Codex 임포터는 Claude 설정을 변경하지 않고 Claude Code Skills와 슬래시 명령어를 가져오며, Claude 앱에서 만든 Skills는 직접 다운로드하여 ~/.agents/skills 또는 리포지토리의 .agents/skills에 배치해야 합니다.

Claude 앱에 업로드된 Skills는 이미 공유 필드를 사용하고 있습니다. Claude Code용으로 작성된 Skills는 frontmatter를 다듬고, 호출 설정을 agents/openai.yaml로 옮기며, 셸 주입과 같은 Claude Code 전용 기능을 재작성해야 할 수 있습니다. 공유, 소유권 및 커넥터 권한 부여는 파일과 함께 이동하지 않으므로 별도로 계획하세요.

자주 묻는 질문

Codex에서 Claude Skills를 사용할 수 있나요?

네. 둘 다 개방형 에이전트 Skills 표준을 기반으로 하므로, SKILL.md 폴더는 약간의 수정을 거쳐 이동할 수 있습니다.

Codex가 Claude에서 Skills를 가져오나요?

Codex 임포터는 Claude Code Skills를 가져옵니다. Claude 앱의 Skills는 직접 다운로드하여 추가해야 합니다.

Codex용 Skills는 어디에 두어야 하나요?

개인용 Skills는 ~/.agents/skills에, 리포지토리용은 .agents/skills에 두세요.

Claude에서 Skill을 어떻게 다운로드하나요?

Skills 목록에서 해당 Skill의 상세 정보를 열고 다운로드하세요.

Codex에 필요한 frontmatter는 무엇인가요?

name과 description이 필수입니다.

Codex가 Skill을 자동으로 사용하지 않게 하려면 어떻게 하나요?

Skill의 agents/openai.yaml에서 allow_implicit_invocation을 false로 설정하세요.

가져오기를 하면 Claude Code 설정이 변경되나요?

아니요. OpenAI는 가져오기가 기존 설정을 변경하거나 삭제하지 않는다고 명시하고 있습니다.