시스템 설정

인스턴스 설정을 변경하거나 Codex, Grok 또는 Claude 버전 호환성 문제를 조사할 때 이 기능을 사용하세요. 기본값은 시작하기에 충분합니다. 설정 가이드.

플랫폼 소유자의 확장 관리 → 시스템 설정 사이드바에서 시간대 (/admin/settings/timezone), Codex 클라이언트 버전 (/admin/settings/codex), Grok 클라이언트 버전 (/admin/settings/grok), 또는 Claude 클라이언트 버전 (/admin/settings/claude). 이전 /admin/settings 주소는 Codex 설정으로 리디렉션됩니다. 이러한 설정은 전체 인스턴스에 적용됩니다. 다른 워크스페이스 관리자 및 멤버는 이를 변경할 수 없습니다. 헤더의 환경설정 단축키는 개인용으로 유지됩니다: 테마, 언어 및 비밀번호.

인스턴스 시간대

기본값은 UTC. 다음과 같은 IANA 시간대를 입력하세요. Asia/Shanghai 작업 공간 전체에서 해당 영역의 타임스탬프를 표시하기 위해 저장합니다. 각 자원 허용량은 일일 재설정 시계 또는 선택한 영역의 월별 날짜 및 시계를 선택합니다. 기본값은 자정(월별 규칙의 첫 번째 날)입니다. 저울은 정확한 다음 재설정 시간을 보여줍니다. 일광 절약 시간제 변경은 시간대 규칙에 따라 처리됩니다. 분 요청 제한은 계속해서 고정된 60초 창을 사용합니다.

변경 사항은 즉시 적용됩니다. 기존 허용량 사용량은 새로 선택한 기간 내의 각 요청 시작 시간부터 계산되므로 영역을 변경해도 현재 사용량이 자동으로 지워지지 않습니다. 이미 예약된 할당 개정은 이전에 저장된 활성화 타임스탬프를 유지합니다. 일일 운영 요약 및 시간별 활동 표는 UTC를 기준으로 그룹화되어 있습니다. UTC 라벨은 계속 표시됩니다. 설정은 다음 위치에 저장됩니다. settings['instance.time_zone'] 변경 사항에 대한 감사를 받았습니다.

Codex 클라이언트 버전

유효한 버전은 다음 순서로 선택됩니다.

구성된 경우 명시적 수동 버전입니다.
최소한 내장된 기본값인 경우 마지막으로 동기화된 안정 버전입니다.
내장된 기본값(0.155.1).

수동 버전 사용 major.minor.patch 없이 v 접두사 또는 시험판 접미사. 입력을 지우면 자동 선택으로 돌아갑니다. 수동 핀은 의도적으로 이전 버전을 선택할 수 있습니다. 자동 동기화는 기억된 안정 버전이나 기본 제공 기준을 결코 낮추지 않습니다. 페이지에는 유효 버전, 해당 소스, 마지막으로 동기화된 버전 및 확인 타임스탬프가 표시됩니다.

안정적인 릴리스를 자동으로 따르십시오. 기본적으로 활성화되어 있습니다. 시작 시 서비스는 예정된 일정을 확인하고 그렇지 않은 경우 저장된 일정을 재개합니다. 성공적인 확인은 6시간 후에 다음 시도를 예약합니다. 실패한 확인은 이전에 성공한 버전을 보존하고 더 긴 업스트림 속도 제한을 준수하여 15분 후에 다시 시도합니다. 자동 확인을 끄면 보류 중인 자동 작업이 취소되고 알려진 버전이 유지됩니다. 명시적인 내용을 방지하지 않습니다. 지금 확인하세요 조치를 취하거나 수동 핀을 무시합니다.

수동 검사는 비행 중 작업을 공유하며 시도 완료 후 60초의 재사용 대기시간을 가집니다. 업스트림 속도 제한이나 스토리지 오류로 인해 속도가 확장될 수 있습니다. 연결이 끊긴 발신자는 공유된 확인을 취소하지 않습니다. Shutdown은 SQLite이 닫히기 전에 모든 검사를 취소하고 결합합니다.

이 서비스는 공식 문서만 읽습니다. openai/codex GitHub 릴리스 메타데이터. 안정적으로 받아들인다 rust-v… 태그를 지정하고 초안 및 시험판을 제외합니다. 최신 릴리스 엔드포인트의 응답 범위는 2MiB입니다. 다른 구성 요소를 가리키는 경우 하나의 대체 페이지는 한 번에 하나의 릴리스를 디코딩하여 30개의 릴리스와 16MiB로 제한됩니다. 수표의 기한은 30초이며 리디렉션을 거부하고 구독 자격 증명이나 GitHub 토큰을 보내지 않습니다. 네트워크 오류, 유효하지 않은 응답 및 지속성 오류는 이전 유효 버전을 유지합니다. 바이너리가 다운로드되거나 설치되지 않으며 CLIProxyAPI 종속성은 변경되지 않습니다.

샘플 확인 시간이 포함된 Codex 버전 설정 예:

Codex client version settings with automatic checks enabled

Grok 클라이언트 버전

Grok에는 독립된 버전 정책이 있습니다. 관리 → 시스템 설정 → Grok 클라이언트 버전. 위에서 설명한 것과 동일한 선택 순서, 수동 재정의, 6시간 자동 일정, 오류 유지, 냉각 및 종료 동작을 사용합니다. 내장된 기본값은 다음과 같습니다. 1.0.50.

수표는 공식을 읽습니다 @xai-official/grok npm 패키지의 latest dist-tag. 알파 태그와 시험판 버전 문자열은 제외됩니다. 응답은 64KiB로 제한되며 기한은 30초이고 리디렉션이 거부됩니다. 구독 자격 증명이 전송되지 않으며 CLI 바이너리 또는 SDK 종속성이 설치되지 않습니다.

효과적인 버전 관리 x-grok-client-version 그리고 매칭 User-Agent Grok 구독 추론 및 청구 요청. 이전 클라이언트 버전은 모델 검색 또는 할당량 읽기가 성공하는 동안에도 HTTP 426을 사용하여 Grok 채팅 프록시에 의해 거부될 수 있습니다. 버전 확인이 npm에 도달할 수 없는 경우 다음을 사용하세요. 지금 확인하세요 연결이 복구된 후 또는 수동으로 확인된 안정 버전을 설정합니다. 수동 핀은 이후의 자동 결과보다 우선합니다.

Claude 클라이언트 버전

Claude에는 별도의 Claude 클라이언트 버전 페이지 /admin/settings/claude, 동일한 수동 재정의, 6시간 검사, 휴지 시간, 오류 유지 및 재시작 동작을 사용합니다. 내장 버전은 다음과 같습니다. 2.1.287.

수표는 공식을 읽습니다 @anthropic-ai/claude-code npm 패키지의 안정적인 dist-tag. 출판사의 latest 그리고 next 채널은 최신일 수 있습니다. 다음의 경우에는 대체품이 아닙니다. stable 사용할 수 없습니다. 검사는 Grok과 동일한 64KiB 응답 범위와 30초 기한을 가지며 실행 파일을 설치하지 않습니다.

각 추론 요청은 하나의 버전을 캡처합니다. 대중 SDK은 사용자 에이전트, 본문 청구를 생성합니다. cc_version 해당 버전에 대한 변경 불가능한 구성에서 CCH 서명이 가능합니다. 정책을 업데이트하면 새 요청에 영향을 주지만 이미 실행 중인 요청은 원래 버전을 유지합니다. 모델 검색 및 할당량 쿼리도 선택한 클라이언트 ID를 사용합니다. SDK 자격 증명 저장소는 비어 있고 버전 부트스트랩 수신기는 즉시 닫힙니다.

Opus 5.5 및 Sonnet 5.5는 지원되는 적응형 사고 및 노력 제어를 사용합니다. Chat Completions 및 Responses은 명시적인 출력 토큰 제한을 유지합니다. OpenAI reasoning_effort: none 선택하다 low 항상 생각하는 Opus 5.5에 대한 노력; Sonnet 5.5에서는 선택합니다. between_tools, 사전 생각 없이. 이러한 모델이 지원하지 않는 기본 수동 사고 예산 및 강제 도구 선택은 공급자 IO 전에 거부됩니다. 기본 적응형 요청은 표시 의도를 유지합니다. 버전 동기화는 클라이언트 메타데이터를 업데이트합니다. 향후 프로토콜 변경에는 여전히 어댑터 변경이 필요할 수 있습니다.

지속성 및 요청 동작

독립된 경계 JSON 값 settings['codex.version'], settings['grok.version'], 그리고 settings['claude.version'] 각 공급자의 구성, 마지막으로 성공한 버전 및 시도 시간을 저장합니다. 기존 Codex 설정은 원래 키와 동작을 유지합니다. 새 테이블이나 마이그레이션이 필요하지 않습니다. 성공적인 구성 변경과 그 settings.update 감사 이벤트 커밋을 함께 수행합니다. 자동 릴리스 관찰은 관리자 감사 이벤트를 생성하지 않습니다. 런타임 버전은 지속성이 성공한 후에만 게시됩니다.

Codex 모델 검색, 할당량 메타데이터 및 전달은 유효 버전을 사용합니다. 각 검색 요청은 쿼리, 헤더 및 지속 소스 마커에 대해 한 번 캡처합니다. 버전을 변경하면 카탈로그 최신성이 무효화됩니다. 다음 카탈로그 읽기 또는 모델 요청이 재발견을 트리거합니다. 대체된 버전의 진행 중인 결과는 삭제됩니다. 다른 제공업체 및 관리자 모델 허용 목록은 변경되지 않습니다. 보다 모델 카탈로그 오래된 데이터 및 라우팅 동작을 위해.

브라우저 API

엔드포인트	목적
`GET /api/settings/timezone`	인스턴스 시간대 읽기
`PATCH /api/settings/timezone`	구하다 `time_zone` IANA 이름으로
`GET /api/settings/codex`	구성, 유효 버전 읽기 및 상태 확인
`PATCH /api/settings/codex`	둘 다 저장 `manual_version` (문자열) 및 `auto_sync` (부울)
`POST /api/settings/codex/sync`	빈 JSON 객체로 공식 릴리스를 확인하세요.
`GET /api/settings/grok`	Grok 구성, 유효 버전 읽기 및 상태 확인
`PATCH /api/settings/grok`	둘 다 저장 `manual_version` (문자열) 및 `auto_sync` (부울)
`POST /api/settings/grok/sync`	빈 JSON 객체로 공식 npm 안정 태그를 확인하세요.
`GET /api/settings/claude`	Claude 구성, 유효 버전 읽기 및 상태 확인
`PATCH /api/settings/claude`	둘 다 저장 `manual_version` 그리고 `auto_sync`
`POST /api/settings/claude/sync`	빈 JSON 객체로 공식 npm 안정 채널을 확인하세요.

모든 엔드포인트에는 플랫폼 소유자 세션이 필요합니다. 돌연변이에는 정확한 기원이 필요합니다. 잘못된 버전은 400을 반환합니다. 쿨다운이 429를 반환하는지 확인하세요. Retry-After; 릴리스 또는 지속성 실패는 삭제된 503 오류를 반환합니다. 보고된 릴리스 버전은 호환성 메타데이터일 뿐 모든 계정이 해당 릴리스의 모든 모델을 지원한다는 증거는 아닙니다.

Prometheus 지표

별도 무작위 SUBLANE_METRICS_TOKEN(표시 가능한 ASCII 32–128자)으로 /metrics를 활성화합니다. 수집기는 Authorization: Bearer <token>을 보내야 합니다. 브라우저 세션, 게이트웨이 키 및 URL 매개변수는 인증할 수 없습니다. 설정하지 않으면 404입니다.

프로세스 전체 결과별 요청 수, 소요 시간과 관측된 첫 출력 히스토그램, 추론 임대 수 및 대기열 길이를 제공합니다. 알 수 없는 지연은 제외합니다. 작업 공간 런타임 회수에도 유지되며 프로세스 재시작 시 초기화됩니다. 게이트웨이 관찰 전 익명 요청은 제외합니다. 수집은 메모리만 읽으며 SQL, 제공자 IO, 이름·내용·비밀을 포함하지 않습니다. 데모에서는 꺼집니다.