Codex VS Code API 키: 사용자 지정 엔드포인트 사용

설정할 내용

VS Code의 코딩 어시스턴트는 HTTP를 통해 모델과 통신합니다. 대부분 OpenAI API 형식을 사용하므로 벤더 기본값 대신 사용자 정의 베이스 URL과 키를 지원합니다. 이 서비스는 OpenAI 호환이므로 해당 옵션을 제공하는 모든 도구에 연결할 수 있습니다.

상대방이 무엇인지 명확히 하십시오. 이는 독립적인 공급자가 운영하는 단일 오픈 웨이트 모델로, 합법적인 성인 사용에 대한 콘텐츠 거부 없이 응답하도록 조정되었습니다. 이는 OpenAI의 Codex 모델이나 다른 공급자의 공식 API가 아닙니다. 텍스트 전용이며 컨텍스트 창은 100,000 토큰, 함수 호출 및 JSON 모드를 지원합니다. OpenAI 스타일 라우트의 세부 정보가 필요하면 문서를 읽으십시오. 주소만 필요하면 Codex API 베이스 URL 페이지를 참조하십시오.

모든 곳에서 사용할 세 가지 값은 다음과 같습니다:

키를 발급받고 먼저 테스트하십시오

Google 또는 이메일과 비밀번호로 API 키 페이지에 계정을 만드십시오. 신규 사용자는 한 번의 클릭으로 $0.50의 체험 크레딧을 청구할 수 있으며, 이는 7일 동안 유효하고 카드가 필요하지 않습니다. 그런 다음 VS Code를 설정하기 전에 터미널에서 키를 테스트하십시오. 작동하는 curl 호출은 키와 URL이 유효함을 증명하므로, 이후 오류는 확장 프로그램 관련 문제입니다.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

응답은 채팅 완료 JSON이며, 응답에는 남은 크레딧을 나타내는 X-Balance-USD 헤더가 포함됩니다. 키는 환경 변수나 확장 프로그램의 비밀 저장소에 보관하고 저장소에는 절대 넣지 마십시오.

Codex 확장 프로그램 및 CLI: 구성 파일

OpenAI의 Codex 툴링은 홈 디렉터리의 TOML 구성 파일을 통해 사용자 지정 모델 공급자를 지원하며, VS Code 확장 프로그램은 해당 구성을 CLI와 공유하도록 문서화되어 있습니다. 형식이 진화했으므로 현재 Codex 문서에서 버전에 따라 이를 확인하십시오.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

확인할 항목:

• base_url은 /v1로 끝나야 하며, /chat/completions은 포함하지 않아야 합니다.
• env_key은 키 자체가 아닌 환경 변수의 이름입니다.
• wire_api은 요청 형식을 선택합니다. 이 서비스는 POST /v1/chat/completions과 POST /v1/responses 모두를 허용합니다. "chat"으로 먼저 시도하십시오. Codex 버전에서 "responses"가 필요한 경우 이를 사용하십시오.
• 변수가 설정된 셸에서 VS Code를 시작하거나 프로필에 변수를 추가한 후 다시 시작하십시오. macOS의 GUI 시작은 셸 내보내기를 인식하지 못하는 경우가 많습니다.

에이전트 스타일 도구는 함수 호출에 의존합니다. 여기서는 스트리밍 함수 호출을 포함하여 지원되지만 품질은 모델에 따라 다르므로 먼저 작은 작업을 실행하십시오. Cursor에서 API 사용 관련 페이지는 다른 편집기에서 유사한 설정을 다룹니다.

Continue, Cline 및 기타 확장 프로그램

서드파티 확장 프로그램은 각각 고유한 화면을 제공하지만 패턴은 일정합니다: OpenAI 또는 "OpenAI 호환" 공급자를 선택한 다음 기본 URL, 키 및 모델을 입력합니다. Continue는 YAML 구성을 사용합니다:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline와 Roo Code는 설정 패널에 "OpenAI 호환" 공급자를 제공하며 동일한 세 가지 필드를 사용합니다. 이름과 메뉴는 자주 변경되므로 "OpenAI 호환" 또는 "사용자 지정 기본 URL"에 대해 확장 프로그램 자체의 문서를 검색하십시오. 확장 프로그램에 기본 URL 필드가 없으면 해당 엔드포인트를 사용할 수 없습니다.

시간을 절약하는 팁:

• 호스팅된 모델에 대한 탭 자동 완성을 비활성화하십시오(일시 정지할 때마다 요청을 보내려는 경우는 제외). 채팅 및 편집 작업이 더 저렴합니다.
• 일상적인 편집에는 확장 프로그램에서 컨텍스트 창을 더 작게 설정하십시오. 전체 저장소를 모델에 보내면 매번 입력 토큰이 소모됩니다.
• 도구별로 별도 키를 사용하여 어느 도구가 크레딧을 사용하는지 파악하십시오.

어떤 편집기 작업에 이 모델이 적합한가

큰 컨텍스트 창을 가진 범용 텍스트 모델은 여러 일상적인 작업에 적합합니다: 낯선 코드 설명, 함수 단위 테스트 작성, 스크립트 언어 간 변환, docstring 및 regex 작성, 전체 파일을 붙여넣을 때 모듈 다시 작성 등. 100,000 토큰 컨텍스트 창은 몇 개의 중간 크기 파일과 지시문을 하나의 요청에 포함할 수 있으며, 완료 결과는 남은 용량을 활용할 수 있습니다.

나머지에 대해 현실적으로 판단하십시오. 이는 편집기 인식 훈련을 받은 전문 코딩 모델이 아니므로, 대규모 다중 파일 에이전트 실행은 해당 도구보다 더 많은 가이드와 검수가 필요할 수 있습니다. 전체 파일 대신 diff를 요청하고, 수락하기 전에 모든 변경 사항을 검토한 후 테스트를 실행하십시오. 필터된 어시스턴트가 거부하는 콘텐츠(합법적인 성숙한 소설 구조나 보안 연구 텍스트 등)가 필요한 작업의 경우, 콘텐츠 거부 없는 엔드포인트를 사용하는 이유가 됩니다.

편집기에서의 비용

가격은 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50입니다. 코딩 도구는 많은 컨텍스트를 전송하므로 입력을 먼저 확인하십시오.

예: 파일 컨텍스트 8,000 토큰과 600 토큰 답변이 있는 편집 요청의 비용은 8,000 x $0.15 / 1M + 600 x $0.50 / 1M = $0.0012 + $0.0003 = $0.0015입니다. 하루 150개의 이러한 요청 비용은 150 x $0.0015 = $0.225입니다. 20일 근무일: $4.50.

많은 파일을 읽는 에이전트는 단계당 40,000개의 토큰을 보낼 수 있습니다. 그 크기에서 한 단계당 비용은 $0.006에 출력 비용이 더해지며, 100단계에는 약 $0.60에 출력 비용이 더해집니다. 에이전트 루프에 주의를 기울이십시오. 실패하거나 거부된 요청에는 요금이 부과되지 않으며, 선불 크레딧은 만료되지 않습니다. $20에서 $500까지 충전은 카드(Visa, Mastercard, Apple Pay, Google Pay) 또는 암호화폐로 결제할 수 있습니다. 현재 요금제는 요금제 페이지에 나열되어 있습니다.

문제 해결

401 Unauthorized

키가 누락되었거나 불필요한 공백이 있거나 환경 변수가 VS Code에서 보이지 않습니다. 변수가 설정된 터미널에서 편집기를 다시 시작하십시오.

404 또는 "모델을 찾을 수 없음"

정확한 모델 uncensored과 /v1로 끝나는 기본 URL을 사용하십시오.

429 오류

전체 키는 동시 8개, 분당 300개 요청을 허용합니다. 체험 키는 동시 2개, 분당 60개입니다. 자동완성+채팅 같은 확장 프로그램은 동시성 제한에 도달할 수 있습니다. 오류 코드는 동시 초과 시 concurrency, 분당 제한 시 rate_limited입니다. Retry-After: 5 헤더는 일시적 과부하를 의미합니다.

스트리밍 중단

일부 기업용 프록시는 서버 전송 이벤트를 버퍼링합니다. 다른 네트워크에서 테스트하거나 확장 프로그램에서 스트리밍을 끄십시오.

다른 어시스턴트에서 본 답변과 다름

예상된 현상입니다. 이는 고유한 강점을 가진 다른 모델입니다. 명확하고 구체적인 지시문을 제공하고 자체 프로젝트의 코드에서 테스트하십시오.

더 많은 가이드

• Python에서 Codex API: 코딩 LLM 호출
• Codex API 기본 URL: 클라이언트를 우리 서비스에 연결하는 방법