Codex에서 DeepSeek V4.1 Flash 사용하기: 설정과 동작 확인
DeepSeek의 Responses API와 전체 모델 목록, 공식 설정 스크립트로 Codex를 연결합니다. deepseek-flash 선택과 유료 작업 실행 전에 확인할 설정을 안내합니다.
Ofox 
Codex에서 DeepSeek V4.1 Flash를 쓰려면 deepseek-flash를 선택하고, DeepSeek를 Responses API 공급자로 설정한 뒤 전체 모델 목록을 설치해야 합니다. DeepSeek는 공식 Codex 연동 가이드에 설정 스크립트와 수동 설정을 모두 제공합니다.
확인 기준일은 2026년 9월 10일입니다. 공식 DeepSeek 서비스의 직접 연결을 다루며 유료 추론이나 Codex 코딩 세션의 성공을 확인한 것은 아닙니다. 모델 발표는 출시 안내, 직접 API 요청은 API 연결 가이드를 참고하세요.
설치된 Codex에 공식 설정 적용하기
Codex를 설치하고 한 번 이상 실행한 상태에서 시작합니다. DeepSeek 스크립트는 ~/.codex 디렉터리가 있다고 가정합니다. codex --version으로 설치 버전을 확인하세요. 현재 공식 모델 목록의 최소 클라이언트 버전은 0.144.0이며, 반드시 그 버전만 설치하라는 뜻은 아닙니다.
macOS나 Linux에서는 실행 전에 내용을 확인할 수 있도록 공식 스크립트를 다운로드하세요.
curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.sh \
-o /tmp/codex-deepseek-setup-en.sh
less /tmp/codex-deepseek-setup-en.sh
bash /tmp/codex-deepseek-setup-en.sh메뉴 1을 선택해 deepseek-flash를 설정하고 DeepSeek Platform에서 발급받은 키를 입력합니다. 공식 설명에 따르면 스크립트는 config.toml을 ~/.codex/backup-deepseek/에 백업하고 모델 목록을 작성한 뒤 필요한 공급자 설정을 변경합니다. 작업 전에 표시된 변경 내용을 검토하세요. 공식 가이드에는 Windows용 PowerShell 스크립트도 있습니다.
이전 DeepSeek 설정을 설치했다면 현재 스크립트를 다시 실행해 기존 Flash 항목을 갱신할 수 있습니다. 메뉴 2는 9월 14일 전환 예정인 V4 Pro를 선택합니다. 새 V4.1 설정에서는 Flash를 명시적으로 고르세요.
수동 설정에는 전체 모델 목록이 필요합니다
이 파일에는 이름뿐 아니라 컨텍스트, 추론 수준, 입력 유형과 도구 동작 정보도 들어 있습니다. 공식 가이드의 수동 설정 부분에서 models.json 전체 내용을 ~/.codex/models.json에 복사하세요. 임의로 만든 짧은 JSON으로 대체하지 마세요.
그런 다음 기존의 관계없는 설정을 유지하면서 가이드의 공급자 설정을 ~/.codex/config.toml에 병합합니다. 아래 표는 핵심 확인 값이며 설정 파일을 대신하지 않습니다.
| 필드 | 공식 설정값 |
|---|---|
model | deepseek-flash |
model_provider | deepseek |
model_catalog_json | ~/.codex/models.json |
model_reasoning_effort | high |
공급자 base_url | https://api.deepseek.com/ |
공급자 wire_api | responses |
전체 예시에는 API 인증 설정, 기본 웹 검색 비활성화와 experimental_bearer_token 키 설정도 포함됩니다. 이 설정과 백업은 인증 정보로 취급하고 공유 저장소에 커밋하지 마세요. Chat Completions 엔드포인트나 모델 이름만 있는 JSON으로는 공식 설정을 재현할 수 없습니다.
선택 모델과 실제 작업 확인하기
작은 테스트 프로젝트에서 codex를 실행하세요. DeepSeek 가이드는 CLI 시작 배너의 model: deepseek-flash 표시를 설정 확인 기준으로 안내합니다. 작업을 보내기 전에 설정 오류부터 살펴보세요. JSON 문법, 목록 파일 위치와 공급자 선택은 서로 다른 점검 항목입니다.
이후 기대 결과를 아는 작은 코딩 작업으로 확인합니다. 한 파일의 설명을 요청한 다음 작은 수정과 관련 테스트를 실행하세요. 변경 내역과 테스트 결과를 검토합니다. 이미지 입력이 중요하다면 대표 스크린샷도 포함하세요. 모델 선택 성공만으로 해당 환경의 도구나 이미지 호환성을 확인할 수는 없습니다.
테스트 예산은 현재 Flash 요금으로 계산하세요. Anthropic 프로토콜 연결은 별도의 Claude Code 가이드에서 다룹니다.
Ofox를 검토한다면 먼저 모델 목록, 정확한 모델 ID와 Responses 지원을 확인하세요. 이 직접 연결 설정은 Ofox의 경로, 가격이나 제공 여부를 확인한 것이 아닙니다.
자주 묻는 질문
- Codex는 DeepSeek V4.1 Flash와 어떤 API 프로토콜로 연결되나요?
- DeepSeek의 Codex 연동은 Responses API를 사용하며 wire_api를 responses로 설정합니다. 공식 공급자 베이스 URL은 https://api.deepseek.com/이고 모델 ID는 deepseek-flash입니다.
- Codex 모델 이름만 바꾸면 되나요?
- 아닙니다. 공식 설정에는 공급자와 인증 설정, 전체 models.json 목록 설치도 포함됩니다. 축약된 목록 대신 공식 스크립트나 전체 수동 설정을 사용하세요.
- 이 가이드는 유료 Codex 세션의 성공을 확인했나요?
- 아닙니다. 2026년 9월 10일 기준 문서의 설정을 대조했습니다. 실제 환경에서 인증, 모델 선택과 대표 코딩 작업을 검증해야 합니다.
