튜토리얼: Sol에서 Luna 에이전트 서브에이전트를 실제로 사용하는 방법
Tutorial : How to actually use Luna Agents Subagents with Sol
핵심 요약
Codex에서 Luna 서브에이전트를 활성화하기 위한 수동 설정 방법을 설명하는 가이드입니다.
- 수동 설정 가이드 — Linux와 Windows 환경에서 Luna 서브에이전트를 활성화하는 단계별 방법 제공
- 설정 파일 수정 — models_cache.json을 복사하여 multi_agent_version을 v2로 변경
- 경로 구성 — config.toml 파일에 수정된 모델 카탈로그 경로를 추가
- 주의 사항 — 원본 캐시 파일이 덮어쓰이지 않도록 반드시 복사본을 생성하여 수정
온갖 광고랑 AI가 쓴 글들로 뒤덮인 쓰레기장 뒤지느라 개고생했는데, 리눅스랑 윈도우용 정리해서 올린다.
리눅스:
- 터미널 열어라.
- Codex 폴더 있는지 확인해:
ls -la ~/.codex
- 이 파일 있는지 확인해:
ls -l ~/.codex/models_cache.json
- Codex가 수정된 파일 덮어쓰지 못하게 복사본 하나 만들어:
cp ~/.codex/models_cache.json ~/.codex/models_luna_v2.json
- 복사한 파일 열어:
nano ~/.codex/models_luna_v2.json
- Nano에서 다음을 눌러:
Ctrl+W
그다음 입력해:
gpt-5.6-luna
- Luna 섹션 안에서 이걸 찾아:
"multi_agent_version": "v1"
이렇게 바꿔:
"multi_agent_version": "v2"
- 파일 저장해:
Ctrl+O
Enter
Ctrl+X
- 파일 전체 경로를 가져와:
realpath ~/.codex/models_luna_v2.json
대충 이런 모양일 거다:
/home/yourname/.codex/models_luna_v2.json
- Codex 설정 파일을 열어:
nano ~/.codex/config.toml
- 네 실제 경로를 사용해서 이 줄을 추가해:
model_catalog_json = "/home/yourname/.codex/models_luna_v2.json"
- 저장해:
Ctrl+O
Enter
Ctrl+X
- Codex랑 VS Code 완전히 종료해.
- VS Code랑 Codex 다시 켜.
- 이제 Luna가 에이전트/서브 에이전트 모델로 뜨는지 확인해봐.
윈도우:
- 파일 탐색기 열어.
- 주소창에 이렇게 입력해:
%USERPROFILE%\.codex
그리고 엔터 쳐.
보통 이런 폴더가 열릴 거다:
C:\Users\YourName\.codex


