Codex에서 GLM-5.2, GLM-5.3, GLM-5.3-Flash 사용하기: 설정 및 모델 선택
APIMaster로 Codex에서 GLM을 설정합니다. Windows, macOS, Linux에서 config.toml을 찾고, API 키를 설정하고, 대화형 채팅을 시작하고, 모델을 선택합니다.
APIMaster API 키와 Codex의 config.toml을 설정한 뒤 codex를 실행하여 GLM과 대화하세요. glm-5.2, glm-5.3, glm-5.3-flash를 사용합니다. 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 = "glm-5.3"
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 엔드포인트만으로는 이 워크플로에 충분하지 않습니다. summary 설정은 선택적 추론 요약을 비활성화하는 것이며, 모델의 내부 사고를 비활성화하는 것이 아닙니다.
기존 기본 provider를 유지하려면 이 설정을 ~/.codex/glm.config.toml에 대신 넣으세요(Windows: %USERPROFILE%\.codex\glm.config.toml). 그런 다음 아래 시작 명령에 --profile glm을 추가합니다. 이름이 지정된 프로파일 파일은 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
일반적인 최초 실행 또는 프로젝트 신뢰 프롬프트가 끝나면 활성 모델이 glm-5.3 인지 확인합니다. Codex 대화창 에 다음을 입력합니다:
Reply with exactly OK.
정상적인 응답이 오면 기본 연결이 확인된 것입니다. 이후 코드 설명, 파일 읽기, 변경 작업 등을 요청할 수 있습니다. 일반적인 파일 및 명령 권한 프롬프트를 확인하세요.
5. 다른 모델 선택하기
이러한 사용자 지정 모델 ID의 경우 Codex를 시작할 때 모델을 명시적으로 선택해야 합니다. 터미널에서 한 번에 하나의 명령 을 실행하세요:
codex --model glm-5.2
codex --model glm-5.3
codex --model glm-5.3-flash
각 명령은 대화형 대화를 엽니다. 열려 있는 세션에서 전환하려면 /exit를 입력한 다음 원하는 모델의 명령을 실행하세요. 기존에 저장된 대화를 다른 모델로 이어가려면 새 대화를 시작하는 대신 codex resume SESSION_ID --model MODEL_ID를 사용하세요.
Codex에서 /model은 모델 카탈로그를 열고 /status는 활성 모델을 표시합니다. 이 메뉴에 APIMaster 모델 마켓플레이스의 모든 모델이 자동으로 나열되지는 않습니다. GLM 모델이 목록에 없다면 위와 같이 --model을 사용하세요. Claude Code의 /model MODEL_ID 문법이 Codex에서 동작한다고 가정하지 마세요. 이는 여기서 검증된 사용자 지정 모델 선택 방법이 아닙니다.
선택적인 이름이 지정된 프로파일을 사용하는 경우의 예시:
codex --profile glm --model glm-5.3
이후 시작 시의 기본값을 변경하려면 사용 중인 설정에서 최상위 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-15 UTC, Codex CLI 0.154.0, Linux. 여기에 나열된 모든 모델이 예상된 텍스트를 반환했고 도구를 사용하여 로컬 파일을 읽었습니다. 세 모델 모두 작은 Python 함수를 수정하고 테스트를 실행했으며, 테스트 파일은 독립적으로 검증되고 재실행되었습니다. 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는 클라이언트이며 GLM은 선택된 모델입니다. 이 설정이 GLM을 OpenAI 모델로 만드는 것은 아닙니다.
Claude Code는 왜 다른 URL을 사용하나요?
Codex는 Responses를 위해 https://apimaster.ai/v1를 사용합니다. Claude Code는 사이트 루트 https://apimaster.ai를 사용하며 /v1/messages를 직접 덧붙입니다.