claude-codex-handoff은(는) 무엇을 하나요?
VS Code에서 Claude Code와 Codex를 동기화하여 컨텍스트를 유지하고, 도구를 깔끔하게 전환하며, 동일한 프로젝트 설정을 다시 작업하지 않도록 합니다.
개요
이 스킬은 VS Code 내에서 Claude Code와 Codex를 함께 사용할 때 발생하는 컨텍스트 중단 문제를 해결하기 위해 설계되었습니다. 두 도구 간에 프롬프트 히스토리, 현재 작업 중인 파일, 프로젝트 설정 등을 자동으로 동기화하여 개발자가 도구를 전환하더라도 작업 흐름이 중단되지 않도록 보장합니다.
사용 방법
- VS Code에서 확장 프로그램을 설치합니다.
- 설정 파일(
.claude-codex-handoff.json)을 프로젝트 루트에 생성합니다. - 설정에서 동기화할 항목(예: 프롬프트 히스토리, 활성 파일, 환경 변수)을 지정합니다.
- Claude Code 또는 Codex를 실행하면 자동으로 동기화가 시작됩니다.
설정 예시
{
"syncItems": ["history", "activeFile", "envVars"],
"autoSync": true,
"syncInterval": 5000
}
지원 플랫폼
- VS Code
- Claude Code (CLI)
- Codex (VS Code 확장)
주의 사항
- 동기화 주기를 너무 짧게 설정하면 성능에 영향을 줄 수 있습니다.
- 대용량 파일은 동기화 대상에서 제외하는 것이 좋습니다.
- 민감한 정보(API 키 등)는 동기화하지 않도록 설정하세요.