백운(Baiyun) API 튜토리얼: Codex CLI 통합
응답 공급업체, 환경 변수, 압축 및 검색의 실제 경계를 맞춤 설정하세요. 완전한 검사 단계, 실무 검증, 오류 처리가 포함됩니다.
코덱스 CLI 통합
준비
먼저 공식 Codex CLI를 설치하고 장치가 터미널에 있는지 확인하세요 codex --version 출력 가능한 버전을 출력할 수 있습니다; 이미 가지고 있는 것을 백업하세요 ~/.codex/config.toml。 기존 MCP, 프로젝트 권한 또는 기타 벤더 설정을 새로운 구성으로 덮어쓰지 마세요.
이 사이트에서 공급업체 추가
다음 내용을 최상위 구성 파일에 병합하세요 model 내게 줘 model_provider 정의를 반복하지 마세요:
model = "gpt-6-luna"
model_provider = "baiyun"
[model_providers.baiyun]
name = "白云超级智能"
base_url = "https://api.baiyun.si/v1"
env_key = "BAIYUN_API_KEY"
wire_api = "responses"코덱스가 실행되는 같은 터미널 설정에서 BAIYUN_API_KEY； Windows PowerShell은 환경 변수를 사용하고, Linux/macOS는 터미널 환경 변수를 사용합니다. TOML 공용 복사본에 키를 하드코딩하지 마세요. 데스크톱과 터미널 프로세스 간의 환경이 같지 않을 수 있습니다; 시작 방법을 바꾼 후에는 다시 확인해야 합니다.
검증 순서
- 구성을 읽는 코덱스 프로세스를 재시작하세요.
- 실제로 선택한 모델과 공급업체가 동일한지 확인하세요
baiyun。 - 임시 테스트 디렉토리에 짧은 질문을 보내 스트리밍 결과와 사이트의 소비 기록을 관찰하세요.
- 도구가 필요할 때는 테스트 파일을 읽는 것부터 시작하세요; 명령 실행과 파일 수정은 여전히 Codex의 권한 설정을 따릅니다.
사이트 키는 ChatGPT 로그인 자격 증명이 아니라 맞춤형 공급업체 자격 증명이며, 공식 구독 혜택도 부여하지 않습니다.
맥락, 검색 및 할당량
이 사이트는 네이티브 계정 정보, 모델 목록, 응답, 압축, 독립 검색, 할당량 관련 브리징 패스를 통합하고 있습니다. 오픈 패스는 모든 업스트림 함수가 안정적으로 사용 가능하다는 보장은 없습니다: 만약 컨텍스트 압축이 이전에 업스트림 404를 받았다면 오류를 기록하고 수정해야 하며, 오류가 절대 발생하지 않을 것이라고 약속할 수 없습니다. 독립 검색은 클라이언트 버전, 런타임, 모델 지원에 따라 달라집니다; 필요하다고 확인되고 해당 버전이 지원될 때만 추가해야 합니다 supports_standalone_web_search = true。 이 사이트의 DK 지갑은 상류 사용 주기 업데이트로 인해 무료 잔액으로 초기화되지 않습니다.
공식 정보
코덱스는 공급업체 구성을 맞춤화합니다。 이 페이지는 사이트의 글쓰기 스타일을 기반으로 하며, 제3자 게이트웨이를 공식 OpenAI 서비스와 동일시하지 않습니다.
실용 전 체크리스트
- 자신의 계정과 접근 키를 준비하고, 타인의 공유 자격 증명은 사용하지 마세요.
- 문제 해결 시 쉽게 재현할 수 있도록 클라이언트 버전, 시스템 및 모델을 기록합니다.
- 원본 설정이나 스크린샷을 저장하고, 키, 인증 코드, 비공개 콘텐츠를 숨기세요.
- 테스트가 한 문장과 단일 요청에서 시작해 소량의 DK를 소모할 수 있음을 확인하세요.
- 추가 기능을 활성화할지 결정하기 전에 현재 모델 플라자와 상태 페이지를 검토하세요.
상세 문제 해결: 설정 불가
먼저, 병합된 파일이 프로젝트 내 같은 이름의 파일이 아니라 실제 사용자 디렉터리에 있는 config.toml인지 확인하세요. 최상위 model_provider가 baiyun을 가리키는지, 그리고 env_key가 터미널 변수 이름과 일치하는지 확인하세요. 중복 구성은 시작 실패를 초래할 수 있으며, 데스크톱에서 시작할 때 GUI가 터미널 변수를 상속하지 않을 수 있습니다. 오류를 해결하기 위해 모든 설정을 삭제하지 말고, 네트워크 문제를 해결하기 위한 명령 실행 권한을 부여하지 마세요.
이 부분이 학습되었는지 확인하는 방법
"구성 성공적으로 저장됨" 프롬프트만 확인하지 마세요. 현재 기본 URL, 키 사용, 선택한 모델, 요청 프로토콜을 명확히 표시할 수 있어야 하며, 해당 콘솔에서 작업 결과를 검증할 수 있어야 합니다. 클라이언트 측 튜토리얼은 단일 실제 평문 응답과 해당 로그를 초기 완료 표준으로 사용합니다; 계정 튜토리얼은 포괄적인 보안 정보를 기반으로 하며; 청구 튜토리얼은 원금, 채널 수수료, DK 간의 대응 관계를 표준으로 사용합니다.
오류가 발생하면 발생 시간, HTTP 상태, 익명화된 오류의 내용, 그리고 실제 예상 결과를 기록하세요. 전체 페이지 키를 스크린샷하지 말고, 비밀번호나 인증 코드를 다른 사람에게 알려주지 마세요. 401의 경우 인증을 먼저 해결해야 하며, 400의 경우 매개변수를 먼저 해결해야 하며, 429의 경우 집중적인 재시도를 중단해야 하며, 404의 경우 요청 경로와 상류 검증을 검증해야 하며, 재충전이 모든 오류를 해결할 수는 없습니다.
연습하기에 적합한 작은 과제
이 섹션의 최소 단계를 자신의 테스트 환경에서 완료하며, "처음 어떻게 설정했는지, 어떤 항목을 수정했는지, 어떤 결과를 보았는지"를 텍스트로 기록하세요. 생산 데이터, 실제 결제, 복구 불가능한 명령어를 연습으로 간주하지 마십시오. 이 섹션에서 제공하는 기능을 넘어서는 기능을 발견하면, 기능 추가를 고려하기 전에 해당 프로토콜 튜토리얼을 먼저 확인하세요; 한 번에 한 가지 구성만 변경하면 어떤 단계에서 오류가 발생하는지 쉽게 판단할 수 있습니다.
다음 단계는 버전의 경계입니다
전체 학습 지도로 돌아가기 · 간소화된 API 사이트 구성 · 이 사이트의 실시간 현황。
튜토리얼은 2026년 10월 9일에 작성되었습니다. 구체적인 인터페이스와 기능은 클라이언트와 업스트림 버전에 따라 다를 수 있습니다; 구성 지침이 모든 클라이언트 버전이 테스트를 통과했다는 의미는 아닙니다. 잔액 지급, QQ / Alipay 로그인, 오픈 채널에 대해서는 실제 페이지 페이지를 참조해 주세요; 압축 인터페이스: 이전에는 업스트림 404 및 RAW 이미지 채널이 지원되지 않았으므로, 설정 파일이 자동으로 삭제될 수 있다고 가정하지 마십시오.