Codex에서 DeepSeek V4 Flash 및 Pro 사용하기: 설정 및 모델 선택
APIMaster로 Codex에서 DeepSeek를 설정합니다. Windows, macOS, Linux에서 config.toml을 찾고, API 키를 설정하고, 대화형 채팅을 시작하며, 모델을 선택하는 방법을 안내합니다.
APIMaster API 키와 Codex의 config.toml을 설정한 다음 codex를 실행하여 DeepSeek와 대화하세요. deepseek-v4-flash, deepseek-v4-pro 모델을 사용합니다. Codex는 https://apimaster.ai/v1의 Responses API를 통해 연결됩니다.
시작하기 전에
환경 점검을 완료하고, 일반 가이드에 따라 Codex를 설치한 후, 해당 모델에 대한 접근 권한과 충분한 잔액이 있는 APIMaster API 키를 발급받으세요.
codex --version
1. 설정 디렉터리 열기
Windows
Win + R 을 누르고 다음 경로를 입력한 후 Enter를 누릅니다:
%USERPROFILE%\.codex
폴더가 없으면 새로 만드세요. 텍스트 편집기로 config.toml 을 열거나 생성합니다. 파일 이름이 config.toml.txt가 아닌지 확인하세요.
macOS / Linux
macOS에서는 Finder에서 Command + Shift + G 를 누르고 다음을 입력합니다:
~/.codex
Linux에서는 파일 관리자나 편집기로 같은 디렉터리를 엽니다. 필요하면 터미널에서 생성하세요:
mkdir -p ~/.codex
이 디렉터리에서 config.toml 을 열거나 생성합니다. 사용자 지정 Codex 상태 디렉터리를 사용하는 경우 해당 디렉터리를 대신 사용하세요.
2. config.toml 설정
두 플랫폼 모두 동일한 내용을 사용합니다:
model = "deepseek-v4-flash"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
파일이 이미 존재하면 백업한 후 이 설정을 병합하세요. 기존 최상위 키는 중복 생성하지 말고 교체하며, 첫 번째 [table] 헤딩 앞에 배치합니다. provider 섹션이 이미 있으면 병합합니다. 이 설정은 새 Codex 세션의 기본 provider와 모델을 변경합니다.
base URL에는 /v1 이 포함되어 있습니다. wire_api = "responses"를 유지하세요. Chat Completions 엔드포인트만으로는 이 워크플로에 충분하지 않습니다. 요약 설정은 선택 사항인 추론 요약을 비활성화하는 것이지, 모델의 내부 사고 과정을 비활성화하는 것이 아닙니다.
기존 기본 provider를 유지하려면 이 설정을 ~/.codex/deepseek.config.toml에 대신 넣으세요(Windows: %USERPROFILE%\.codex\deepseek.config.toml). 그런 다음 아래 시작 명령에 --profile deepseek를 추가합니다. 이름이 지정된 프로필 파일은 Codex 0.134.0 이상에서 지원되며 다른 기본 설정을 상속합니다.
3. API 키 설정
YOUR_APIMASTER_API_KEY를 APIMaster에서 발급받은 키로 교체하세요. TOML 설정에는 키 자체가 아니라 환경 변수의 이름이 저장됩니다.
Windows PowerShell
Codex를 실행할 터미널에서 실행합니다:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
향후 터미널에서도 사용할 수 있도록 저장하려면:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
영구 변수를 저장한 후에는 새 터미널을 열거나, 첫 번째 명령을 실행한 현재 터미널을 계속 사용하세요.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
이 설정은 현재 터미널에만 적용됩니다. 새 터미널에서도 재사용하려면 동일한 export 줄을 셸의 시작 파일(예: Zsh는 ~/.zshrc, 대화형 Bash는 ~/.bashrc)에 추가한 후 새 터미널을 여세요. 실제 키가 포함된 파일은 비공개로 유지하고 공유 저장소에 두지 마세요.
4. Codex 시작하고 대화하기
프로젝트 디렉터리에서 터미널을 열고 실행합니다:
codex
일반적인 첫 실행 또는 프로젝트 신뢰 프롬프트가 지나면 활성 모델이 deepseek-v4-flash 인지 확인하세요. Codex 대화 에서 다음을 입력합니다:
Reply with exactly OK.
정상적인 응답이 오면 기본 연결이 확인된 것입니다. 이후 코드 설명, 파일 읽기, 변경 작업 등을 요청할 수 있습니다. 일반적인 파일 및 명령 권한 프롬프트를 검토하세요.
5. 다른 모델 선택하기
이러한 사용자 지정 모델 ID의 경우, Codex를 시작할 때 모델을 명시적으로 선택해야 합니다. 한 번에 하나의 명령을 터미널에서 실행 하세요:
codex --model deepseek-v4-flash
codex --model deepseek-v4-pro
각 명령은 대화형 대화를 엽니다. 열려 있는 세션에서 전환하려면 /exit를 입력한 다음 원하는 모델의 명령을 실행하세요. 기존에 저장된 대화를 다른 모델로 이어서 진행하려면 새 대화를 시작하는 대신 codex resume SESSION_ID --model MODEL_ID를 사용하세요.
Codex에서 /model은 모델 카탈로그를 열고, /status는 활성 모델을 표시합니다. 이 메뉴에 APIMaster 모델 마켓플레이스의 모든 모델이 자동으로 나열되지는 않습니다. DeepSeek 모델이 목록에 없으면 위와 같이 --model을 사용하세요. Claude Code의 /model MODEL_ID 문법이 Codex에서 작동한다고 가정하지 마세요. 이 문서에서 검증된 사용자 지정 모델 선택 경로가 아닙니다.
선택 사항인 이름이 지정된 프로필을 사용하는 경우 예시:
codex --profile deepseek --model deepseek-v4-flash
이후 시작 시의 기본값을 변경하려면 사용 중인 설정에서 최상위 model 값을 편집하세요.
문제 해결
| 증상 | 확인 사항 |
|---|---|
| API 키 누락 / 401 | Codex를 시작하는 터미널에서 APIMASTER_API_KEY를 설정하세요. 키 유효성과 잔액을 확인하세요. |
| 다른 provider를 계속 사용함 | model_provider, 선택한 프로필, 프로젝트 재정의, 시작 플래그를 확인하세요. 설정 편집 후 재시작하세요. |
| TOML 파싱 오류 | 중복된 키나 테이블을 피하세요. 최상위 설정은 테이블 헤딩보다 앞에 있어야 합니다. |
| 404 / 지원되지 않는 프로토콜 | https://apimaster.ai/v1와 wire_api = "responses"를 사용하세요. |
| /model에 모델이 없음 | codex --model에 전체 모델 ID를 사용하세요. 내장 카탈로그는 게이트웨이의 모델 목록이 아닙니다. |
| 모델 메타데이터 또는 모델 목록 경고 | 이 ID에는 Codex 메타데이터가 없을 수 있습니다. 최종 응답을 확인하세요. 폴백 컨텍스트 한도는 검증된 모델 성능이 아닙니다. |
| 추론/출력 스트림 경고 | 최종 답변과 도구 결과를 확인하세요. 출력이 중단된 경우 모델, CLI 버전, UTC 시간, 가능하다면 요청 ID와 함께 보고하세요. |
검증 및 선택적 도구 점검
기록된 통합 테스트: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. 여기에 나열된 모든 모델은 예상 텍스트를 반환했고 도구를 사용하여 로컬 파일을 읽었습니다. 복잡한 코딩 작업은 해당 테스트 범위 밖이었습니다. Windows와 macOS 설정 안내는 제공되지만, 해당 운영 체제는 기록된 실행에 포함되지 않았습니다. 이 점검은 전체 기능 호환성, 장시간 세션 동작 또는 최대 컨텍스트 한도를 보장하지 않습니다.
파일 도구를 점검하려면 임시 프로젝트에 다음 내용을 담은 probe.txt를 생성하세요:
FILE_PROBE_739182
선택한 모델로 그 위치에서 Codex를 시작한 다음 입력합니다:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
파일 읽기 도구가 실행되고 답변이 파일 내용과 일치하는지 확인하세요. 기본 대화가 정상 작동한 후에 사용하세요.
FAQ
ChatGPT 구독을 사용하나요?
요청은 APIMaster 키와 잔액을 사용합니다. Codex는 클라이언트이며, DeepSeek는 선택된 모델입니다. 이 설정이 DeepSeek를 OpenAI 모델로 만드는 것은 아닙니다.
Claude Code는 왜 다른 URL을 사용하나요?
Codex는 Responses를 위해 https://apimaster.ai/v1를 사용합니다. Claude Code는 사이트 루트 https://apimaster.ai를 사용하며 /v1/messages를 직접 추가합니다.