Apple의 릴리스 페이지에는 Xcode 27.1 RC가 2026년 10월 5일 공개된 것으로 기록되어 있습니다. Apple 릴리스 기록을 기준으로 해당 버전이 설치된 맥에서 기술을 내보내고 Codex CLI의 기술 폴더로 가져오세요. 다만 기술 파일이 보인다는 사실과 프로젝트 접근 권한, Xcode 빌드 성공은 각각 따로 확인해야 합니다.
증상 → 기술 파일은 가져왔지만 빌드가 검증되지 않았습니다.
빠른 해결 → 발견, 권한, 프로젝트 빌드를 차례로 따로 확인하세요.
이 글은 Codex CLI로 Swift 또는 iOS 프로젝트를 관리하면서 Xcode 에이전트 기술을 재사용하려는 독립 개발자와 소규모 팀을 위한 절차입니다.
Codex 도구와 프로젝트 권한을 맡은 사람, 로컬 맥이 없어 Xcode 환경을 마련해야 하는 개발자도 대상입니다.
마지막 확인: 2026년 10월 10일. Xcode 버전과 기술 내보내기 안내는 Apple 개발자 문서와 Xcode 27 릴리스 노트, 기술 검색과 배치 방식은 Codex 기술 안내를 기준으로 확인했습니다.
SECTION 01시작 전 환경 확인
내보내기 명령은 현재 선택된 Xcode 환경을 기준으로 확인해야 합니다. 여러 버전이 설치되어 있거나 터미널과 개발 도구의 실행 환경이 다르면, 의도한 설치본에서 기술을 내보내지 못할 수 있습니다.
| 확인 대상 | 확인 방법 | 다음 판단 |
|---|---|---|
| 실제 Xcode 버전 | xcodebuild -version 결과를 확인합니다. |
Xcode 27.1 RC를 사용할 계획이라면 출력이 그 설치본인지 확인합니다. |
| 명령줄 개발자 디렉터리 | xcode-select -p로 선택된 경로를 확인합니다. |
예상한 Xcode 설치본이 아니면 먼저 개발자 디렉터리를 바로잡습니다. |
| Codex CLI 실행 환경 | Codex CLI를 실행하는 계정과 터미널을 확인합니다. | 다른 계정으로 실행하면 기술 폴더 위치와 파일 권한이 달라질 수 있습니다. |
명령줄 도구와 Xcode 설치 관계는 Apple의 명령줄 도구 안내 및 명령줄 빌드 설명에서 확인할 수 있습니다. 기술을 내보낼 때는 작업 중인 프로젝트가 아니라, 실제로 사용할 Xcode와 명령줄 개발자 디렉터리를 먼저 맞추세요.
| 구분 | 확인할 내용 | 혼동했을 때 생기는 문제 |
|---|---|---|
| Xcode 에이전트 기술 | 작업 지침과 관련 자료가 포함된 기술 파일 | 파일만 옮겨도 프로젝트 권한이 생긴다고 오해합니다. |
| Codex CLI의 기술 검색 | Codex가 기술 폴더를 찾고 읽을 수 있는지 | 파일이 존재해도 검색 위치가 다르면 목록에 나타나지 않습니다. |
| Xcode 빌드 환경 | 프로젝트 파일, 명령 실행 권한, Xcode 도구 체인 | 기술 호출 성공을 컴파일이나 테스트 통과로 잘못 판단합니다. |
SECTION 02내보내기와 Codex 배치
Apple의 에이전트 확장 안내에서 지원 범위와 현재 버전의 명령 사용법을 확인한 뒤, 안내된 절차에 따라 xcrun agent skills export를 실행합니다. 이 명령은 Xcode 에이전트 기술을 내보내는 단계입니다. 내보내기가 끝났다고 Codex CLI에서 자동으로 발견되는 것은 아닙니다.
| 단계 | 확인할 증거 | 완료로 볼 수 있는 조건 |
|---|---|---|
| 내보내기 | 명령 출력, 실제로 생성된 경로와 폴더 내용 | 오류 없이 파일이 만들어졌으며 대상 기술의 자료가 확인됩니다. |
| 배치 | Codex CLI가 검색하는 기술 폴더와 그 안의 파일 | 기술별 폴더 안에 필요한 지침 파일과 자료가 유지됩니다. |
| 새 세션 확인 | 새 Codex CLI 세션에서 확인한 기술 목록과 호출 결과 | 기술이 검색되고, 테스트 요청에서 의도한 지침을 따릅니다. |
명령에 추가 선택 항목이나 특정 대상용 옵션이 있다고 가정하지 마세요. Apple 문서와 설치된 Xcode가 안내하는 실제 지원 범위를 확인하고, 실행 뒤에는 터미널의 성공 표시만 믿지 말고 내보낸 위치와 파일 내용을 기록해 두세요. Xcode 27 릴리스 노트의 베타 관련 안내는 그 버전과 조건에 한정해서 읽어야 합니다. 베타에서 언급된 문제나 우회 방법을 Xcode 27.1 RC의 현재 동작이라고 단정할 수는 없습니다.
가져올 때는 OpenAI의 기술 구조와 탐색 안내 및 Codex 기술 문서에서 현재 검색 위치와 발견 규칙을 확인합니다. 프로젝트에만 적용할지, 사용자 계정의 여러 프로젝트에서 사용할지 먼저 정한 다음, 해당 범위의 .agents/skills 아래에 기술별 폴더를 배치하세요. 폴더 이름만 옮기지 말고 SKILL.md와 함께 제공된 자료도 보존합니다. 배치 위치나 파일 구조가 바뀌지 않았는지 살핀 뒤 새 세션에서 다시 검색을 확인하는 편이 안전합니다.
기술이 목록에 나타나는 것은 발견 여부만 보여 줍니다. 파일 읽기, 터미널 명령 실행, Xcode 빌드 권한은 별도로 점검하고, 기술을 가져오기 위해 필요하지 않은 광범위한 권한은 열지 마세요.
SECTION 03첫 호출과 권한 분리
처음에는 코드를 수정하지 않는 요청으로 기술을 확인하세요. 예를 들어 <프로젝트 경로>의 기술 파일을 읽고 해당 기술이 요구하는 점검 항목을 요약하되, 파일 변경이나 명령 실행은 하지 말라고 요청합니다. 프로젝트 경로는 실제 작업 위치로 바꾸고, 계정이나 저장소에 대한 민감한 값은 요청문에 넣지 마세요.
| 확인 항목 | 관찰할 결과 | 실패했을 때 분리해서 볼 곳 |
|---|---|---|
| 기술 발견 | Codex CLI가 목표 기술의 이름과 지침을 읽습니다. | 기술 폴더 위치, 파일 구조, 새 세션 여부 |
| 프로젝트 접근 | 요청한 프로젝트 파일을 열어 관련 내용을 읽습니다. | 저장소 경로, 실행 계정, 파일 접근 설정 |
| 명령 실행 | 허용된 범위에서 필요한 명령을 시작합니다. | 명령 승인 방식과 실행 환경 |
| Xcode 검증 | 실제 프로젝트의 빌드 또는 테스트 로그가 생성됩니다. | Xcode 선택 경로, 프로젝트 설정, 서명 조건 |
기술을 발견했는데 호출하지 않는다면 먼저 새 세션에서 확인하고, 요청에 목표 기술과 작업 목적을 구체적으로 적으세요. 그래도 동작하지 않으면 기술의 설명과 요청 내용이 맞는지, 기술 자료가 함께 옮겨졌는지를 살핍니다. 반대로 기술 지침은 읽었지만 프로젝트 파일을 열지 못하면 검색 문제로 취급하지 말고 경로와 권한을 따로 확인하세요.
SECTION 04실제 프로젝트 검증과 환경 선택
설정 확인을 마친 뒤에는 되돌릴 수 있는 작업 브랜치나 별도 테스트 프로젝트에서 실제 빌드를 검증합니다. 기술이 지시한 작업을 수행했는지와 Xcode가 프로젝트를 빌드했는지를 분리해서 기록해야 합니다. 빌드 로그와 산출물을 확인하지 않은 상태라면 기술 호출이 성공해도 프로젝트 검증은 완료된 것이 아닙니다.
- [ ] Codex CLI가 목표 기술을 새 세션에서 찾는지 확인합니다.
- [ ] 코드를 바꾸지 않는 요청으로 기술의 지침이 적용되는지 확인합니다.
- [ ] 작업 브랜치 또는 테스트 프로젝트를 준비해 변경 사항을 되돌릴 수 있게 합니다.
- [ ] 프로젝트 파일 접근과 명령 실행 권한을 필요한 범위로 나눠 확인합니다.
- [ ] Xcode 빌드 로그와 생성된 산출물을 각각 검토합니다.
- [ ] 테스트가 필요한 프로젝트라면 테스트 결과와 빌드 결과를 따로 기록합니다.
로컬 맥이 있다면 그 환경에서 내보내기, 기술 배치, 실제 프로젝트 빌드까지 이어서 확인할 수 있습니다. 없더라도 macOS와 Xcode가 필요한 작업은 원격 맥에서 진행하는 방안을 검토할 수 있습니다. 원격 환경은 즉시 쓸 수 있는 macOS 도구 체인이라는 이점이 있지만, 네트워크 연결에 기대야 하고 파일 전송과 접근 권한을 관리해야 하며, 사용을 이어 가면 비용도 발생합니다. 반면 맥을 직접 구매하면 로컬에서 계속 쓸 수 있지만 초기 하드웨어 비용과 유지 관리를 감당해야 합니다.
독립 개발자에게는 이번 기술 내보내기와 검증처럼 기간이 정해진 작업인지, 계속 켜 둬야 하는 빌드 환경인지가 선택 기준입니다. 임시 설정이나 실제 프로젝트의 Xcode 확인이 목적이라면 요금과 이용 조건을 살펴보고, 한국에서 이용 가능한 원격 맥 구성이 필요하면 한국 이용 안내를 확인할 수 있습니다. 원격 맥에서도 기술 발견과 빌드 검증은 별개로 진행해야 합니다. Codex CLI가 기술을 읽는 것만 확인한 뒤 끝내지 말고, 프로젝트 로그와 산출물까지 직접 확인하세요.
SECTION 05자주 묻는 내용
기술을 내보내는 명령은 어디서 확인하나요?
현재 선택된 Xcode 설치본을 확인한 다음 Apple의 에이전트 확장 문서에서 지원 범위와 명령 안내를 확인하세요. 이 글에서 다루는 절차는 xcrun agent skills export를 실행하고 생성된 파일을 살피는 것입니다. 문서에 없는 옵션을 덧붙이거나 다른 Xcode에서 얻은 파일을 현재 설치본의 결과로 간주하지 마세요.
Codex CLI의 기술 폴더는 어떻게 고르나요?
Codex 공식 문서에서 프로젝트 범위와 사용자 범위의 검색 위치를 확인한 뒤, 적용 범위에 맞는 .agents/skills 아래에 기술별 폴더를 둡니다. 프로젝트 안에 둘지 계정 공통 위치에 둘지에 따라 다른 작업에서도 검색될 수 있으므로 사용 범위를 먼저 정하세요. 배치 뒤에는 새 세션에서 기술이 실제로 검색되는지 확인해야 합니다.
기술이 보이지만 작업에서 쓰이지 않을 때는 무엇을 확인하나요?
새 세션에서 다시 확인하고, 요청에 사용할 기술과 작업을 분명히 지정하세요. 다음으로 SKILL.md의 설명이 요청과 맞는지, 함께 제공된 자료가 빠지지 않았는지 확인합니다. 프로젝트 경로 접근이나 명령 권한이 막힌 경우에는 기술 검색 문제가 아니라 접근 설정 문제일 수 있으므로, 각각 다른 점검 항목으로 기록하세요.
가져온 기술로 빌드할 수 있는지는 어떻게 확인하나요?
기술 발견 결과를 빌드 증거로 사용하지 마세요. 되돌릴 수 있는 브랜치에서 실제 프로젝트 빌드를 실행하고, Xcode 로그의 결과와 생성 산출물을 확인합니다. 테스트가 필요한 경우에는 테스트 결과도 별도로 검토하세요. 로컬에 맥이 없어 Xcode를 실행할 수 없다면 원격 맥을 검토하되, 해당 환경에서도 권한과 빌드 결과를 직접 확인해야 합니다.
Xcode 기술을 Codex CLI로 가져오면 작업 지침을 재사용할 수 있지만, 프로젝트 파일 접근과 빌드 환경까지 자동으로 연결되지는 않습니다. 로컬 맥은 계속 상시 빌드를 돌리는 상황에 알맞고, 원격 맥은 로컬 장비를 마련하지 않은 채 기술 설정이나 실제 Xcode 빌드를 검증해야 할 때 살펴볼 선택지입니다. 필요한 기간과 운영 방식을 먼저 정한 뒤 MACNOX의 원격 맥 이용 조건을 검토하세요.