Codex 구독 및 게이트웨이

개인 키가 준비되면 아래에서 클라이언트를 구성하세요. 없는 경우 완료하세요. 첫 번째 요청 또는 관리자에게 회원 로그인을 요청하세요.

클라이언트 구성

개인 API 키를 생성하세요 API 키. 인스턴스 오리진 플러스 사용 /v1 기본 URL로 사용됩니다. 반환된 모델 ID 구성 GET /v1/models.

세트 SUBLANE_API_KEY 클라이언트 프로세스 환경에서. 다음 설정을 사용자 수준에 병합 ~/.codex/config.toml, 일치하는 기존 값을 대체합니다.

model = "<model-id-from-your-account>"
model_provider = "sublane"

[model_providers.sublane]
name = "SubLane"
base_url = "http://127.0.0.1:8080/v1"
env_key = "SUBLANE_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = true

네트워크 배포에는 HTTPS과 함께 인스턴스의 실제 URL을 사용하세요. HTTP/SSE 전송의 경우 다음을 설정합니다. supports_websockets = false. Codex CLI와 데스크탑은 의도된 사용자 수준 구성을 읽어야 합니다. 이미 실행 중인 데스크톱 앱은 다른 터미널에서 내보낸 환경 변수를 자동으로 상속하지 않습니다. 키를 사용할 수 있는 환경에서 다시 시작하세요.

API 키 페이지는 비밀을 삽입하거나 유지하지 않고 구성 조각을 제공합니다. 또한 선택 사항을 제공합니다. CC Switch 수입 이는 명시적인 준비 후에 선택한 키를 로컬에 설치된 애플리케이션에 전달합니다. CC Switch은 자체 Codex 인증 파일 구성을 생성합니다. 위 수동 스니펫의 환경 변수 또는 WebSocket 설정은 유지되지 않습니다. 공식 보기 고급 구성 그리고 입증 클라이언트 구성 및 자격 증명 저장소에 대한 지침입니다.

계정 카탈로그는 캐시되어 다시 시작해도 유지됩니다. 검색, 풀 집계 및 모델 인식 계정 선택은 다음 항목에 설명되어 있습니다. 모델 카탈로그.

설정 후: 메시지를 보내고 응답을 확인한 다음 계속하세요. 매일 사용. 아래의 계정, 할당량 및 프로토콜 세부 정보는 나중에 참조할 수 있습니다.

계정 추가

관리자로 로그인하여 엽니다. 계정을 선택하고 계정 추가. 구성원은 구독 관리 끝점 또는 자격 증명에 액세스할 수 없습니다.

• 브라우저 인증: 계정 이름을 지정하고 인증을 시작한 다음 OpenAI 링크를 엽니다. 로그인 후 전체 내용을 복사하세요. http://localhost:1455/auth/callback?... 브라우저 주소 표시줄에서 주소를 복사하여 SubLane에 붙여넣습니다. 이 시점에서 localhost 연결 오류가 예상됩니다. SubLane은 의도적으로 다른 콜백 리스너를 열지 않습니다. 이 수동 반환 흐름은 로컬 및 원격 배포에 적용됩니다.
• auth.json 가져오기: Codex 구독 자격 증명 파일을 선택하거나 JSON을 붙여넣습니다. 두 CLI 모두 중첩되어 있습니다. tokens 구조와 플랫 Codex 토큰 형식이 허용됩니다. 공식 API 키는 거부됩니다. SubLane 로컬 클라이언트 디렉터리를 검색하지 않습니다. 관리자가 명시적으로 제출한 콘텐츠만 읽습니다. 가져온 엔드포인트/프록시 설정은 삭제됩니다.

계정 승인/가져오기는 모델 검색을 자동으로 시작합니다. 사용 연결 확인 계정의 모델 카탈로그를 새로 고치고 유지하거나 열기 모델 그것을 검사하기 위해. 가져온 자격 증명 표시 확인되지 않음 성공적인 사용까지. 계정 메뉴에서는 활성화/비활성화, 재인증 및 제거 기능을 제공합니다. 재승인 시 동일한 업스트림 계정 ID를 유지해야 합니다. 계정을 제거하면 SubLane에 저장된 자격 증명이 삭제됩니다. ChatGPT 로그인 자체는 취소되지 않습니다.

Codex 모델 검색은 카탈로그 쿼리 및 요청 헤더에 인스턴스의 유효한 클라이언트 버전을 보냅니다. 관리자는 다음에서 이를 구성할 수 있습니다. 관리 → 시스템 설정: 명시적 버전은 마지막으로 동기화된 공식 안정 릴리스보다 우선순위를 갖습니다. 0.155.1 기본 제공 대체 항목으로 사용됩니다. 자동 릴리스 확인은 기본적으로 6시간마다 수행됩니다. 이는 Codex을 설치하거나 내장된 SDK을 업데이트하지 않고 프로토콜 메타데이터를 변경합니다. 보다 시스템 설정.

업스트림 카탈로그는 해당 버전에 따라 다릅니다. 사용되지 않는 버전은 숨겨진 모델만 있거나 부분적으로 표시되는 카탈로그가 있는 HTTP 200을 반환하여 비어 있거나 불완전한 카탈로그를 생성할 수 있습니다. /v1/models 가시성 필터링 후 목록. 지속형 카탈로그에는 실제 검색 버전이 포함되므로 유효 버전을 변경하면 타임스탬프가 최신 상태로 유지되는 경우에도 다음 카탈로그 읽기 또는 모델 요청 시 새로 고침이 트리거됩니다. 풀 권한을 변경해도 이 호환성 문제가 해결되지 않습니다.

OAuth 시도는 PKCE, 256비트 무작위 상태, 10분 만료, 관리자 브라우저 세션당 1회의 활성 시도, 최대 8회의 보류 시도를 사용합니다. 콜백은 콜백을 시작하고 코드를 교환하기 전에 사용된 세션에 바인딩됩니다. 양식을 닫으면 취소가 요청됩니다. 만료는 연결이 끊어진 후의 대체입니다. PendingOAuth 상태는 메모리에만 유지됩니다.

구독 사용량

계정 화면에는 활성 Codex 계정의 할당량 창, 잔여 비율, 재설정 카운트다운, 관측 시각과 보고된 추가 모델 제한이 표시됩니다. 카드 수는 별도 항목으로, 알 수 없음과 명시적 0을 구분합니다. 목록과 선택적 사용은 재설정 카드를 참조하세요. 누락 정보는 알 수 없음으로 유지하며 갱신 실패 시 이전 스냅샷과 경고를 표시합니다. 재설정 시각 도달만으로 회복을 판단하지 말고 사용량을 새로고침하세요.

사용법 접합기는 읽습니다 https://chatgpt.com/backend-api/wham/usage 그리고 별도 https://chatgpt.com/backend-api/wham/rate-limit-reset-credits endpoint, 일치 - 한국어 Codex 백엔드 클라이언트. 두 요청은 선택된 계정의 자격, 기존의 새로 고침 / 복원 소유자, 경계 게이트웨이 입학, 공유 된 20 초 마감일 및 응답 당 128 KiB 경계를 사용합니다. 재설정 카드 세부 사항 요청이 실패하거나 omits가 카운트를 중단하면, 할당량은 사용할 수 있으며 사용 응답의 모든 유효 카운트가 유지됩니다. 정상적인 할당량 필드와 카운트가 반환됩니다. 원 업스트림 메타 데이터, 카드 ID 및 자격은 제외됩니다. 이 백엔드 계약은 독립적으로 진화 할 수 있습니다. SubLane.

통합 스키마 매장 하나 경계, 정상화 된 할당량 및 계정 당 재설정 카드 스냅 샷 SQLite. Snapshots는 마지막 성공적인 관측 시간과 생존 과정 재시작을 포함합니다; 그것의 스냅샷에 계정 캐스케이드를 삭제. 과정은 메모리와 lazily에 있는 최대 100개의 스냅샷 항목에 유지하여 그들로부터 재로드합니다. SQLite. credentials 또는 익지않는 공급자 응답은 이 테이블에서 저장됩니다.

GET /api/accounts/{id}/usage 최대 2 분 동안 신선한 스냅 샷을 반환합니다 (또는 곧 다시보고 될 때까지). 만료 된 스냅 샷은 즉시 반환됩니다 stale 그리고 refreshing 배경이 새로워진 동안 flags. 스냅샷 없이 첫 번째 fetch가 결과가 기다립니다. POST /api/accounts/{id}/usage/refresh 새로움을 우회하고 공유 새로 고침을 기다립니다. 5초의 재사용 대기시간을 기념하면서. 두 루트 모두 활성화된 관리자 세션이 필요합니다. POST는 기존의 원산지/가 필요합니다.JSON 기타 제품

동일한 계정의 동시 호출기는 하나의 상류 작동을 공유합니다. 새로 고침은 설정된 워크스페이스 작업 용량(기본 128, SUBLANE_GATEWAY_CAPACITY) 및 45-second overall 마감을 사용하여 개별 브라우저를 차단하고 프로세스 종료 중에 취소 / 처리됩니다. 실패는 이전 값과 타임스탬프를 보존하고, 30 초 동안 다시 종료합니다 (또는 더 긴 유효 업스트림 재량 후, 최대 1 시간). 입학 포화는 5 초 재량으로 유지됩니다. Cshot-local은 여전히 성공적이지 않고도 성공적이지 않습니다.

브라우저는 1 분 쿼리 신선도 기간을 유지. 그것은 다시 한 번 로컬 스냅 샷 엔드 포인트를 polls, 완료 또는 네트워크 오류에 중지. 페이지는 정기적으로 idle 동안 공급자를 오염하지 않습니다. 공유 할당 설정된 토큰 또는 내부 USD 예산 및 책임은 직접 요청 사용법을보고. 관찰 타임스탬프 및 응답 서버 시간은 별도이므로 복원 된 스냅 샷은 재설정 카운트 다운을 다시 시작하지 않습니다. 비활성화 된 계정은 정복되지 않습니다. 모델 트래픽도 대기없이 공유 할당량 캐시를 따뜻하게합니다. 신선한 주요 제한 배기는 새로운 선택에서 계정을 제외합니다. 경계 대화는 할당량 별 거부를 반환합니다. 업스트림 사용 제한은 가입을 설명하고 회원의 자원 허용이 아니라. 참조 quota aware 선택.

재설정 카드

워크스페이스 관리자는 활성화되어 있고 재인증이 필요 없는 Codex 계정의 카드를 조회하고 사용할 수 있습니다. 일반 멤버에게는 관리 권한이 없습니다. 예약 사용과 할당량 소진 시 사용은 기본적으로 꺼져 있으며, 목록 조회나 새로고침은 카드를 소비하지 않습니다.

설정과 사용

1. 계정 화면의 Codex 계정 카드에서 재설정 카드 설정을 열고 목록, 사용 가능 수, 관측 시각을 확인합니다. 알 수 없는 수와 0은 다릅니다.
2. 예약 사용, 할당량 소진 시 사용 또는 둘 다 켭니다. 일회성 예약은 미래 날짜와 시각, 매일 예약은 시각, 매주 예약은 요일과 시각을 지정하고 표시된 인스턴스 시간대를 확인합니다.
3. 공통 일일 한도(1~100장, 기본 1장)를 저장하고 저장 완료 메시지와 다음 예약 시각을 확인합니다.
4. 수동 사용 전에는 변경을 저장한 뒤 지금 한 장 사용을 선택합니다. 시도당 최대 한 장이며 결과는 실행 기록에서 확인합니다. 설정을 여는 것만으로는 교환하지 않습니다.

목록과 만료 우선순위

목록에는 이름, 상태, 지급 시각, 만료 시각이 표시됩니다. 사용 가능, 교환 중, 사용 완료, 만료, 알 수 없음, 미지원 유형을 구분하며 원본 카드 ID는 표시하지 않습니다. 다음 사용 표시는 자동 선택 순서이며 수동 선택 기능은 없습니다. 결과 확인 대기 중에는 이 표시를 숨깁니다. 수가 양수라도 적격 카드가 있다는 보장은 없습니다.

새로운 수동·예약·소진 시도는 목록을 다시 읽고 credit_id를 명시합니다. 지원되며 사용 가능하고 만료되지 않은 카드 중 가장 먼저 만료되는 카드를 선택하고, 만료일이 없는 카드는 마지막에 둡니다. 만료가 같으면 먼저 지급된 카드, 이어서 안정적인 ID 순서를 사용합니다. 적격 카드가 없거나 목록을 확인할 수 없으면 건너뛰며 공급자의 기본 선택에 맡기지 않습니다. 최초 로드 실패와 빈 목록은 별개입니다. 새로고침 실패 시 경고와 이전 목록을 유지하므로 카드 새로고침으로 재시도합니다.

예약과 제한

소진 모드는 백그라운드에서 약 1분마다 확인하며 최신 할당량 정보, 알려진 양수 카드 수, 기본 할당량의 명시적 사용 거부가 필요합니다. 100% 표시, 알 수 없는 정보, 네트워크 오류만으로는 실행하지 않습니다. 수동 및 예약 사용에도 최신 정보와 알려진 양수 카드 수가 필요합니다.

모든 모드가 인스턴스 현지 날짜 기준의 일일 한도를 공유하고 성공 및 확인 대기 시도가 횟수를 차지합니다. 비활성 또는 재인증 필요 계정은 건너뜁니다. 5분 넘게 놓친 예약은 소급 실행하지 않습니다. 서머타임으로 존재하지 않는 시각은 건너뛰고 반복되는 시간은 현지 날짜당 한 번만 실행합니다. 시간대 변경 시 미래 예약을 다시 계산하며 브라우저를 닫아도 계속 실행합니다. 데모에서는 자동 실행과 교환을 허용하지 않습니다.

결과와 복구

적격 조건과 재설정할 할당량 창은 공급자가 결정합니다. POST /backend-api/wham/rate-limit-reset-credits/consume의 인식 결과는 reset, already_redeemed, nothing_to_reset, no_credit입니다. 성공하면 할당량과 카드 수를 새로고침하지만 다른 게이트웨이 제한을 해제하거나 모든 제한의 해제를 보장하지 않습니다.

전송 전에 redeem_request_id와 선택 카드 ID를 저장합니다. 시간 초과나 알 수 없는 응답은 확인 대기로 남으며, 목록이나 만료가 바뀌어도 동일한 두 값을 재전송합니다. 수량 변화만으로 성공을 판단하지 않습니다. 이전 버전의 대기 요청은 원래의 credit_id 생략을 유지합니다. 결과 확정 후 선택 ID를 지우며 할당량 스냅샷이나 공개 실행·감사 출력에는 포함하지 않습니다. 자격 증명, 원본 응답, 공급자 프로필도 기록하지 않습니다. 계정 삭제 시 설정과 기록을 삭제합니다.

관리자 브라우저 API는 설정·기록 조회 GET /api/accounts/{id}/resets, 정규화 목록 GET /api/accounts/{id}/resets/cards, 저장 PUT /api/accounts/{id}/resets, 사용·확인 POST /api/accounts/{id}/resets/consume 또는 POST /api/accounts/{id}/resets/retry입니다. 브라우저 세션과 워크스페이스 역할이 필요하며 게이트웨이 API 키는 사용할 수 없습니다. 목록 조회는 자격 증명·프록시·계정 수명주기 검사를 재사용하고 프로필 식별자, 아바타 URL, 원본 응답을 제외합니다. 내부 계약은 바뀔 수 있으며 합성 테스트는 실제 계정의 적격성이나 실제 교환 성공을 입증하지 않습니다.

설정 변경과 성공한 수동 작업은 감사에 기록하며 자동 결과는 크기가 제한된 실행 기록에 보관합니다.

Credential 저장과 새로 고침

통합 스키마는 워크스페이스-스코프 구독 계정을 생성하고 계정 친화 레코드를 바인딩합니다. 액세스, 새로 고침 및 ID 토큰은 AES-256-GCM 및 계정 기반 인증 데이터로 암호화됩니다. 인스턴스는 개인 32-byte를 만듭니다. credentials.key 데이터베이스 옆에 파일. 키는 설정 암호가 아니며 수동 항목이 필요하지 않습니다.

데이터베이스를 백업하고 credentials.key 인스턴스를 중지 한 후 함께. 기존 계정 데이터베이스는 누락 된, 무효, 또는 잘못 된 키로 시작되지 않습니다. 액세스 복구 키를 교체하지 마십시오. 암호화 데이터베이스 전용 복사의 자격 내용을 보호합니다. 데이터베이스와 키는 해독을 허용하는 두 가지 데이터베이스에 액세스합니다.

SubLane 이 웹 사이트는 귀하가 웹 사이트를 탐색하는 동안 귀하의 경험을 향상시키기 위해 쿠키를 사용합니다. 이 쿠키들 중에서 필요에 따라 분류 된 쿠키는 웹 사이트의 기본적인 기능을 수행하는 데 필수적이므로 브라우저에 저장됩니다. 또한이 웹 사이트의 사용 방식을 분석하고 이해하는 데 도움이되는 제 3 자 쿠키를 사용합니다. 이 쿠키는 귀하의 동의하에 만 브라우저에 저장됩니다. 이러한 쿠키 중 일부를 선택 해제하면 검색 환경에 영향을 미칠 수 있습니다.

Gateway 계약

모든 게이트웨이 노선은 SubLane 브라우저 쿠키를 독립적으로 사용하는 Bearer 키:

HTTP 요청은 완전한 입력을 포함해야 합니다. HTTP previous_response_id 잃어버린 대신 침묵의 대신 거부됩니다. Codex HTTP 백엔드는 stateless입니다. WebSocket 연속 사용 경계, 연결 지역 역사; 알 수없는 오염 ID는 전체 성적 입력이 필요합니다. 모든 WebSocket 키와 회원 활성화를 다시 체크합니다. 수정 된 키는 기존의 연결에 새로운 차례를 시작할 수 없습니다.

계정 선호도는 멤버, 풀 및 클라이언트 세션/프롬프트 캐시 키로 범위가 지정되고 24시간 동안 유지되며 최대 4,096개의 바인딩으로 제한됩니다. 기본 요청은 공급자 간에 하나의 바인딩을 사용합니다. 명시적인 레거시 접두사 요청은 공급자별 바인딩을 유지합니다. 새 세션은 풀 내에서 요청된 모델을 보고하는 적격 계정에 분산되어 계정별 동시성 및 휴지 시간을 존중합니다. 세션 없는 요청은 선호도를 생성하지 않고 독립적으로 선택합니다. 업스트림 ID를 전환하는 대신 계정이 비활성화되거나 제거되면 기존 세션이 실패합니다. 의도적인 모델 변경의 경우 원래 계정이 새 모델을 제공할 수 없는 경우 전체 이동 기록에서 지원 계정을 선택할 수 있습니다. 공급자 연속은 고정된 상태로 유지됩니다. 보다 모델 라우팅. 기타 의도적인 계정 변경 후 대화를 다시 시작하세요. 요청을 재시도해도 자동으로 다른 계정으로 이동되지 않습니다.

워크스페이스별 기본값은 작업 용량 128, WebSocket 연결 8개, 요청·턴 전체 기한 30분, 추론 응답 헤더 대기 5분입니다. 대기 요청과 공유 메타데이터 작업도 용량에 포함됩니다. 요청과 재구성 문맥은 128 MiB, 응답과 이벤트는 각각 8 MiB, 본문 읽기는 30초, 공유 모델 검색은 45초로 제한됩니다. 성능 보장 수치가 아닙니다. 설정은 배포, 요청 허용과 대기 동작은 실행 동작을 참고하세요. 멤버 제한은 팀 관리를 참고하세요.

공급자 자격 증명, 브라우저 쿠키, 임의 클라이언트 헤더 및 원시 공급자 오류 본문은 구성원에게 전달되지 않습니다. 클라이언트 베어러 키는 선택한 업스트림 자격 증명으로 대체됩니다. 애플리케이션은 프롬프트, 응답, 액세스 토큰, 새로 고침 토큰 또는 OAuth 콜백 URL을 기록하지 않습니다.

검증 경계

자동화된 테스트는 임시 데이터베이스, 합성 자격 증명 및 로컬 가짜 업스트림을 사용합니다. OAuth 소유권/만료/재생, 암호화 및 키 불일치, 직렬화 새로 고침, 불변 ID, 계정 선호도, 역할/소유권 격리, 스트리밍 취소, SSE 완료 복구 및 턴 간 WebSocket 취소를 다룹니다.

옵트인 통합 테스트는 새로운 하위 프로세스 홈, 상속된 자격 증명 및 로컬 합성 모델 응답을 사용하여 설치된 Codex CLI를 실행합니다.

SUBLANE_TEST_CODEX=1 go test ./internal/server -run TestCodexCLIProtocol -count=1 -v

Codex CLI 0.152.1은 합성 업스트림에 대해 HTTP/SSE 및 WebSocket 모드를 모두 통과했습니다. 실제 구독 승인 및 라이브 모델 요청에는 명시적으로 승인된 테스트 계정이 필요합니다. 실제 데스크톱 애플리케이션은 아직 검증되지 않았습니다. 공유 구성 및 프로토콜 테스트만으로는 라이브 데스크탑 호환성을 구축할 수 없습니다.

v7 업그레이드 전 로컬 macOS arm64 미리 보기(CLIProxyAPI v6.10.9, Go 1.26.0, 프로덕션 바이너리, 암호화된 합성 계정 1개)는 2026년 9월 19일에 약 12분 동안 유휴 상태를 유지한 후 23,376KiB RSS, 약 22.8MiB를 측정했습니다. 이것은 유휴 관찰일 뿐입니다. 실제 모델, 동시성, 페이로드 크기 및 플랫폼 변경 메모리 사용. Docker Compose 구성이 로컬에서 검증되었지만 Docker 데몬을 로컬 이미지 빌드에 사용할 수 없었습니다.

실행 참조

SubLane은 CLIProxyAPI v8.0.35의 공개 실행자와 번역기를 사용합니다. internal/upstream. SubLane은 승인, 암호화된 자격 증명 저장소, 새로 고침, 계정 선택 및 공개 게이트웨이를 소유합니다. SDK은 라이브 자격 증명, 무작동 감시자, 차단된 루프백 경로 및 자동 새로 고침이 비활성화된 개인 실행자 레지스트리로 실행됩니다. 보다 건축학 실행 경계 및 공급자 설정 공급자 연결 단계의 경우. 이 가이드의 승인 및 할당량 세부정보는 Codex에 대해 설명합니다.