Codex Control 설치와 지원
Elgato Marketplace에서 설치하세요. OpenAI나 Elgato의 공식 제품이 아닌 독립 연동 도구입니다.
사용 조건
macOS 13 이상, Stream Deck 7.1 이상, 번들 CLI가 포함되어 있고 로그인된 상태로 실행 중인 Codex Desktop이 필요합니다. 모델, 추론 강도와 Fast 지원 여부는 계정에 따라 다릅니다. Windows와 다이얼 조작은 지원하지 않습니다. 앱 업데이트에 따라 호환성이 달라질 수 있으며, 플러그인 버전에 따라 제공 옵션이 다를 수 있습니다.
설치와 설정
- Marketplace에서 플러그인을 설치하세요. 설치 파일이 이미 있다면 .streamDeckPlugin 파일을 더블클릭해 설치하거나 업데이트합니다.
- Stream Deck에서 Preset, Model, Effort, Fast Mode, Task 또는 Status를 키에 끌어 놓습니다.
- 모델, 추론 강도, Fast 동작 또는 대상 작업을 설정합니다. Preset은 모델과 추론 강도를 함께 적용하고 Model과 Effort는 각각 변경합니다. Fast는 토글·항상 켜기·항상 끄기를 선택할 수 있습니다. Task는 최근 로컬 작업을 선택해 열고, Status는 설정을 표시하거나 새로고침합니다.
- Current window를 사용하려면 macOS 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 Stream Deck을 허용하고 대상 Codex 작업 창을 앞으로 가져오세요. Selected on Deck 또는 고정 로컬 작업을 선택할 수도 있습니다.
- 실제 Stream Deck 키를 눌러 적용합니다. 버튼 설정 편집은 구성을 저장할 뿐 작업에 바로 적용하지는 않습니다.
모델, 추론 강도와 Fast 변경은 다음 턴부터 적용되며 진행 중인 응답을 바꾸지 않습니다. 플러그인은 프롬프트를 전송하지 않습니다. 작업은 열려 있고 접근 가능한 상태여야 합니다. 모든 비활성 작업에 대한 물리 버튼 조작을 포괄적으로 검증한 것은 아닙니다.
플러그인 식별자는 com.oddfin.codex-control로 유지됩니다. 과거 다른 게시자 식별자의 키는 다시 추가해야 합니다. 웹사이트의 Oddfini 이관은 플러그인 식별자를 바꾸지 않습니다.
Current window가 반응하지 않습니다
Stream Deck의 손쉬운 사용 권한을 확인하세요. 대상 Codex 작업 창을 앞으로 가져온 뒤 키를 다시 누르세요. Codex의 Copy deeplink 단축키는 Command-Option-L로 유지하세요. 원격 작업은 Codex에서 이미 접근 가능해야 합니다. 설정 적용 전에 캡처한 작업이 바뀌면 플러그인이 중단합니다.
현재 창 설정 입력은 순서대로 대기할 수 있으며 QUEUED는 보관된 입력을 뜻합니다. 최대 8개가 10초 동안 대기할 수 있습니다. 작업 전환, 클립보드 캡처, 탐색 또는 대기열 포화로 입력이 중단될 수 있습니다.
키에 SELECT TASK가 표시됩니다
Stream Deck의 버튼 설정을 열고 Select a task for the Deck에서 최근 로컬 작업을 선택한 뒤 Select and open을 누르세요. 마지막으로 직접 선택한 작업은 플러그인이 재시작되면 복원됩니다.
작업이 열리지 않거나 설정이 적용되지 않습니다
Codex Desktop을 실행한 상태로 유지하세요. 버튼 설정에서 대상 작업을 다시 선택해 열고, 필요하면 작업 목록을 새로고침하세요. 설정 패널의 오류를 확인하세요. 모델이나 추론 강도를 사용할 수 없다면 목록을 새로고침하고 로그인 계정이 지원하는 값을 선택하세요. 프리셋이 이용 권한을 추가하지는 않습니다.
개인정보와 클립보드
현재 창 모드는 작업 링크를 복사하기 위해 클립보드를 잠시 사용하며, 중간에 다른 변경이 없으면 지원되는 이전 내용을 복원합니다. 클립보드 기록 앱에는 임시 링크가 남을 수 있습니다. 현재 공개 개인정보처리방침을 확인하세요.
문제 제보
GitHub Issues에서 기존 보고를 검색한 뒤 새 보고를 작성하세요. 게시에는 GitHub 계정이 필요하며 내용은 공개됩니다. Stream Deck 앱·플러그인 버전, macOS 버전, 버튼 동작, 대상 모드(Current window, 고정 작업, Selected on Deck), 정확한 오류를 포함해 주세요. 작업 대화, 인증정보와 개인정보는 게시하지 마세요. 비공개 문의는 [email protected]으로 보내 주세요. 이메일 처리에 관한 내용은 사이트 개인정보 안내를 참고하세요.
게임 문의는 TERATORN 지원을 이용하세요.