모델 정렬에 관하여

Codex 모델 선택기는 opencodex 설정에 적힌 프로바이더 선언 순서나 모델 배열 순서를 보존하지 않습니다. 최종 순서는 카탈로그 priority로 정해지며, 같은 priority를 가진 라우팅 모델에는 결정적인 알파벳순 정렬이 적용됩니다.

Codex가 적용하는 규칙

Codex의 models-manager는 선택기에 표시되는 카탈로그 항목을 priority 오름차순으로 정렬합니다. 카탈로그 배열 순서는 버리므로 생성된 JSON 배열에서 항목을 앞으로 옮겨도 선택기에서는 앞으로 이동하지 않습니다. 이 제약은 src/codex/catalog.ts:881-884에 직접 기록되어 있습니다.

따라서 opencodex는 배열 위치가 아니라 더 낮은 priority를 부여해 featured 위치를 제어합니다. 관련 priority는 다음과 같습니다.

카탈로그 항목	Priority	근거
subagentModels[i]	i (0부터 4)	src/codex/catalog.ts:885-896의 featured rank map
그 밖의 라우팅 모델	5	src/codex/catalog.ts:892-896의 라우팅 항목 생성
기본 네이티브 GPT slug	9	src/codex/catalog.ts:887-890의 네이티브 항목 생성
featured 목록이 있을 때 선택되지 않은 네이티브 모델	최소 featured.length + 100	src/codex/catalog.ts:1348-1355의 네이티브 카탈로그 병합

관리 API는 src/server/management-api.ts:626-634의 slice(0, 5)로 subagentModels를 최대 5개로 제한합니다. 이는 처음 5개 모델 override만 광고하는 Codex spawn_agent 서피스와 맞습니다. 5개 밖의 모델도 메인 선택기에 계속 표시될 수 있고 정확한 id로 호출할 수 있습니다.

같은 priority 안에서의 순서

일반 라우팅 모델은 모두 priority 5이므로 동률 정렬이 필요합니다. 카탈로그 항목을 만들기 전에 gatherRoutedModels()가 라우팅 모델 목록을 프로바이더 이름순, 그다음 모델 id순으로 알파벳 정렬합니다 (src/codex/catalog.ts:1241-1270).

따라서 다음 설정의 순서는 최종 정렬에 영향을 주지 않습니다.

• providers 객체에서 key를 선언한 순서
• 각 프로바이더의 models 배열에 id를 적은 순서

그다음 orderForSubagents()가 stable sort를 사용해 featured 모델을 subagentModels에 적힌 순서대로 앞으로 옮깁니다. featured가 아닌 모델은 앞에서 정해진 프로바이더/id 알파벳 상대 순서를 유지합니다 (src/codex/catalog.ts:1307-1321). 항목 생성 시 featured rank도 priority 0부터 4로 변환되므로 Codex의 priority 정렬에서도 이 선두 순서가 보존됩니다.

노출 여부와 순서는 별개

selectedModels와 disabledModels는 어떤 라우팅 모델을 노출할지 정할 뿐, 정렬을 제어하지 않습니다. filterCatalogVisibleModels()는 두 선택 목록을 Set 조회로 변환하고, 배열을 rank로 사용하지 않은 채 수집된 목록을 필터링합니다(src/codex/catalog.ts:1216-1237).

따라서 selectedModels나 disabledModels의 배열 순서를 바꿔도 선택기 위치는 달라지지 않습니다. 바뀔 수 있는 것은 모델의 포함 여부뿐입니다.

최종 선택기 패턴

featured 목록이 비어 있지 않을 때 최종 순서는 다음과 같습니다.

1. 설정된 subagentModels 순서 그대로, priority 0부터 4를 받은 모델
2. 나머지 모든 라우팅 모델, 프로바이더순과 모델 id순 알파벳 정렬, priority 5
3. 카탈로그 병합 과정에서 featured 블록 아래로 밀린 선택되지 않은 네이티브 모델

subagentModels가 없으면 라우팅 모델은 priority 5를 유지하고, 네이티브 GPT 항목은 정상 priority (opencodex가 만든 항목은 보통 9)를 사용합니다. 라우팅 그룹 내부는 계속 프로바이더/id 알파벳순입니다.

예시

subagentModels에 다음 5개 id가 이 순서대로 들어 있다고 가정합니다.

subagentModels = [
  "gpt-5.5",
  "opencode-go/glm-5.2",
  "anthropic/claude-opus-4-6",
  "gpt-5.6-sol",
  "gpt-5.6-terra",
]

선택기의 시작 순서는 다음과 같습니다.

선택기 위치	모델	Priority	이 위치에 표시되는 이유
1	gpt-5.5	0	첫 번째 subagentModels 선택
2	opencode-go/glm-5.2	1	프로바이더가 anthropic보다 뒤여도 두 번째 선택이므로 이 위치에 표시
3	anthropic/claude-opus-4-6	2	세 번째 선택
4	gpt-5.6-sol	3	네 번째 선택
5	gpt-5.6-terra	4	다섯 번째 선택
6	anthropic/claude-fable-5	5	남은 라우팅 모델 중 프로바이더/id 알파벳순 첫 항목
7 이후	나머지 라우팅 모델	5	프로바이더 알파벳순, 같은 프로바이더 안에서는 모델 id 알파벳순
라우팅 모델 이후	나머지 네이티브 모델	featured.length + 100 이상	선택되지 않은 네이티브 모델은 featured 블록 아래로 이동

처음 5개 항목은 spawn_agent에 광고되는 override이며, 나머지는 일반 선택기 순서로 이어집니다.

순서를 바꾸는 방법

선두 모델 순서를 사용자가 바꿀 수 있는 유일한 지원 수단은 subagentModels를 재정렬하는 것입니다. 대시보드의 Sub-agents 페이지 또는 opencodex 설정에서 바꿀 수 있습니다. 목록은 최대 5개 모델을 받으며 배열 순서에 의미가 있습니다.

현재 OcxConfig에는 일반 modelOrder, providerOrder, priority map 설정이 없습니다. 지원되는 정렬 필드는 subagentModels입니다(src/types.ts:238-246). disabledModels와 각 프로바이더의 selectedModels는 노출 필드입니다(src/types.ts:276-282, src/types.ts:439-446). 따라서 나머지 선택기 순서를 바꾸려면 설정 수정이 아니라 코드 동작 변경이 필요합니다.