Codex CLI

터미널을 위한 OpenAI 오픈소스 코딩 에이전트

TokenMix CLI로 연결하기

공식 TokenMix CLI를 사용하면 환경 변수 설정 없이 한 줄 명령어로 연결할 수 있습니다:

npx tokenmix codex

로그인, API 주소, 키 설정을 모두 자동으로 처리합니다. 직접 설정을 원하신다면 아래 단계를 따라주세요.

소개

Codex CLI는 OpenAI의 오픈소스 터미널 코딩 에이전트입니다. 파일을 읽고, 코드를 작성하고, 샌드박스 셸 명령을 실행하며, 작업이 완료될 때까지 반복합니다. 브라우저 기반 도구와 달리 Codex는 로컬에서 완전히 실행됩니다. TokenMix로 설정하면 gpt-5.5, gpt-5.4 같은 강력한 모델을 TokenMix 요금으로 사용할 수 있습니다.

사전 요구사항

• macOS, Linux, 또는 Windows (WSL 권장)
• Node.js 22 이상 — node -v로 확인
• sk-tm-으로 시작하는 TokenMix API 키 → tokenmix.ai 가입 → 대시보드 → API Keys

설정 단계

1. Codex CLI 설치

npm install -g @openai/codex

확인:

codex --version

2. 설정 파일 생성

Codex는 ~/.codex/config.toml에서 제공자 설정을 읽습니다. 디렉토리와 파일을 생성하세요:

mkdir -p ~/.codex

편집기로 ~/.codex/config.toml을 열고 추가:

model = "gpt-5.5"
model_provider = "tokenmix"

[model_providers.tokenmix]
name = "TokenMix"
base_url = "https://api.tokenmix.ai/v1"
env_key = "TOKENMIX_API_KEY"
wire_api = "responses"

3. API 키 설정

셸 설정 파일(~/.zshrc 또는 ~/.bashrc)에 환경 변수 추가:

export TOKENMIX_API_KEY="sk-tm-your-key-here"

재로드:

source ~/.zshrc

4. Codex 실행

cd ~/your-project
codex

다른 모델 사용:

codex --model gpt-5.4

사용 가능한 TokenMix 모델: gpt-5.5, gpt-5.4

확인

codex -q "현재 디렉토리에 있는 파일들을 알려주세요"

Codex가 디렉토리 내용을 나열해야 합니다. 인증 오류가 발생하면 현재 셸에서 TOKENMIX_API_KEY가 내보내기되어 있는지 확인하세요.

자주 묻는 질문

Q: wire_api = "responses"란 무엇인가요? Codex가 OpenAI Responses API 와이어 형식을 사용하도록 지정합니다. 이는 Codex가 지원하는 유일한 형식이며, TokenMix는 이 형식과 완전히 호환됩니다.

Q: Codex로 Claude 모델을 사용할 수 있나요? Codex는 Responses API 중심으로 설계되어 GPT 모델에 최적화되어 있습니다. Claude 모델은 Claude Code 또는 Cline을 사용하세요.

Q: 모델 이름이 인식되지 않으면 어떻게 하나요? config.toml의 model 필드가 TokenMix 계정에서 사용 가능한 short_id와 일치하는지 확인하세요. tokenmix.ai/models에서 사용 가능한 모델을 확인할 수 있습니다.