Codex Control 설치와 지원
Elgato Marketplace에서 설치하세요. OpenAI나 Elgato의 공식 제품이 아닌 독립 연동 도구입니다.
사용 조건
macOS 13 이상, Stream Deck 7.1 이상, 번들 CLI가 포함되어 있고 로그인된 상태로 실행 중인 Codex Desktop이 필요합니다. 모델, 추론 강도와 Fast 지원 여부는 계정에 따라 다릅니다. Windows와 다이얼 조작은 지원하지 않습니다. 앱 업데이트에 따라 호환성이 달라질 수 있으며, 플러그인 버전에 따라 제공 옵션이 다를 수 있습니다.
설치와 설정
- Marketplace에서 플러그인을 설치하세요. 설치 파일이 이미 있다면 .streamDeckPlugin 파일을 더블클릭해 설치하거나 업데이트합니다.
- 15키 Stream Deck에서 플러그인 1.5.5 이상을 사용한다면 편집 가능한 무료 Codex Control Starter 프로필이 포함됩니다. Stream Deck에 설치 안내가 나오면 설치하고 프로필 메뉴에서 직접 선택하세요. 현재 프로필을 자동으로 교체하거나 활성화하지 않습니다. 이전 버전이나 다른 기기에서는 Preset, Model, Effort, Fast Mode, Task 또는 Status 동작을 키에 직접 추가하세요.
- 기본 프로필의 가운데 줄은 GPT-6 Luna·Sol·Astra와 Astra MAX 프리셋, 아래 줄은 Medium·High·XHigh·MAX 추론 강도를 선택합니다. 위 줄에는 작업 이동, Fast 전환과 상태 새로고침이 있습니다. Model·Effort·Fast는 각 항목만 바꾸며, 중간 조합이 지원되지 않을 때는 Preset으로 모델과 추론 강도를 함께 변경하세요.
- Current window를 사용하려면 macOS 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 Stream Deck을 허용하고, Codex의 Copy deeplink 단축키 Command-Option-L을 유지한 뒤 대상 작업 창을 앞으로 가져오세요. 직접 구성한 키에는 Selected on Deck 또는 고정 로컬 작업을 선택할 수도 있습니다.
- 실제 Stream Deck 키를 눌러 적용합니다. 프로필 설치나 버튼 설정 편집은 구성을 저장할 뿐 Codex 작업에 바로 적용하지는 않습니다.
모델, 추론 강도와 Fast 변경은 다음 턴부터 적용되며 진행 중인 응답을 바꾸지 않습니다. 플러그인은 프롬프트를 전송하지 않습니다. 작업은 열려 있고 접근 가능한 상태여야 합니다. 모든 비활성 작업에 대한 물리 버튼 조작을 포괄적으로 검증한 것은 아닙니다.
키가 이전 설치본에 연결돼 있습니다
Codex Control을 설치하거나 업데이트해도 이미 설치하고 편집한 기본 프로필을 포함해 기존 프로필은 유지됩니다. 개발용 빌드나 다른 플러그인 식별자의 키를 자동으로 연결하지 않습니다. 공개 플러그인이 최신이어도 그 키는 이전 설치본을 계속 실행할 수 있습니다.
Stream Deck의 현재 Codex Control 그룹에서 동작을 다시 추가하고 모델, 추론 강도, Fast 모드와 대상 작업을 설정하세요. 공개 플러그인 식별자는 com.oddfin.codex-control이며 웹사이트의 Oddfini 이관으로 바뀌지 않습니다. 기본 프로필에서 새 모델을 사용하려면 아래 안내대로 저장된 Model 키를 편집하세요.
새 모델이 보이지 않습니다
저장된 Model과 Preset 키는 선택한 모델을 그대로 유지하며 새로 출시된 모델로 자동 변경되지 않습니다. Stream Deck에서 키를 선택하고 모델·작업 목록을 새로고침한 뒤 로그인 계정에서 제공하는 모델을 선택하세요. Model 또는 Effort 키에서 지원되지 않는 중간 조합 오류가 나오면 Preset 키로 두 값을 함께 바꾸세요. 현재 창의 상태는 키를 누를 때 읽으며 활성 상태 표시는 잠시 후 만료됩니다.
GPT-6.1 Sol을 사용하려면 새로고침한 목록에서 정확한 모델 ID를 선택하세요. 심사 제출한 1.5.12 업데이트의 기본 프로필은 GPT-6.1 Sol을 사용하며, 이전 Sol 키는 직접 바꾸기 전까지 GPT-6 Sol을 유지합니다. DEFAULT는 해당 모델의 기본 추론 강도를 사용하는 작업이라는 뜻입니다.
심사 제출한 업데이트의 표시
1.5.12는 2026년 10월 7일 기준 Marketplace 심사 대기 중입니다. Model 키는 MODEL 제목과 평상시 표시하던 APPLY 문구 없이 세대·이름을 크게 중앙에 표시합니다. Fast는 ON/OFF 상태와 번개 심볼을 사용합니다. Effort 키는 단계 이름과 막대를 표시하며 Ultra가 제공되면 한 단계가 추가됩니다.
Current window 작업 키는 상태를 읽거나 설정을 바꾼 뒤 마지막으로 확인한 모델·추론 강도·Fast를 표시합니다. READ HH:MM은 최근 조회를 뜻합니다. 5초 뒤 흐린 LAST HH:MM으로 바뀌면 과거 조회 결과이며 현재 설정을 보장하지 않습니다. 작업 키를 다시 눌러 새로 읽으세요. 조회 실패, 작업 이동과 플러그인 재시작 시 요약이 지워집니다.
Current window가 반응하지 않습니다
Stream Deck의 손쉬운 사용 권한을 확인하세요. 대상 Codex 작업 창을 앞으로 가져온 뒤 키를 다시 누르세요. Codex의 Copy deeplink 단축키는 Command-Option-L로 유지하세요. 원격 작업은 Codex에서 이미 접근 가능해야 합니다. 설정 적용 전에 캡처한 작업이 바뀌면 플러그인이 중단합니다.
현재 창 설정 입력은 순서대로 대기할 수 있으며 QUEUED는 보관된 입력을 뜻합니다. 최대 8개가 10초 동안 대기할 수 있습니다. 작업 전환, 클립보드 캡처, 탐색 또는 대기열 포화로 입력이 중단될 수 있습니다.
심사 제출한 1.5.12 업데이트는 Marketplace 설치본의 현재 창 도우미와 최신 Codex Desktop의 CLI 검색 수정도 포함합니다. 도우미 또는 CLI를 찾지 못하면 Marketplace에서 설치 가능한 버전을 확인하세요. 같은 이전 설치본을 다시 설치해도 해결되지 않을 수 있습니다. 승인 대기 중에는 Selected on Deck 또는 고정 로컬 작업으로 창 도우미를 거치지 않을 수 있으며 정상 동작하는 Codex CLI가 필요합니다.
키에 SELECT TASK가 표시됩니다
Stream Deck의 버튼 설정을 열고 Select a task for the Deck에서 최근 로컬 작업을 선택한 뒤 Select and open을 누르세요. 마지막으로 직접 선택한 작업은 플러그인이 재시작되면 복원됩니다.
작업이 열리지 않거나 설정이 적용되지 않습니다
Codex Desktop을 실행한 상태로 유지하세요. 버튼 설정에서 대상 작업을 다시 선택해 열고, 필요하면 작업 목록을 새로고침하세요. 설정 패널의 오류를 확인하세요. 모델이나 추론 강도를 사용할 수 없다면 목록을 새로고침하고 로그인 계정이 지원하는 값을 선택하세요. 프리셋이 이용 권한을 추가하지는 않습니다.
개인정보와 클립보드
현재 창 모드는 작업 링크를 복사하기 위해 클립보드를 잠시 사용하며, 중간에 다른 변경이 없으면 지원되는 이전 내용을 복원합니다. 클립보드 기록 앱에는 임시 링크가 남을 수 있습니다. 현재 공개 개인정보처리방침을 확인하세요.
문제 제보
도움이 필요하거나 문제를 제보하려면 [email protected]으로 이메일을 보내 주세요. Stream Deck 앱·플러그인 버전, macOS 버전, 버튼 동작, 대상 모드(Current window, 고정 작업, Selected on Deck)와 정확한 오류를 포함해 주세요. 작업 대화, 작업 링크, 인증정보와 개인정보는 보내지 마세요. 답변을 위해 Gmail을 통해 이메일 주소, 메시지와 첨부파일을 받습니다. 이메일 처리는 사이트 개인정보 안내를 참고하세요.
게임 문의는 TERATORN 지원을 이용하세요.