개인정보 설정

개인정보 및 GDPR 통지

Nfero는 언어 기본 설정과 데모 접근 제어를 위해 필수 저장소를 사용합니다. 동의한 경우 Google Analytics와 가벼운 사용 이벤트를 모델 데모와 외부 구독 경로 개선에 사용합니다. 라이브 데모 프롬프트는 구성된 Alibaba 호스팅 모델 엔드포인트로 전송될 수 있습니다.

도구 + 모델 연계

Codex과 알리바바 코딩 계획 및 크레딧 계획 (Token Plan)

오픈아이의 명령줄 프로그래밍 도구로, 알리바바 호환 코딩 도구와 동일한 구매자 대화에 위치할 수 있습니다.

Codex는 `~/.codex/config.toml`의 사용자 정의 공급자를 통해 Alibaba Model Studio에 연결할 수 있습니다. 호환성은 모델 API과 Codex 버전 모두에 따라 달라집니다. 알리바바는 현재 선택된 Qwen Token Plan 모델에 대해 Responses API를 통한 Codex 지원 현황을 문서화하고 있습니다.

올바른 액세스 경로 선택

올바른 액세스 경로 선택

Token Plan을(를) 최신 Codex 릴리스 버전과 Responses 호환 Qwen 모델과 함께 사용하세요. 현재 Alibaba는 Coding Plan 사용자 및 기타 챗/완성 전용 모델을 선택한 사용자에게 0.80.0과 같은 이전 버전의 Codex를 설치하도록 안내하고 있습니다. 따라서 Codex 단독 구독 전에 해당 타협점을 검토하십시오.

추천Token Plan는 현재 Codex와의 연동을 위한 보다 깔끔한 경로입니다.

Token Plan (Team Edition)

현재 Codex 릴리스와 qwen3.7-max, qwen3.7-plus, qwen3.6-plus, 또는 qwen3.6-flash 모델을 Responses API를 통해 사용할 때 최적입니다.

Coding Plan

알리바바의 현재 안내에 따르면, Coding Plan는 여기서 챗/완성(Completions) 기능만 지원하며, Codex 사용자에게는 0.80.0과 같은 이전 릴리스를 설치하도록 권장합니다.

Pay-as-you-go Model Studio API

프로덕션 환경/API 워크로드 또는 지원되는 pay-as-you-go 모델 및 리전이 애플리케이션 요구 사항과 더 잘 부합할 때 사용하세요.

안전한 구성 패턴

Responses 호환 Token Plan 공급자 구성

예시는 의도적으로 마스킹되어 있습니다. 플레이스홀더는 사용자의 기기에서만 교체하고, 실제 API 키를 Nfero에 붙여넣지 마세요.

시작하기 전에

  1. Node.js 18 이상을 설치하고 `codex --version` 명령어로 버전을 확인하세요.
  2. 사용하려는 Codex 버전과 호환되는 API를 갖춘 모델을 선택하세요.
  3. 전용 Token Plan 또는 Coding Plan 키를 확보하세요. 이를 TOML 파일에 직접 기재하지 말고 환경 변수로 설정하세요.
  4. 기존 OpenAI 또는 사용자 정의 공급자를 대체하기 전에 `~/.codex/config.toml` 파일을 백업하세요.

안전한 구성 패턴

프로토콜
OpenAI Responses API
구성 경로
~/.codex/config.toml
  1. 장치의 `OPENAI_API_KEY`에 실제 전용 키를 설정하세요. 아래 파일에 직접 기록하지 마세요.
  2. Codex 최신 릴리스와 호환되는 알리바바에서 문서화한 Responses 지원 Qwen 모델 중 하나를 선택하세요.
  3. 사용자 정의 프로바이더를 추가하고 Token Plan 기본 URL을 사용하세요.
  4. 새 터미널을 열고 `codex`를 실행하여 구성 사항을 테스트하세요.
toml
model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-plus"

[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

# Set locally; never paste the real value into this file or Nfero:
# OPENAI_API_KEY=YOUR_TOKEN_PLAN_API_KEY

연결 확인

  • `OPENAI_API_KEY`가 Codex에서 사용 가능하도록 새 터미널을 엽니다.
  • `codex --version` 명령어를 실행하고, 구성한 API 경로와 버전이 일치하는지 확인하세요.
  • `codex`를 시작하고, 먼저 작은 읽기 전용 저장소 관련 질문을 사용하세요.
  • 프로바이더 스위처에서 상태 점검 실패가 보고된 경우, Codex 자체를 테스트하세요. 알리바바는 일부 프로브 형식이 실제 요청은 정상 작동함에도 불구하고 실패할 수 있음을 명시하고 있습니다.

모델 연계

추천 시작 모델

이 도구을 사용하여 각 모델과 함께 대화형 코딩, 추론, 검토 및 문서 작업을 수행하세요. 생산 환경에서 최종 모델 가용성과 정확한 계획 지원은 Alibaba Cloud에서 확인하십시오.

텍스트 생성추론시각적 이해
최적의 조합 각도

Token Plan와 Responses 호환 가능하며, 현재 시점에서 코딩 및 추론 작업을 균형 있게 수행하는 경로입니다.

텍스트 생성추론
최적의 조합 각도

복잡한 추론 및 저장소(레포지토리) 작업에 적합한, Responses 호환 Token Plan의 플래그십 모델입니다.

텍스트 생성추론시각적 이해
최적의 조합 각도

긴 컨텍스트 작업을 위한 Responses 호환 Token Plan 대안 모델입니다.

자주 발생하는 문제

자주 발생하는 문제

증상

400 Bad Request 오류 또는 프로바이더 스위처에서 국내 모델이 지원되지 않는다고 표시됨

가능한 원인

타사 스위처의 상태 점검 요청이 Codex가 보내는 요청과 다릅니다.

해결 방법

프로바이더를 거부하기 전에 Codex를 직접 테스트하세요. 실패한 프로브가 실제 호환성 문제를 의미하지 않을 수 있습니다.

증상

Responses API 오류 또는 와이어 프로토콜 오류

가능한 원인

선택한 모델이 Chat/Completions만 지원하거나, Codex 버전이 Responses를 기대하고 있습니다.

해결 방법

현재 Codex와 호환되는 문서화된 Responses 지원 Qwen 모델을 사용하거나, 알리바바에서 제공하는 이전 버전 가이드에 따라 Chat/Completions 전용 경로를 따르세요.

증상

401 오류 또는 누락된 API 키

가능한 원인

`OPENAI_API_KEY`가 새 셸에서 사용할 수 없거나 다른 알리바바 청구 경로에 속해 있습니다.

해결 방법

환경 변수에 전용 요금제 키를 설정하고, 새 터미널을 열어 해당 요금제의 기본 URL과 함께 사용하세요.

증상

예기치 않은 pay-as-you-go 과금

가능한 원인

사용자 정의 프로바이더가 요금제별 쌍이 아닌 일반 Model Studio 엔드포인트/키를 사용하고 있습니다.

해결 방법

다른 작업을 실행하기 전에 `model_provider`, `base_url`, 그리고 환경 변수 소스를 검사하세요.

주요 제한 사항

  • 동일한 알리바바 청구 요금제에서 제공된 전용 API 키와 기본 URL을 사용해야 합니다. Coding Plan, Token Plan, 일반적인 Model Studio 자격 증명은 상호 교환 불가능합니다.
  • 요금제 키는 인터랙티브 코딩 도구 또는 에이전트 도구에서 지정된 사용자만을 위해 할당됩니다. 이를 공유하거나, 저장소에 커밋하거나, 스크린샷에 노출해서는 안 됩니다.
  • 자동화된 스크립트, 배치 작업, 애플리케이션 백엔드, 공용 서비스 또는 기타 비인터랙티브 API 워크로드에는 Coding Plan 또는 Token Plan 키를 사용해서는 안 됩니다. 이러한 워크로드에는 pay-as-you-go Model Studio API 액세스를 사용하세요.
  • 모델 가용성은 정확한 문자열 허용 목록이며 변경될 수 있습니다. 작동 중인 설정을 수정하기 전에 현재 알리바바 요금제 문서에서 모델 ID를 반드시 확인하세요.