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 변경은 다음 턴부터 적용되며 진행 중인 응답을 바꾸지 않습니다. 플러그인은 프롬프트를 전송하지 않습니다. 작업은 열려 있고 접근 가능한 상태여야 합니다. 모든 비활성 작업에 대한 물리 버튼 조작을 포괄적으로 검증한 것은 아닙니다.

플러그인 식별자는 com.oddfin.codex-control로 유지됩니다. 과거 다른 게시자 식별자의 키는 다시 추가해야 합니다. 웹사이트의 Oddfini 이관은 플러그인 식별자를 바꾸지 않습니다.

새 모델이 보이지 않습니다

저장된 Model과 Preset 키는 선택한 모델을 그대로 유지하며 새로 출시된 모델로 자동 변경되지 않습니다. Stream Deck에서 키를 선택하고 모델·작업 목록을 새로고침한 뒤 로그인 계정에서 제공하는 모델을 선택하세요. Model 또는 Effort 키에서 지원되지 않는 중간 조합 오류가 나오면 Preset 키로 두 값을 함께 바꾸세요. 현재 창의 상태 표시는 키를 누를 때 읽으며 잠시 후 지워집니다.

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을 실행한 상태로 유지하세요. 버튼 설정에서 대상 작업을 다시 선택해 열고, 필요하면 작업 목록을 새로고침하세요. 설정 패널의 오류를 확인하세요. 모델이나 추론 강도를 사용할 수 없다면 목록을 새로고침하고 로그인 계정이 지원하는 값을 선택하세요. 프리셋이 이용 권한을 추가하지는 않습니다.

개인정보와 클립보드

현재 창 모드는 작업 링크를 복사하기 위해 클립보드를 잠시 사용하며, 중간에 다른 변경이 없으면 지원되는 이전 내용을 복원합니다. 클립보드 기록 앱에는 임시 링크가 남을 수 있습니다. 현재 공개 개인정보처리방침을 확인하세요.

문제 제보

도움이 필요하거나 문제를 제보하려면 oddfinilabs@gmail.com으로 이메일을 보내 주세요. Stream Deck 앱·플러그인 버전, macOS 버전, 버튼 동작, 대상 모드(Current window, 고정 작업, Selected on Deck)와 정확한 오류를 포함해 주세요. 작업 대화, 작업 링크, 인증정보와 개인정보는 보내지 마세요. 답변을 위해 Gmail을 통해 이메일 주소, 메시지와 첨부파일을 받습니다. 이메일 처리는 사이트 개인정보 안내를 참고하세요.

Codex Control 소개로 돌아가기

게임 문의는 TERATORN 지원을 이용하세요.