Codex CLI 프로바이더

프로바이더 인스턴스 (Provider Instance)

ai-sdk-provider-codex-cli에서 기본 프로바이더 인스턴스 codexCli를 임포트할 수 있어요:

import { codexCli } from 'ai-sdk-provider-codex-cli';

커스터마이즈가 필요하면 createCodexCli를 임포트하고 모든 모델에 적용되는 기본 설정을 제공할 수 있어요:

import { createCodexCli } from 'ai-sdk-provider-codex-cli';

const codexCli = createCodexCli({
  defaultSettings: {
    reasoningEffort: 'medium',
    approvalMode: 'on-failure',
    sandboxMode: 'workspace-write',
    verbose: true,
  },
});

또는 모델별로 설정을 전달할 수 있어요:

const model = codexCli('gpt-5.1-codex', {
  reasoningEffort: 'high',
  approvalMode: 'on-failure',
  sandboxMode: 'workspace-write',
});

모델 설정:

• reasoningEffort 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' - 추론 깊이를 제어해요.
• approvalMode 'untrusted' | 'on-failure' | 'on-request' | 'never' - 도구 승인 정책.
• sandboxMode 'read-only' | 'workspace-write' | 'danger-full-access' - 샌드박스 제한.
• mcpServers Record<string, McpServerConfig> - MCP 서버 설정.
• verbose boolean - 상세 로깅 활성화.
• logger Logger | false - 커스텀 로거 또는 로깅 비활성화.

언어 모델 (Language Models)

프로바이더 인스턴스를 사용해 Codex CLI를 통해 GPT-5를 호출하는 모델을 만들어요:

const model = codexCli('gpt-5.2-codex');

현재 세대 모델 (Current Generation Models):

• gpt-5.3-codex: 최신 에이전틱 코딩 모델
• gpt-5.2: 최신 범용 모델
• gpt-5.1-codex-max: 깊은 추론을 지원하는 플래그십 모델 (xhigh reasoning 지원)
• gpt-5.1-codex-mini: 가볍고 더 빠른 변형

레거시 모델 (Legacy Models, 여전히 지원):

• gpt-5.1: 범용
• gpt-5.1-codex: Codex 변형
• gpt-5: 이전 세대
• gpt-5-codex: 이전 Codex 변형
• gpt-5-codex-mini: 이전 경량 변형

예시 (Example)

import { codexCli } from 'ai-sdk-provider-codex-cli';
import { generateText } from 'ai';

const { text } = await generateText({
  model: codexCli('gpt-5.2-codex'),
  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
});

추론 설정 (Reasoning Configuration)

const model = codexCli('gpt-5.1-codex-max', {
  reasoningEffort: 'high', // 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
  reasoningSummary: 'detailed',
});

참고: xhigh 추론 수준은 gpt-5.1-codex-max와 이를 지원하는 더 새로운 모델군(GPT-5.2 변형이 Codex CLI 버전에서 지원되는 경우 포함)에서 사용할 수 있어요.

모델 기능 (Model Capabilities)

참고: 도구 사용과 도구 스트리밍이 ❌로 표시되는 이유는 이 프로바이더가 AI SDK 커스텀 도구(generateText/streamText에 전달하는 Zod 스키마)를 지원하지 않기 때문이에요. 대신 Codex CLI가 자체 도구를 자율적으로 실행하며, 이는 스트리밍 이벤트로 관찰할 수 있어요. 객체 생성은 보장된 스키마 준수를 위해 --output-schema를 통한 네이티브 JSON Schema 지원을 사용해요.

인증 (Authentication)

이 프로바이더는 Codex CLI를 통해 기존의 ChatGPT Plus/Pro 구독을 사용해요:

npm install -g @openai/codex
codex  # 대화형 인증 설정 진행

또는 OPENAI_API_KEY 환경 변수를 설정해 OpenAI API 키를 사용할 수도 있어요.

요구 사항 (Requirements)

• Node.js 22 이상
• 전역에 설치된 Codex CLI (JSON 지원은 v0.42.0+, 최신 모델에는 v0.60.0+ 권장)
• ChatGPT Plus/Pro 구독 또는 OpenAI API 키

자세한 내용은 프로바이더 문서를 참고하세요.

더 알아보기 (Learn more)

• 커스텀 프로바이더 작성하기

전체 사이트맵