콘텐츠로 이동
opencodex
17.7k

프로바이더

프로바이더는 하나의 업스트림 LLM 엔드포인트와 거기에 도달하는 방법을 합친 것입니다: 어댑터, 베이스 URL, 인증 모드, 그리고 선택적인 모델 목록으로 구성됩니다. 프로바이더는 ~/.opencodex/config.json의 providers 아래에 위치합니다.

OpenAI 계정 모드

섹션 제목: “OpenAI 계정 모드”
프로바이더 id 용도 자격증명/계정 규칙
openai Codex 로그인 Pool(기본)은 메인+추가 계정을 선택하고 Direct는 현재 caller/메인 로그인만 사용합니다.
openai-apikey OpenAI API 설정된 API key/key pool만 사용하며 Codex 계정을 읽지 않습니다.

bare gpt-5.6-sol은 Providers 페이지의 Pool/Direct 옵션을 따르고, openai-apikey/gpt-5.6-sol은 API를 선택합니다. 자격증명 경로 간 fallback은 없습니다. API는 context 922,000 / max input 922,000이며 *-pro virtual id는 공개 상태에 유지되고 wire에서 base 모델과 reasoning.mode: "pro"로 바뀝니다.

내장 openai 제공자가 없거나 비활성화된 경우 대시보드 Accounts 선택기와 Codex Auth 페이지에서 복구할 수 있습니다. 없는 항목은 정규 프리셋으로 만들고, 비활성화된 정규 항목은 저장된 모드/모델 설정을 바꾸지 않고 다시 켜며, 비정규 openai 항목에는 그 복구 경로를 제공하지 않습니다.

프로바이더 개요의 풀 용량

섹션 제목: “프로바이더 개요의 풀 용량”

Codex 로그인을 Pool 모드로 사용하면 Providers 개요에는 임의의 한 계정이 아니라 풀 전체의 사용 용량 추정치가 표시됩니다. 같은 행에는 현재 유효 계정의 원본 quota 사용률도 표시되므로, 풀 추정치와 다음 요청에서 사용할 계정의 상태를 구분할 수 있습니다.

리셋 정보가 있으면 다음 리셋 시각과 그때 회복되는 풀 용량을 표시합니다. 불완전한 범위는 요금제나 quota를 알 수 없거나, 측정값이 오래되었거나, 계정이 일시 중지되었거나 재인증이 필요한 등의 이유로 일부 계정을 안전하게 추정치에 포함하지 못했음을 뜻합니다.

일부 기간의 범위가 불완전함은 포함된 계정 중 일부가 표시된 quota 기간을 모두 보고하지 않았음을 뜻합니다. 개요는 각 기간을 서로 분리한 채 영향을 받은 기간을 개별적으로 불완전하다고 표시하며, 누락된 값을 해당 기간의 사용량으로 간주하지 않습니다.

이 추정치는 표시 전용입니다. 계정 선택, 세션 affinity, 자동 전환, cooldown 또는 다른 라우팅 판단을 변경하지 않습니다. 개별 계정 상태와 라우팅 제어는 Codex Auth 계정 풀을 참고하세요.

shipped v1 config는 marker 2의 단일 옵션 행으로 자동 이관됩니다. 원본은 ~/.opencodex/config.json.pre-openai-tiers-v2.bak에 한 번 보존되며 다음 명령으로 복원합니다: cp ~/.opencodex/config.json.pre-openai-tiers-v2.bak ~/.opencodex/config.json.

인증 모드

섹션 제목: “인증 모드”

프로바이더 설정에서 쓸 수 있는 authMode는 세 가지이며, 기본값은 key입니다. 빌트인 레지스트리는 로컬 프리셋을 별도로 분류합니다. 로컬 프리셋에는 보통 authMode와 apiKey를 모두 쓰지 않습니다.

authMode 인증 방식 사용처
key API 키를 전송합니다(Authorization: Bearer …, 또는 어댑터에 따라 x-api-key / api-key). 키는 리터럴이거나 ${ENV_VAR} 참조일 수 있습니다. 대부분의 프로바이더.
forward 수신된 Codex 인증 헤더를 프로바이더에 그대로 중계합니다 — 키를 저장하지 않습니다. ChatGPT 로그인 패스스루입니다. OpenAI (openai-responses 어댑터).
oauth 저장된 OAuth 액세스 토큰을 불러와 bearer 키로 사용하며, 만료 전에 자동 갱신합니다. xAI, Anthropic, Kimi, Kiro, Google Antigravity, Cursor, Command Code, GitHub Copilot, Nous Portal.

retryOn429（동일 키 429 재시도）는 API 키 프로바이더 （authMode: "key"）에만 적용됩니다. OAuth·forward·로컬 프리셋은 제외됩니다 — 같은 토큰을 재전송해서는 안 되며, 로컬 런타임에는 보존할 원격 키가 없습니다. 옵트인입니다: 옵션이 없으면 꺼져 있고, 객체가 있으면 enabled: false가 아닌 한 활성화됩니다.

1. ChatGPT 로그인 (forward / 패스스루)

섹션 제목: “1. ChatGPT 로그인 (forward / 패스스루)”

기본 프로바이더는 API 키가 필요 없습니다. 기존 codex login의 자격 증명을 OpenAI Responses 백엔드로 그대로 포워딩합니다:

{
  "openai": {
    "adapter": "openai-responses",
    "baseUrl": "https://chatgpt.com/backend-api/codex",
    "authMode": "forward"
  }
}

엄선된 헤더 집합만 포워딩됩니다(FORWARD_HEADERS: authorization, ChatGPT account id, OpenAI beta/originator/session — 어댑터 참고). 이 경로는 웹 검색 및 비전 사이드카를 구동하는 경로이기도 합니다.

ChatGPT 패스스루 카탈로그에는 GPT-5.6 Sol/Terra/Luna의 네임스페이스 없는 slug (gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna)도 들어갑니다. 실제 호출 가능 여부는 계정 권한에 따라 달라집니다.

2. 계정 로그인 (OAuth)

섹션 제목: “2. 계정 로그인 (OAuth)”

프로바이더 프리셋은 계정 로그인을 쓸 수 있으며, 실험적 비공식 디바이스 플로우 브리지를 쓰는 GitHub Copilot도 여기에 들어갑니다. 자격 증명은 ~/.opencodex/auth.json에 저장되고 자동으로 갱신됩니다. ocx login codex도 받지만 이건 위 프로바이더가 아닙니다. Codex 계정 풀 로그인(ocx account login codex와 같은 흐름)으로 연결되고, 이 풀은 자체 계정 원장을 쓰기 때문에 프록시가 실행 중이어야 합니다. chatgpt와 openai는 같은 경로의 별칭입니다.

Terminal window
ocx login xai          # xAI Grok
ocx login anthropic    # Anthropic Claude (Pro/Max)
ocx login kimi         # Moonshot Kimi
ocx login nous         # Nous Portal (디바이스 그랜트; 무료 + 유료 모델)
ocx login kiro         # kiro-cli 자격 증명 가져오기(토큰 폴백 지원)
ocx login google-antigravity
ocx login cursor       # Cursor 전용 PKCE 로그인
ocx login command-code # Command Code 브라우저 OAuth (또는 ~/.commandcode/auth.json 가져오기)
ocx login devin       # Cognition/Devin: Devin CLI 자격 임포트 우선, 없으면 Auth0 브라우저 로그인
ocx login dsh-account # DeepSeek Harness Desktop (~/.dsh/.credentials.yaml 권한 가져오기)
ocx login github-copilot  # GitHub 디바이스 플로우 → Copilot 토큰 (Copilot Pro/Business)
ocx login codex        # Codex 계정 풀 (별칭: chatgpt, openai / 프록시가 실행 중이어야 함)
ocx logout <provider>
프로바이더 어댑터 베이스 URL 비고
xai openai-chat https://cli-chat-proxy.grok.com/v1 OAuth는 별도의 Grok CLI 구독 게이트웨이를 사용합니다. API 키 오버라이드는 https://api.x.ai/v1을 사용하며 Priority Processing을 주입할 수 있습니다. 실시간 목록을 우선 사용하며, 폴백 기본 모델은 grok-4.5입니다.
anthropic anthropic https://api.anthropic.com Claude 모델; 실시간 모델 목록은 /v1/models에서 가져옵니다.
kimi openai-chat https://api.kimi.com/coding/v1 Kimi Code 모델입니다. kimi-for-coding은 현재 K2.8 Preview를 가리키며 100만 토큰 문맥, low/high/max 추론, 텍스트·이미지 입력을 지원합니다. k3-256k의 문맥 한도는 256K로 고정됩니다.
kimi-responses openai-responses https://api.kimi.com/coding/v1 kimi와 동일한 OAuth 로그인과 모델 목록을 Responses 방식으로 사용합니다. 추론 내용은 서버 측에서 암호화된 상태로 유지되고 도구 호출과 결과는 볼 수 있습니다.
nous openai-chat https://inference-api.nousresearch.com/v1 Nous Research 구독 게이트웨이(Hermes Agent와 동일한 백엔드). portal.nousresearch.com에 대한 디바이스 그랜트 로그인; access 토큰은 요청별 inference JWT. 유료 + :free 모델 혼합 카탈로그(tencent/hy3:free, stepfun/step-3.7-flash:free 등)는 로그인한 계정에서 실시간으로 발견됩니다. Refresh 토큰은 단회 사용이며, 갱신할 때마다 회전됩니다.
kiro kiro https://runtime.us-east-1.kiro.dev 최초 로그인은 설치하고 로그인한 kiro-cli 세션을 가져옵니다(Unix에서는 curl -fsSL https://cli.kiro.dev/install | bash, Windows PowerShell에서는 irm 'https://cli.kiro.dev/install.ps1' | iex로 설치한 뒤 kiro-cli login 실행). 계정 추가는 kiro-cli에서 로그아웃한 뒤 새 브라우저 로그인을 시작하여 kiro-cli 자체의 계정을 전환하고, 계정별 프로필 메타데이터를 저장합니다. 기존 OpenCodex 계정은 유지되며, 취소되거나 실패하면 이전 kiro-cli 세션을 복원합니다.
google-antigravity google https://daily-cloudcode-pa.googleapis.com Google OAuth를 Cloud Code Assist wire로 사용합니다. 실시간 탐색은 인증된 CCA v1internal:fetchAvailableModels 엔드포인트를 사용하며 로그인한 계정에서 사용할 수 있는 agent 모델만 게시합니다. 유지 관리되는 카탈로그는 폴백으로 남습니다.
cursor cursor https://api2.cursor.sh 실험적 PKCE 로그인, HTTP/2 전송, 계정별 모델 탐색을 지원합니다.
devin devin https://server.codeium.com 실험적인 비공식 Cognition/Devin 브리지. 로그인은 먼저 설치된 Devin CLI가 이미 보유한 자격을 가져옵니다(devin auth login이 devin-session-token을 자기 credentials.toml에 씁니다). 없으면 Auth0 브라우저 사인인을 열어 붙여넣은 토큰을 RegisterUser로 장기 API 키에 교환합니다. ocx login devin-cli는 deprecated alias로 계속 동작합니다. 모델 목록은 GetCascadeModelConfigs로 계정마다 조회하며, 스트리밍은 Connect-RPC 위에서 runTurn 경로만 씁니다. 대시보드 프리셋에는 기본으로 없으니 직접 추가하세요.
dsh-account dsh-account https://api.deepseek.com/anthropic 설치 및 로그인된 DeepSeek Harness (DSH) Desktop 계정을 재사용하는 실험적 자격 임포트 우선 계정 프로바이더입니다. 명시적 임포트 시 ~/.dsh/.credentials.yaml에서 엄격히 읽기 전용으로 자격을 읽습니다. DeepSeek API 키 요금 청구와 완전히 독립적입니다.
github-copilot openai-chat https://api.githubcopilot.com 실험적. GitHub 디바이스 플로우 + copilot_internal 교환(VS Code OAuth 클라이언트). 활성 Copilot 구독 필요; 공식 서드파티 API가 아닙니다.

Google Antigravity 계정·제공자 할당량 확인은 모델 목록 폴백을 포함해 고정된 Google 회계 엔드포인트를 사용합니다. 해당 목적지의 투명 Fake-IP DNS를 지원하며 TLS 검증, 리다이렉트 거부, 사설 주소 검사는 유지합니다. 사용자 지정 base URL은 모델 요청에만 적용되며 할당량 목적지는 바꾸지 않습니다. NO_PROXY는 기존 직접 연결 정책을 유지합니다.

Vertex AI의 gemini-4-argon에는 스크린샷 같은 도구 결과 이미지를 해당 함수 응답 안에 담아 전송합니다. 이미지가 있는 도구 호출 뒤에 발생하는 400 오류 “Requests ending with a model turn are not supported”를 방지하며 이미지를 보존합니다. 중복된 결과나 일치하는 호출이 없는 결과의 이미지는 도구 응답 뒤의 별도 메시지로 보존하고, 호출과 연결할 수 없었다는 표시를 남깁니다. 별도의 설정 변경은 필요하지 않으며, 이 처리는 Vertex Argon에만 적용됩니다.

Google 도구 스키마 손실 진단

섹션 제목: “Google 도구 스키마 손실 진단”

Google 도구 선언은 선택된 엔드포인트 클래스에 맞춰 컴파일됩니다. ocx debug provider on, 대시보드 Logs 토글 또는 OCX_DEBUG=1로 프로바이더 디버그를 켜면 정책을 생략하거나 compatible인 호환성 변환 중 스키마 손실이 발생할 때 [ocx:google:google-tool-schema-loss] 레코드를 기록합니다 (ocx debug provider logs -f로 tail할 수 있습니다). 이 레코드에는 보고서 버전, 엔드포인트 클래스, lossy 표시, 판정 불가능한 비교의 상한 개수, 상한이 있는 개수를 포함한 고정 손실 범주, 잘림 여부만 들어갑니다. 도구명과 속성명, 경로, 값, 스키마 본문은 포함하지 않습니다. 정책을 생략하거나 compatible이면 변환을 거부하지 않고 관찰합니다. reject-lossy에서는 초기 컴파일에 손실이 있거나 상한 비교를 판정할 수 없으면 전송 전에 거부합니다. 거부된 요청에는 별도의 손실 레코드를 기록하지 않습니다. reject-lossy에서는 제약을 지우는 Vertex 또는 Cloud Code Assist 복구가 동일하게 내용이 없는 google-tool-schema-repair를 기록하고 변경 전송 없이 원래 400을 반환합니다. 정책을 생략하거나 compatible이면 복구된 요청을 이전과 같이 다시 전송합니다. 직접 AI Studio는 이 복구를 수행하지 않습니다. 네이티브 출력 스키마는 두 정책 경로 모두의 대상이 아닙니다. 디버그 명령어 참고 문서도 확인하세요.

Nous refresh가 종료 실패한 경우, ocx login nous로 재인증하세요.

정식 Kimi Coding Plan 프리셋(kimi 계정 로그인과 kimi-code API key)의 경우, opencodex는 호출자가 제공한 안정적인 prompt_cache_key만 Chat Completions 요청으로 전달하며 직접 생성하지 않습니다. Kimi 문서는 Code Plan 캐시 적중률을 높이기 위해 안정적인 세션/작업 key가 필요하다고 명시합니다. key가 없는 요청은 keyless 상태로 유지됩니다. opt-in한 업스트림이 이 필드를 거부해도 opencodex는 필드를 제거해 재시도하거나 저장된 설정을 변경하지 않습니다. 다른 프로바이더는 deny-by-default 상태로 유지됩니다.

kimi, kimi-code, kimi-responses의 k3, k3[1m], k3-256k 비용은 기본 5분 캐시 쓰기 요금을 적용한 API 가격 기준 추정치입니다. Code Plan의 실제 청구액이나 할당량은 아닙니다. K3의 1M 버전은 k3-256k보다 할당량을 약 두 배 소비합니다. kimi-for-coding은 K2.8 Preview로 전환되었으므로 이전 K2.7 가격을 적용하지 않습니다. 사용자가 modelCosts를 지정하지 않으면 비용을 알 수 없으며, 미확인 비용을 제외하도록 설정한 라우팅 정책에서는 이 별칭이 후보에서 빠질 수 있습니다.

웹 대시보드에서도 OAuth를 시작할 수 있습니다.

여러 OAuth 계정

섹션 제목: “여러 OAuth 계정”

자격 증명에 고정된 계정 id나 이메일이 있는 OAuth 프로바이더는 로그인을 여러 개 보관할 수 있습니다. Providers 페이지에서 계정을 추가하고, 다른 계정을 로그아웃하지 않은 채 활성 계정만 바꿀 수 있습니다. 계정 식별 정보가 없는 Kimi 자격 증명은 일반 로그인에서는 활성 슬롯을 교체하지만, 명시적인 계정 추가에서는 기존 슬롯을 보존하고 별도의 새 슬롯을 활성화합니다. Kiro 계정은 프로필 ARN을 키로 저장됩니다. chatgpt는 Codex 계정 풀에 별도 저장소가 있어 항상 단일 슬롯만 씁니다. 토큰은 ~/.opencodex/auth.json에 저장되고, /api/oauth/accounts는 마스킹된 메타데이터만 반환합니다.

Cockpit Tools Antigravity 가져오기

섹션 제목: “Cockpit Tools Antigravity 가져오기”

v1에서 OpenCodex는 google-antigravity 공급자의 Cockpit Tools Antigravity JSON 내보내기만 가져옵니다. Providers 대시보드에서 해당 공급자의 Accounts 탭을 열고 로컬 JSON 파일을 선택하세요. 대시보드는 파일 내용이나 자격 증명 값을 표시하지 않으며 가져온, 업데이트된, 실패한, 지원되지 않는 항목의 수만 보고합니다. 다른 Cockpit 공급자는 v1에서 지원되지 않습니다.

CLI는 파일 또는 stdin에서만 내보내기를 받으며 명령 인수에 붙여넣을 수 없습니다:

Terminal window
ocx account import google-antigravity --format cockpit-tools --file <path> [--json]
cat accounts.json | ocx account import google-antigravity --format cockpit-tools --stdin [--json]

인라인 JSON과 추가 위치 인수는 거부됩니다. 내보낸 파일은 비공개로 보관하고 가져온 뒤 삭제하거나 안전하게 저장하세요.

Kiro 자격 증명 가져오기

섹션 제목: “Kiro 자격 증명 가져오기”

Kiro 로그인에는 Kiro CLI가 필요합니다. Unix에서는 curl -fsSL https://cli.kiro.dev/install | bash, Windows PowerShell에서는 irm 'https://cli.kiro.dev/install.ps1' | iex로 설치한 뒤 먼저 kiro-cli login으로 로그인하세요. kiro-cli 세션이 없으면 ocx login kiro는 붙여 넣은 액세스 토큰이나 KIRO_ACCESS_TOKEN 환경 변수로 폴백합니다.

일반 ocx login kiro 가져오기는 CLI SQLite 데이터베이스를 읽기 전용으로 열며 데이터베이스, WAL, SHM을 수정하지 않습니다.

  • KIROCLI_DB_PATH는 비표준 Kiro CLI SQLite 데이터베이스를 선택하며, 지정한 데이터베이스는 이미 존재해야 합니다.
  • KIROCLI_TOKEN_KEY는 모호한 토큰 행이 여러 개일 때 가져올 정확한 auth_kv 행의 키를 선택합니다. 선택값이 없으면 추측하지 않고 로그인이 실패합니다.

가져온 자격 증명은 ~/.opencodex/auth.json에 저장됩니다. 계정 추가 롤백은 별도 절차로, 이전 스냅샷을 복원할 때 데이터베이스를 교체하고 현재 WAL, SHM, journal 사이드카를 제거합니다.

롤백은 스냅샷이 있을 때만 가능하므로, 세션 저장소가 존재하지만 캡처할 수 없는 경우(파일을 읽을 수 없음, 스키마 불일치, 토큰 선택 모호), KIROCLI_DB_PATH / KIRO_CLI_DB_FILE이 실제 CLI 저장소와 다른 가져오기 경로를 가리키는 경우, 또는 기본 CLI 데이터베이스에 인식 가능한 토큰 행이 없는 경우 계정 추가는 kiro-cli 로그아웃을 거부합니다. 일반 kiro-cli 데이터 경로의 손상된 데이터베이스를 수리하거나 제거하고, 가져오기 전용 선택자가 설정돼 있으면 해제한 뒤 다시 시도하세요. 기존 kiro-cli 세션이 아예 없는 환경에서는 영향이 없습니다.

DeepSeek Account (DSH)

섹션 제목: “DeepSeek Account (DSH)”

dsh-account는 설치 및 로그인된 DeepSeek Harness (DSH) Desktop 애플리케이션의 인증된 계정 자격 증명을 재사용하는 실험적 자격 임포트 우선 계정 프로바이더입니다.

  • DeepSeek API 키와 독립: dsh-account는 사용자의 인증된 DeepSeek 세션 할당량(일반/보너스 지갑 잔액 및 총 지출)을 사용하며, deepseek 프로바이더는 플랫폼 API 키 잔액에서 청구됩니다. 두 자격 증명 도메인 및 라우팅은 엄격히 분리되어 상호 폴백되지 않습니다.
  • 명시적 가져오기 전용: OpenCodeX는 DeepSeek Harness의 설치 및 로그인 여부(~/.dsh/.credentials.yaml)를 감지하지만, 사용자의 명시적 명령(ocx login dsh-account 또는 웹 대시보드에서 가져오기 클릭) 없이 토큰을 자동 복사, 가져오기 또는 사용하지 않습니다.
  • DSH 자격 증명 저장소 읽기 전용: OpenCodeX는 ~/.dsh/.credentials.yaml을 엄격히 읽기 전용으로 취급합니다. OpenCodeX는 DeepSeek Harness에 속한 어떠한 파일도 쓰기, 수정, 삭제하거나 권한을 변경하지 않습니다.
  • 격리된 자격 증명 복사본 및 로그아웃: 가져오기 시 OpenCodeX는 DeepSeek의 신뢰할 수 있는 ID 엔드포인트(/auth-api/v0/users/current)에서 토큰을 검증하고 자체 복사본을 OpenCodeX 인증 저장소에 저장합니다. OpenCodeX에서 로그아웃하거나 계정을 삭제해도 OpenCodeX 로컬 복사본만 삭제되며, 업스트림 원격 세션 로그아웃을 트리거하거나 DeepSeek Harness Desktop에서 로그아웃되지 않습니다.
  • 백그라운드 토큰 자동 갱신 없음 및 401 재가져오기: DSH 세션 부여에는 자동 백그라운드 갱신 엔드포인트가 없습니다. 업스트림에서 HTTP 401(ACCOUNT_TOKEN_INVALID)을 반환하면 OpenCodeX는 계정을 needsReauth로 표시하고 라우팅을 중단합니다. 액세스를 복원하려면 사용자가 ocx login dsh-account로 명시적 재가져오기를 수행해야 합니다.
  • 서드파티 면책 조항: OpenCodeX는 서드파티 클라이언트의 세션 부여 재사용에 대한 DeepSeek의 공식 보증이나 승인을 주장하지 않습니다.

3. API 키 카탈로그

섹션 제목: “3. API 키 카탈로그”

opencodex에는 빌트인 프리셋이 104개 들어 있습니다. 키 방식 84개, OAuth 16개, 로컬 3개, 기본 ChatGPT 포워드 프리셋 1개입니다. 대시보드의 Add provider 선택기는 키 발급 페이지를 열고, 입력한 키를 검증한 뒤 저장합니다(검증은 프로바이더별로 다릅니다). 주요 항목은 다음과 같습니다:

ClinePass는 Cline API 키로 공식 구독 카탈로그와 Chat Completions 엔드포인트에 연결합니다. 운영 주체는 Cline 약관에 명시된 Cline Bot Inc.입니다. cline-pass/cline-pass/kimi-k3 같은 라우팅 ID는 정상입니다. 앞의 cline-pass는 opencodex 프로바이더이고, 뒤의 cline-pass/kimi-k3는 upstream에 보내는 전체 모델 slug입니다. ClinePass 사용량은 계정의 5시간 롤링·주간·월간 한도를 함께 사용합니다. 2026-08-13 실측에서 모든 정적 ClinePass 모델이 게이트웨이 입력에서 low, medium, high, xhigh, max를 수락하는 것을 확인했습니다. opencodex는 요청한 단계를 그대로 보존하며, 백엔드별 정규화는 ClinePass가 담당합니다.

Cline은 동일한 API 키·엔드포인트를 종량제로 사용하며 100개 이상의 모델에 접근합니다 (OpenRouter 형식 ID, 예: anthropic/claude-sonnet-4-6). Cline의 프로모션 무료 모델은 Cline IDE/CLI에서만 제공되며 API로는 사용할 수 없습니다. minimax/minimax-m2.5는 API에서 사용할 수 있는 무료 체험 모델로 문서화되어 있습니다.

프로바이더 베이스 URL
OpenAI (API key) https://api.openai.com/v1
Anthropic (API key) https://api.anthropic.com
OpenRouter https://openrouter.ai/api/v1
Cline https://api.cline.bot/api/v1
ClinePass https://api.cline.bot/api/v1
Ollama Cloud https://ollama.com/v1
Google Gemini · Google Vertex AI https://generativelanguage.googleapis.com · https://aiplatform.googleapis.com
Azure OpenAI https://{resource}.openai.azure.com/openai
Umans AI · Neuralwatt https://api.code.umans.ai · https://api.neuralwatt.com/v1
Mistral https://api.mistral.ai/v1
MiniMax · MiniMax (CN) https://api.minimax.io/v1 · https://api.minimaxi.com/v1
DeepSeek https://api.deepseek.com
Cerebras https://api.cerebras.ai/v1
Chutes https://llm.chutes.ai/v1
DeepInfra https://api.deepinfra.com/v1/openai
Hyperbolic https://api.hyperbolic.xyz/v1
Nscale Serverless Inference https://inference.api.nscale.com/v1
Vultr Serverless Inference https://api.vultrinference.com/v1
Baseten Model APIs https://inference.baseten.co/v1
Command Code https://api.commandcode.ai/provider/v1
SambaNova Cloud https://api.sambanova.ai/v1
Nebius Token Factory https://api.tokenfactory.nebius.com/v1
Crusoe https://api.inference.crusoecloud.com/v1
DigitalOcean Serverless Inference https://inference.do-ai.run/v1
Scaleway Generative APIs https://api.scaleway.ai/v1
Featherless AI https://api.featherless.ai/v1
Novita AI https://api.novita.ai/openai/v1
Together https://api.together.xyz/v1
Fireworks https://api.fireworks.ai/inference/v1
Moonshot (Kimi API) · Kimi (coding) https://api.moonshot.ai/v1 · https://api.kimi.com/coding/v1
Hugging Face https://router.huggingface.co/v1
NVIDIA NIM https://integrate.api.nvidia.com/v1
Z.AI (GLM Coding) https://api.z.ai/api/coding/paas/v4
Zhipu AI (BigModel) https://open.bigmodel.cn/api/paas/v4
BigModel Coding Plan — Responses (정적 모델 목록) https://open.bigmodel.cn/api/v1
Qwen Cloud Token plan(기본): https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 · 종량제: https://dashscope.aliyuncs.com/compatible-mode/v1 · 또는 사용자 지정
Tencent Cloud Coding Plan https://api.lkeap.cloud.tencent.com/coding/v3
SiliconFlow https://api.siliconflow.cn/v1
Volcengine Ark · Coding Plan · Agent Plan https://ark.cn-beijing.volces.com/api/v3 · https://ark.cn-beijing.volces.com/api/coding/v3 · https://ark.cn-beijing.volces.com/api/plan/v3
Xiaomi MiMo https://api.xiaomimimo.com/anthropic
Xiaomi MiMo (OpenAI Chat) https://api.xiaomimimo.com/v1
Kilo https://api.kilo.ai/api/gateway
OpenGateway https://apis.opengateway.ai/v1
GitLab Duo https://cloud.gitlab.com/ai/v1/proxy/openai/v1
Cloudflare AI Gateway https://gateway.ai.cloudflare.com/v1/{account-id}/{gateway}/anthropic
…그 외 다수 opencode zen, Vercel AI Gateway, Venice, NanoGPT, Synthetic, Qianfan, Alibaba, Parallel, ZenMux, LiteLLM

OpenGateway는 Sionic AI가 운영하는 OpenAI 호환 게이트웨이입니다. Base URL은 https://apis.opengateway.ai/v1이며 공개 카탈로그에는 활성 모델이 약 80개 있습니다 (2026-10-02 확인). 프리셋은 공개 GET /v1/models에서 모델 목록을 자동 갱신하고 활성 Chat Completions 모델(그리고 Responses 전용이라 Responses로 보내는 openai/o3-pro)만 가져옵니다. Sionic이 제공하는 deepseek/deepseek-v4.1-flash-ultrafast와 z-ai/glm-5.3-flash-ultrafast를 먼저 표시합니다. OpenGateway 대시보드에서 키를 발급한 뒤 ocx provider add opengateway를 실행하거나 대시보드에서 OpenGateway를 선택하세요. Chat 요청은 설정한 Bearer 키를 사용하며 공개 모델 목록은 키의 유효성을 검증하지 않습니다. Responses 도구 결과 배열은 텍스트로 변환하고 이미지는 짝이 맞는 도구 결과 묶음 뒤의 메시지에 보존합니다. refusal이나 불투명한 내용 등 지원하지 않는 결과 part는 전송 전에 명시적인 클라이언트 입력 오류로 거절합니다. 이미지의 original 상세도는 게이트웨이가 지원하는 high로 바꾸며 이미지 바이트는 그대로 유지합니다. 네이티브 Responses 경로는 텍스트가 없는 완료 응답도 검사합니다. 출력 예산이 소진됐으면 incomplete / max_output_tokens로 알리며 요청한 예산을 임의로 늘리지 않습니다. 예산이 남고 안전하게 재전송할 수 있는 빈 완료는 기존 호출 한도 안에서 한 번만 재시도합니다. emptyCompletionRetry: false 또는 OCX_EMPTY_COMPLETION_RETRY=0이면 이 재시도를 끕니다. 텍스트·거절·도구 동작·알 수 없는 스트림 이벤트가 관측되면 재전송하지 않고 원본을 유지합니다. 다른 제공자의 동작과 재시도 기본값에는 적용하지 않습니다. 재전송은 명시적인 store: false, 완전한 입력, 클라이언트 실행 도구만 있는 요청에 한정합니다. web_search 같은 서버 실행 도구가 선언돼 있으면 도구 이벤트가 없어도 자동 재전송하지 않습니다.

OpenCode Zen(opencode-zen)은 opencode.ai/auth에서 발급한 API 키로 https://opencode.ai/zen/v1을 사용합니다. 무료 모델은 분당 약 15–20회 요청의 짧은 창 속도 제한에 걸릴 수 있습니다(커뮤니티 측정; OpenCode는 RPM을 공개하지 않음). 속도 제한 429에 Retry-After가 없으면 opencodex가 안내와 합성 Retry-After를 추가하며, 유효한 업스트림 헤더가 우선합니다. 동일 키 재시도는 retryOn429로 선택합니다.

정식 opencode-zen 제공자에서 API 키 인증과 공식 경로 https://opencode.ai/zen/v1 또는 https://opencode.ai/inference/v1을 사용하면 Gemini는 기본 googleMode: ai-studio에서 Google 네이티브 API를 자동으로 사용합니다. Zen 모델 ID는 -tiered 접미사가 없는 Flash ID도 그대로 유지합니다. Claude는 googleMode와 관계없이 Anthropic Messages를 사용합니다. 저장된 설정을 읽을 때 이 네이티브 모델의 조건에 맞는 기존 Chat/Responses 재정의와 조건에 맞는 Responses 전용 image_generation 호스팅 도구 선호 설정만 무시합니다. 사용자 지정 제공자, 키 인증이 아닌 경로, 그 밖의 선호 설정은 그대로 유지합니다.

opencode-free 지원이 제거되었습니다. OpenCode의 업스트림 무료 등급 제한으로 모든 모델이 403 permission_denied를 반환하기 때문입니다(#7255). 기존 설정을 불러오면 해당 항목과 종속 모델 참조를 메모리에서 비활성화하고 프로세스당 한 번 경고하며 파일은 변경하지 않습니다. 기본 공급자였다면 표준 OpenAI OAuth 경로가 기본값이 됩니다. opencode-go, API 키를 사용하는 opencode-zen 또는 다른 공급자를 사용하세요. OpenCode Zen 약관.

정상 Claude Desktop 할당과 기본값은 유지됩니다. 소스 모델 허용 목록이 비게 되는 규칙은 비활성화되며, 주입 모델이 제거되면 네이티브 하위 에이전트 동기화도 비활성화됩니다. 이후 설정을 저장하면 제거된 참조는 다시 기록되지 않고 정상적인 동시 편집은 유지됩니다.

대부분은 bearer 키와 함께 openai-chat 어댑터를 사용하며, Xiaomi MiMo(xiaomi) 같은 Anthropic 호환 프리셋은 anthropic 어댑터(x-api-key)를 사용합니다. Xiaomi에는 OpenAI Chat 프리셋 xiaomi-mimo와 토큰 플랜 프리셋 mimo도 있습니다. 세 프리셋 모두 기본 모델은 MiMo V2.6이며, xiaomi-mimo에서는 mimo-v2.6-flash, 나머지에서는 mimo-v2.6-pro를 사용합니다. Xiaomi는 2026-10-21에 mimo-v2.5와 mimo-v2.5-pro를 리디렉션 없이 종료하므로, 저장된 V2.5 기본 모델을 그전에 바꾸세요. opencodex가 자동으로 변경하지는 않습니다. Volcengine Coding Plan과 Agent Plan은 openai-responses 어댑터로 네이티브 Responses 엔드포인트를 사용합니다. 검증된 Ark Coding Plan 도구 연속 호출에서는 직전 턴이 돌려준 Responses reasoning 항목을 그대로 다시 보내면 400 InvalidParameter가 나므로, Coding Plan 프리셋은 연속 입력을 전달하기 전에 그 항목을 제거합니다. 그 턴의 reasoning 상태는 사라지며 dropResponsesReasoningItems: false로 끌 수 있습니다. 이미 openai-chat으로 저장된 Coding Plan 설정은 덮어쓰지 않고 Chat 그대로 둡니다. 바꾸려면 adapter를 openai-responses로, responsesPath를 /responses로 직접 수정하거나 프리셋을 지우고 다시 추가하세요.

Volcengine의 세 가지 과금 경로: volcengine은 종량제 Ark API, volcengine-coding-plan은 Coding Plan 할당량, volcengine-agent-plan은 Agent Plan 할당량을 사용합니다. 같은 상품에서 발급된 키와 엔드포인트를 함께 사용해야 하며, Plan 구독이 있어도 일반 /api/v3 엔드포인트 호출에는 종량제 요금이 발생할 수 있습니다. 세 preset은 선별된 정적 모델 카탈로그를 사용합니다. Ark의 /models는 텍스트와 함께 Embedding, 이미지, 비디오, 3D 리소스도 반환하고 Coding 게이트웨이도 같은 광범위한 카탈로그를 반환합니다. Agent Plan 게이트웨이에는 /models 리소스가 없습니다. 종량제 기본값은 doubao-seed-2-1-pro-260628이며 정적 카탈로그에는 현재 DeepSeek와 GLM 텍스트 모델도 포함됩니다. Coding Plan의 기본값은 ark-code-latest, Agent Plan은 deepseek-v4-flash입니다.

Chutes 검색: chutes 프리셋은 Chutes의 고정된 공유 OpenAI 호환 LLM gateway를 사용합니다. 공개 /v1/models catalog에서 supported_features가 tools를 명시한 행만 유지하고, 슬래시가 포함된 model id와 안전한 live metadata를 보존합니다. 검색은 256 KiB와 raw 128행으로 제한됩니다. 이 catalog는 공개되어 있어 입력한 키의 유효성을 증명할 수 없지만, chat request는 설정된 Bearer 키로 인증됩니다. 사용자가 배포한 custom Chute host와 LLM 이외의 API는 custom provider로 설정해야 합니다. 키는 Chutes dashboard에서 생성합니다.

DeepInfra 검색: 키 기반 OpenAI Chat Completions 제공자인 deepinfra는 openai-chat 어댑터와 Bearer API 키를 사용합니다. registry가 소유하는 DeepInfra 모델 목록 URL에서 chat 태그가 있는 행만 유지하고, 슬래시가 포함된 네이티브 모델 ID를 보존합니다. live discovery는 512 KiB 및 raw 512행으로 제한합니다. 키는 DeepInfra dashboard에서 생성합니다.

Hyperbolic 검색: 프리셋은 설정된 bearer 키로 /v1/models를 읽고, 슬래시가 포함된 네이티브 모델 ID를 보존하며 live discovery를 256 KiB와 raw 행 256개로 제한합니다. serverless text 및 vision-language chat만 대상으로 하며 별도 image, audio, GPU 엔드포인트는 범위에서 제외합니다. 키는 Hyperbolic에서 생성합니다.

Nscale 및 Vultr 검색: 두 프리셋 모두 인증된 /v1/models 카탈로그를 읽고 네이티브 ID를 보존하며, 검색을 256 KiB와 원시 행 256개로 제한합니다. Nscale 카탈로그는 modality 필드 없이 chat, image, embedding 모델을 함께 반환하므로 공식 도구 호출 API 예제에 사용된 meta-llama/Llama-3.1-8B-Instruct만 허용합니다. Vultr는 현재 kimi-k2-instruct에만 도구 호출을 문서화하므로 해당 모델만 노출합니다. 다른 행은 동등한 agent-tool 근거가 공개될 때까지 숨깁니다. Nscale service token은 Nscale Console에서 만들고, Vultr inference key는 Vultr Console의 구독 overview에서 복사합니다.

Command Code 검색. 프리셋은 고정된 Provider API 호스트에서 Command Code의 /provider/v1/models 목록을 읽고, 프로바이더의 원래 ID를 보존하며 검색을 256 KiB와 원본 행 256개로 제한합니다. ocx login command-code는 브라우저 로그인을 통한 OAuth를 지원합니다. 기존 Command Code CLI 사용자는 ~/.commandcode/auth.json에서 로컬 CLI 자격 증명을 가져올 수도 있습니다. 모델 카탈로그는 계정별로 제공되며 로그인 후 인증된 검색 엔드포인트에서 가져옵니다. Provider API 프리셋(commandcode)은 현재 설정된 활성 키를 전송합니다. 대부분의 모델 ID에는 Bearer 헤더를 사용하는 Chat Completions를 쓰지만, claude-* ID에는 x-api-key를 사용하는 Anthropic Messages를 씁니다. Command Code가 해당 모델을 /provider/v1/messages에서만 제공하기 때문입니다. 다른 엔드포인트에 commandcode라는 이름을 재사용한 프로바이더는 자체 통신 방식을 유지합니다. OAuth 프리셋(command-code)은 저장된 계정 bearer로 인증된 모델 검색을 수행하고, /alpha/generate에서 생성 결과를 NDJSON으로 스트리밍합니다. 게이트웨이가 실제 도구 호출과 중복된 MiMo 도구 호출 마크업을 텍스트로 되돌리면 해당 마크업을 제거합니다. MiMo 모델에서 선언된 도구 호출이 완전하지만 대응하는 네이티브 호출이 없다면, 정상 종료된 뒤에만 이를 복원합니다. 중단되거나 필터링된 턴에서는 마크업을 텍스트로 남깁니다. Provider API 키는 Command Code Studio에서 생성하세요.

Command Code 할당량: 대시보드와 ocx account refresh는 정규 호스트 https://api.commandcode.ai에서 /alpha/billing/credits 창(5시간 및 주간)을 조회합니다. OAuth 프리셋(command-code)은 저장된 계정 bearer를 사용하고, Provider-API 키 프리셋(commandcode)은 현재 설정된 활성 키를 사용합니다. 사용자가 바꾼 유사 base URL은 조회하지 않습니다. Command Code가 기간 사용량을 함께 반환하면 남은 monthly / purchased / free credits가 USD 창으로 표시됩니다.

OrcaRouter 브라우저 로그인(ocx login orcarouter-oauth)의 키 교환 성공 응답 본문은 64 KiB 이하의 유효한 UTF-8 JSON이어야 합니다. 해당 키 교환 요청의 기존 30초 제한은 응답 헤더와 전체 본문 수신을 포함하며, 크기를 초과하거나 형식이 잘못된 본문은 키를 저장하기 전에 거부합니다. 이 제한은 로그인 키 교환에만 적용되며 추론 요청 본문의 제한이 아닙니다. scope 검사는 그대로 유지되어 생략은 허용하고 명시적으로 잘못된 값은 거부합니다.

SambaNova Cloud 검색: 프리셋은 고정 API 호스트의 SambaNova Cloud 공개 /v1/models 목록을 읽고, 프로바이더 네이티브 ID를 보존하며 discovery를 128 KiB와 raw 행 128개로 제한합니다. 카탈로그에는 인증이 필요하지 않으므로 CLI 로그인 흐름은 공개 응답을 키 유효성의 증거로 사용하지 않고 키를 검증할 수 없는 것으로 보고합니다. chat 요청은 계속 설정된 Bearer 키를 사용하고 SambaNova가 아직 지원하지 않는 병렬 function call은 비활성화합니다. 비공개 SambaStudio deployment 엔드포인트는 범위에서 제외합니다. 키는 SambaNova Cloud에서 생성합니다.

Nebius Token Factory 검색: 프리셋은 인증된 verbose 모델 카탈로그를 요청하고 architecture가 text를 출력하는 행만 유지해 embedding 및 image-generation 모델을 제외합니다. 슬래시가 포함된 네이티브 ID와 보고된 context 및 input modality metadata를 보존하며 discovery를 512 KiB와 raw 행 512개로 제한합니다. dedicated deployment 호스트는 범위에서 제외합니다. 키는 Nebius Token Factory에서 생성합니다.

Crusoe 검색: 키 기반 프리셋은 openai-chat adapter를 사용하며 Bearer key를 Crusoe의 고정 Serverless Inference host에만 보냅니다. /v1/models는 인증되지 않은 요청을 401로 거부하므로 list 성공을 key 검증으로 간주합니다. discovery는 zai-org/GLM-5.3, moonshotai/Kimi-K2.6처럼 슬래시로 구분된 네이티브 id를 Crusoe가 반환한 그대로 유지하고 256 KiB와 raw 256행으로 제한합니다. is_public: true이면서 architecture.modality가 text 또는 multimodal인 행만 유지하므로 계정 전용 배포와 embedding, 미디어 행은 제외됩니다. reasoning model은 사고 내용을 Chat Completions의 reasoning field로 반환하며 adapter가 이를 읽습니다. reasoning_effort 단계(low, medium, high)를 받는 것은 openai/gpt-oss-120b만이고 다른 reasoning model은 이 field를 on/off 토글로 취급하므로, provider 전체 effort 단계나 parallel tool call은 광고하지 않습니다. rate limit은 project와 model 단위로 적용되며(초과 시 429, 공유 deployment 확장 중 503) 신규 계정에는 $5 무료 크레딧이 제공됩니다. 키는 Crusoe Cloud console의 Intelligence Foundry > Inference에서 생성합니다.

DigitalOcean 검색: 프리셋은 model access key를 고정된 공유 Serverless Inference 호스트에 사용하고, 인증된 /v1/models 응답과 DigitalOcean 공식 문서로 확인한 Chat Completions allowlist의 교집합만 노출합니다. 알 수 없는 ID, Responses 전용, embedding 및 media-generation ID는 fail closed로 제외하며, discovery를 256 KiB와 raw 행 256개로 제한합니다. agent 전용 및 dedicated 호스트는 범위에서 제외합니다. 키는 DigitalOcean Control Panel에서 생성합니다.

Scaleway 검색: 인증된 모델 목록과 공식 문서로 확인한 Serverless Chat Completions allowlist의 교집합만 노출합니다. 알 수 없는 ID, Responses 전용, embedding, transcription 및 기타 media-model ID는 fail closed로 제외하고 discovery를 128 KiB와 raw 행 128개로 제한합니다. 기본 Project의 공유 endpoint를 사용합니다. Project ID가 포함된 URL과 dedicated deployment는 custom provider로 설정하세요. API 키는 Scaleway console에서 생성합니다.

Featherless 검색: 이 프리셋은 고정된 OpenAI 호환 host에 인증하고, 상위에서 chat과 현재 plan으로 필터링된 인기 모델 100개만 요청합니다. 이후 registry 규칙은 각 행이 plan 사용 가능 여부, Hugging Face gate 없음, features.tool_use: true를 스스로 보고하지 않으면 fail closed로 제외하고, discovery를 128 KiB와 raw 행 100개로 제한합니다. 덕분에 수만 개 규모의 catalog를 통째로 내려받거나 캐시하지 않습니다. /v1/models는 인증 없이도 호출할 수 있다고 문서화되어 있어 전달한 키가 유효한지 증명하지 못합니다. chat 요청에는 설정된 Bearer key를 그대로 사용합니다. Featherless 약관은 개인 plan을 대화형 및 프로토타이핑 용도로 제한하며, 임의의 애플리케이션에는 Scale plan이 필요합니다. 키는 Featherless dashboard에서 생성합니다.

Novita 검색: 키 기반 프리셋은 openai-chat adapter를 사용하며 Bearer key를 Novita의 고정 OpenAI 호환 host에만 보냅니다. 공개 model list에서 model_type: chat과 chat/completions endpoint를 모두 보고하는 행만 유지하고 discovery를 512 KiB와 raw 256행으로 제한합니다. catalog가 공개되어 있으므로 login은 list 성공을 key 증명으로 간주하지 않고 검증 불가로 보고합니다. model별 capability가 다르므로 provider 전체 parallel tool call이나 OpenAI reasoning_effort를 광고하지 않습니다. 키는 Novita key manager에서 생성합니다.

Baseten 범위: 이 프리셋은 Baseten의 공유 Model APIs만 지원합니다. 로컬 사용에는 개인 API 키를, 공유/프로덕션 사용에는 Call Model APIs 권한이 있는 팀 키를 사용하세요. 전용 Truss predict 엔드포인트는 호스트와 스키마가 다르므로 이 프리셋으로 라우팅되지 않습니다. 이 프리셋의 실시간 검색은 응답 1 MiB와 원시 모델 행 256개로 제한됩니다.

A6API 크레딧 쿼터

섹션 제목: “A6API 크레딧 쿼터”

openai-chat, authMode: "key", 공식 https://api.a6api.com 또는 https://api.a6api.com/v1 주소를 사용하는 사용자 지정 프로바이더는 대시보드와 ocx account refresh <provider>에서 A6API 크레딧 사용량을 표시합니다. 프로바이더 이름은 자유롭게 정할 수 있습니다. 계정의 hard credit limit을 기준으로 토큰 단위를 USD로 환산해 사용률과 남은 크레딧을 표시하며, 토큰 만료는 충전을 뜻하지 않으므로 쿼터 리셋으로 표시하지 않습니다. 활성 키만 공식 호스트로 전송하고 리디렉션을 거부하며, 음수이거나 서로 일치하지 않는 결제 합계에는 보고서를 만들지 않습니다.

Tencent Cloud Coding Plan 사용 제한: Tencent는 이 구독을 대화형 코딩 도구 전용으로 안내합니다. 일반 API 자동화, 사용자 애플리케이션 백엔드 및 비대화형 일괄 호출은 금지되며 플랜 키가 정지될 수 있습니다.

GLM 과금 경로: zai는 Z.AI 국제 코딩 플랜 구독이고, zhipu-bigmodel은 Zhipu의 중국 내수 BigModel 종량제 엔드포인트입니다. 호스트도 키도 과금도 다르며, 한쪽에서 발급한 키는 다른 쪽에서 인증되지 않습니다.

여러 API 키

섹션 제목: “여러 API 키”

키 기반 프로바이더도 여러 키를 보관할 수 있습니다. Providers 페이지에서 키를 추가하면 provider.apiKeyPool에 저장하고 이를 활성화하며, 라우팅과 어댑터가 이전처럼 같은 필드를 읽도록 provider.apiKey에도 반영합니다. 같은 드롭다운에서 키를 전환하거나 제거할 수 있습니다. 관리 API는 /api/providers/keys이며 마스킹된 키만 반환합니다.

터미널에서 계정 전환하기

섹션 제목: “터미널에서 계정 전환하기”

대시보드를 열지 않고도 ocx account list, ocx account current, ocx account use로 같은 Codex, OAuth, API-key pool을 확인하고 전환할 수 있습니다. 전체 명령, JSON 출력, 새 세션 적용 방식은 CLI 레퍼런스를 참고하세요.

GPT-5.6 프리뷰 경로

섹션 제목: “GPT-5.6 프리뷰 경로”

실시간 모델 카탈로그 갱신이 늦어도 ocx sync에서 모델이 사라지지 않도록 GPT-5.6 Sol/Terra/Luna를 폴백 목록에 넣어 둡니다.

Codex 경로 미리 등록된 모델 id Codex에 표시되는 컨텍스트
Codex 로그인(Pool 또는 Direct) gpt-5.6-* 922,000
OpenAI (API key) openai-apikey/gpt-5.6-*와 *-pro 922,000 (max input 922,000)
OpenRouter openrouter/openai/gpt-5.6-sol, openrouter/openai/gpt-5.6-terra, openrouter/openai/gpt-5.6-luna 922,000
Cursor cursor/gpt-5.6-sol, cursor/gpt-5.6-terra, cursor/gpt-5.6-luna 1,000,000

네이티브 GPT-5.6 항목은 고정된 업스트림 reasoning 단계를 그대로 따릅니다. 예를 들어 Luna에는 max는 있지만 ultra는 없습니다. 라우팅 모델은 각 프로바이더의 메타데이터와 reasoning 매핑을 사용합니다. 네 경로 모두 실제 사용 권한은 업스트림 계정이 결정하며, Cursor는 실시간 탐색 결과를 기준으로 현재 계정에서 쓸 수 있는 모델만 남깁니다.

Ollama Cloud

섹션 제목: “Ollama Cloud”

Ollama Cloud는 호스팅형(로컬이 아님) Ollama입니다. https://ollama.com/v1으로 설정하고 키는 ollama.com/settings/keys에서 발급받습니다. opencodex는 OpenAI 호환 표면이 아니라 Ollama 자체 REST API(POST /api/chat)로 연결하며, 모델 목록을 공급자에서 직접 발견하므로 새 Ollama Cloud 모델이 설정 변경 없이 나타납니다. opencodex는 클라우드 라인업을 비전 기능에 따라 분류하여 비전 사이드카가 텍스트 전용 모델에만 작동하도록 합니다. 텍스트 전용 모델(예: glm-5.2, deepseek-v4-flash, gpt-oss, qwen3-coder, minimax-m2.x, nemotron-3-*)은 noVisionModels에 나열되며, 비전 네이티브 모델(예: kimi-k2.6, minimax-m3, gemma4, qwen3.5, gemini-3-flash-preview)은 포함되지 않습니다. 매칭은 Ollama의 :size 태그에 관대하므로 gpt-oss는 gpt-oss:120b와 gpt-oss:20b를 모두 포괄합니다.

Ollama는 현재 구조화 출력이 Ollama Cloud에서 지원되지 않는다고 문서화하고 있습니다. 정식 ollama-cloud에 대한 구조화 출력 요청(text.format)은 opencodex가 자유 서술을 조용히 돌려주는 대신 명확한 오류로 거부합니다. 로컬 / 커스텀 ollama-native 엔드포인트는 Ollama의 네이티브 format 동작을 유지합니다.

4. 로컬 프로바이더

섹션 제목: “4. 로컬 프로바이더”

opencodex를 로컬 OpenAI 호환 서버로 향하게 하세요 — 보통은 빈 키와 함께 사용합니다:

프로바이더 베이스 URL
Ollama (local) http://localhost:11434/v1
vLLM http://localhost:8000/v1
LM Studio http://localhost:1234/v1

모든 OpenAI 호환 엔드포인트

섹션 제목: “모든 OpenAI 호환 엔드포인트”

프로바이더가 Chat Completions를 사용한다면 openai-chat 어댑터가 이를 처리합니다 — 대시보드에서 Custom을 선택하거나 ocx init에서 custom을 선택한 뒤 베이스 URL을 입력하세요. 모든 프로바이더 필드 (headers, noReasoningModels, noVisionModels, models, …)는 설정 레퍼런스를 참고하세요.

Antigravity 쿼터 조회 실패 확인

섹션 제목: “Antigravity 쿼터 조회 실패 확인”

계정 쿼터 화면과 ocx account list google-antigravity --quota --refresh는 접근 거부, 요청 한도, 목적지·리디렉션 차단, DNS·연결·시간 초과, 읽을 수 없는 응답을 구분합니다. 조회가 실패해도 마지막 관측 막대와 시각은 유지합니다. 재로그인하면 이전 자격 증명의 진단을 버리고, 조회에 성공하면 오류 표시를 지웁니다.

접근 거부만으로 로그인 만료나 플랜 사용 불가를 단정하지 않습니다. 목적지 차단도 Fake-IP 결함의 증거는 아닙니다. Google의 고정 쿼터 주소에는 TLS 인증서 확인과 리디렉션·사설 주소 제한이 유지됩니다. 인증된 TUN 환경의 동작은 해당 환경에서 별도로 확인해야 합니다.