증상: 브라우저는 되는데 터미널 Codex만 끊길 때

2026년 현재, AI 코딩 보조는 IDE 안의 확장을 넘어 터미널과 CLI 도구로 빠르게 확장되고 있습니다. 그중에서도 OpenAI 쪽 Codex 계열 CLI는 로컬 워크스페이스와 원격 모델 사이를 짧은 주기로 왕복하므로, 네트워크 지연이나 TLS 핸드셰이크 지연이 누적되면 사용자에게는 곧바로 타임아웃 메시지로 보입니다. 흔한 패턴은 Safari나 Chrome으로 platform.openai.com 문서는 열리는데, 같은 머신의 zsh에서만 Codex가 멈춘다거나, 반대로 api.openai.com 호출만 실패하고 패키지 레지스트리나 국내 미러는 빠른 경우입니다.

이때 「인터넷이 느리다」보다 어떤 호스트가 어떤 정책으로 나갔는지를 분리해 보는 것이 핵심입니다. 브라우저는 OS의 시스템 프록시를 따르기 쉽지만, 터미널에서 돌아가는 Go·Rust 기반 바이너리는 HTTP_PROXY를 읽지 않거나, 읽더라도 NO_PROXY에 의해 예외 처리되는 경우가 많습니다. Clash를 TUN 모드로 올리면 프로세스가 프록시 환경 변수를 몰라도 트래픽을 가로챌 수 있지만, 그 경우에도 DNS 응답·규칙 매칭 순서·직결(DIRECT) 오매칭이 그대로 남습니다. 이 글은 합법적인 개발·원격 업무·학습 목적의 트래픽 정렬을 다루며, 서비스 약관이나 소속 기관의 IT 정책을 우회하라는 뜻이 아닙니다.

왜 터미널은 Cursor·브라우저와 다른가

이 블로그의 Cursor 확장 마켓과 GitHub 분류 글은 VS Code 계열 에디터가 끌어오는 마켓·CDN·Cursor API 축에 초점을 맞춥니다. Claude 웹·Anthropic 글은 브라우저 세션과 claude.ai 계열 호스트를 전제로 합니다. 반면 Codex CLI는 표준 입출력과 작은 JSON 페이로드를 반복 전송하는 경로가 많아, 대용량 다운로드보다 왕복 지연과 연결 재시도에 더 민감합니다.

또한 macOS·Linux에서 Homebrew나 패키지 매니저로 CLI를 설치했다면, 자동 업데이트 체크가 GitHub 릴리스 자산이나 별도 CDN을 동시에 두드립니다. 이때 한 줄짜리 FINAL,PROXY 규칙만으로는 「API는 빠른 노드, 대용량은 다른 노드, 국내 미러는 DIRECT」 같은 미세한 조정이 어렵습니다. macOS 터미널에서 Clash가 안 먹는 환경 변수 이슈와 함께 읽으면, TUN 전환 여부와 환경 변수 보강 중 무엇을 먼저 할지 판단하기 쉬워집니다.

OpenAI API 분류: 전략 그룹을 어떻게 쪼갤까

운영 프로필에 바로 붙여 넣기보다, 먼저 대시보드나 로그에서 Codex 실행 중 실제로 열리는 SNI·호스트 접미사를 적어 두는 편이 안전합니다. 제품 버전에 따라 세부 호스트가 바뀔 수 있기 때문입니다. 그런 다음 아래와 같이 역할을 나눈 proxy-group을 두는 패턴이 재현과 장애 공유에 유리합니다.

  • OPENAI-API: api.openai.com 등 짧은 응답 시간이 중요한 REST·스트리밍 API.
  • OPENAI-WEB: 로그인·결제·대시보드에 가까운 platform.openai.com 류(브라우저와 공유되는 경우가 많음).
  • OPENAI-CDN-TOOLS: 문서 자산, 정적 파일, CLI 자체 업데이트나 바이너리가 달라붙는 CDN·스토리지 호스트.

국내에서 npm·PyPI·Docker 레지스트리 미러를 DIRECT로 두고 싶다면, GEOIP,CN,DIRECT나 넓은 DOMAIN-SUFFIX가 OpenAI 호스트까지 직결로 빨아들이는지를 반드시 rule hit로 확인해야 합니다. 직결이 항상 최저 지연은 아니며, SNI만 맞고 중간 경로에서 버퍼가 커지면 CLI는 곧바로 타임아웃으로 보고합니다.

# Example — verify hosts against your own Codex session logs before deploying
proxy-groups:
  - name: OPENAI-API
    type: select
    proxies:
      - 🇸🇬 Low-latency
      - ♻️ Auto
      - DIRECT
  - name: OPENAI-WEB
    type: select
    proxies:
      - 🇺🇸 Stable-login
      - ♻️ Auto
      - DIRECT
  - name: OPENAI-CDN-TOOLS
    type: select
    proxies:
      - 🇯🇵 High-throughput
      - ♻️ Auto
      - DIRECT

rules:
  - DOMAIN-SUFFIX,api.openai.com,OPENAI-API
  - DOMAIN-SUFFIX,openai.com,OPENAI-WEB
  - DOMAIN-SUFFIX,auth0.com,OPENAI-WEB
  # Put more specific DOMAIN rules above broader DOMAIN-SUFFIX blocks
  # Narrow CDN/tool hosts using your captured logs instead of broad wildcards

위 YAML은 개념 예시입니다. Clash는 위에서 아래로 매칭하므로 api.openai.com처럼 좁은 규칙을 반드시 openai.com 같은 넓은 DOMAIN-SUFFIX보다 위에 두어야 합니다. 그렇지 않으면 API 트래픽이 웹 그룹에 흡수되어 지연이 섞여 보입니다. 실제 운영에서는 로그에 찍힌 서브도메인만 DOMAIN 규칙으로 좁히는 편이 안전합니다. 원격 목록으로 관리하려면 Rule Providers·rule-set 구성을 참고하세요.

규칙 우선순위와 DNS가 Codex CLI 프록시 체감을 흔드는 방식

프로필 상단에 깔린 광고 차단·안티트래킹 규칙이 오탐으로 api.openai.com을 REJECT하는 사례는 드물지 않습니다. 증상은 단순 타임아웃과 비슷해 보이므로, 대시보드에서 해당 연결이 어떤 policy·rule 이름에 매칭됐는지 먼저 확인하는 것이 좋습니다. 그다음 GEOIP,CN,DIRECT나 회사망 전용 직결 블록이 OpenAI보다 위에 있으면 API만 DIRECT로 빠져 느려질 수 있으니, OPENAI-API 블록을 충돌 규칙보다 위로 올리되 범위는 좁게 유지합니다.

DNS가 fake-ip 모드일 때, 셸의 resolver와 Clash가 서로 다른 IP를 돌려주면 TLS 세션이 기묘하게 끊깁니다. OS 설정·VPN·회사 SSL 검사와 겹치면 더욱 그렇습니다. TUN 모드 가이드의 DNS 설명과 연결은 됐는데 콘텐츠만 안 열릴 때 점검 글을 함께 보면, fake-ip 필터·fallback 타이밍을 조정하는 순서가 잡힙니다. 터미널 개발 도구 프록시를 맞출 때는 한 번에 하나씩 변수를 바꿔 재현 여부를 남기는 것이 중요합니다.

TUN과 환경 변수: 어디까지가 Codex CLI 프록시에 필요한가

Clash를 시스템 프록시 포트만 켠 상태에서 Codex를 실행하면, 바이너리가 프록시를 모르면 회선이 아무리 좋아도 직통으로 나가려다 막히거나 반대로 느린 직통 경로를 탈 수 있습니다. TUN을 켜면 해당 프로세스의 TCP 흐름을 코어가 가로채므로, 「환경 변수를 고치지 않고도」일관되게 분류할 여지가 생깁니다. 다만 TUN과 회사 VPN·다른 가상 어댑터가 동시에 있으면 라우팅 테이블 충돌이 나기도 하므로, 변경 전후로 netstat나 OS 라우팅 화면을 스크린샷으로 남겨 두면 이후 롤백이 빠릅니다.

환경 변수 경로를 병행한다면 HTTPS_PROXY와 NO_PROXY에 국내 레지스트리·내부 Git 호스트를 명시해 OpenAI API 분류와 국내 트래픽이 섞이지 않게 하는 것이 일반적입니다. 이때 프록시 URL이 http://127.0.0.1:7890처럼 HTTP 프록시 스킴을 가리키는지, mixed-port와 일치하는지까지 맞춰야 합니다. 셸 프로파일에 설정을 넣었다면 로그인 셸과 비로그인 셸 차이도 잊지 마세요.

TLS·HTTP/3·짧은 타임아웃이 겹칠 때

CLI 스택이 HTTP/3(QUIC)을 선호하는 환경이라면, 중간 장비가 UDP를 제한할 때 TCP로 떨어지기 전까지 응답이 비어 있는 것처럼 느껴질 수 있습니다. 노드가 UDP를 잘 통과하는지, 아니면 명시적으로 TCP만 쓰게 제한하는 편이 나은지는 회선마다 다릅니다. 장시간 스트리밍 응답을 쓰는 Codex 계열에서는 유휴 세션 타임아웃에 걸려 중간에 끊기는 사례도 있어, 동일 노드로 일반 HTTPS 사이트를 열어 비교해 보는 단계가 여전히 유효합니다.

한편, 문서 페이지나 대용량 릴리스 자산은 대역폭이 큰 노드가 유리하고, 짧은 토큰 왕복이 많은 API는 지연이 낮은 노드가 유리합니다. 이 둘을 한 그룹에 몰아넣으면 「가끔은 빠른데 자주 타임아웃된다」는 보고로 남기 쉽습니다. OpenAI API 분류를 역할별로 나누면, 동료에게도 「API 그룹만 일본 노드로 바꿔 봤더니 재현이 사라졌다」처럼 전달하기 쉬워집니다.

검증 체크리스트: Codex CLI 타임아웃을 좁히는 순서

아래 순서는 현장에서 복붙해 쓰기 쉽게 짧게 유지했습니다. 각 단계마다 타임스탬프와 rule 이름을 한 줄씩만 적어도 나중에 회고하기 좋습니다.

  1. Codex를 재현한 직후, 실패한 요청의 호스트·TLS 오류 메시지를 터미널 로그에서 복사한다.
  2. Clash 로그에서 동일 시각 연결이 어느 policy·rule에 매칐됐는지 확인한다.
  3. OPENAI-API·OPENAI-WEB·OPENAI-CDN-TOOLS 각각에서 노드를 바꿔 증상이 따라오는지 본다.
  4. TUN on/off, 시스템 프록시 on/off를 바꿔 재현이 달라지는지 본다.
  5. DNS 모드·nameserver·fallback을 바꿔 API만 달라지는지 본다.
  6. NO_PROXY와 광고 차단 규칙에 OpenAI 관련 호스트가 숨어 있지 않은지 본다.

이 과정을 거치면 「Codex CLI 프록시가 불안정하다」는 막연한 이슈를 API만 DIRECT 오매칭, CDN 그룹만 손실, DNS 이중 해석 같은 가설로 바꿀 수 있습니다. 장기적으로는 rule-set으로 호스트 목록을 갱신하고, 로컬 YAML에는 충돌이 적은 최소 규칙만 남기는 편이 안전합니다.

네트워크 프록시 도구는 합법적인 개인정보 보호·연구·원격 업무에 활용될 수 있지만, 관할 법령·서비스 약관·고용 계약을 위반하는 용도로 사용해서는 안 됩니다.
오픈소스 코어와 GUI는 GitHub 등에서 이슈와 릴리스 노트를 확인할 수 있습니다. 설치 패키지를 받는 주 경로는 본 사이트 다운로드 페이지를 우선 참고하고, 라이선스·기여 방법은 저장소를 별도로 열람하는 편이 혼선이 적습니다.

정리

터미널에서 OpenAI Codex CLI가 자주 타임아웃될 때, 원인은 단일 노드 품질만이 아니라 시스템 프록시 미적용·DNS·규칙 순서·역할이 섞인 proxy-group에 있을 때가 많습니다. API·웹·CDN·도구 업데이트를 나누고 rule hit로 직결 오매칭을 걸러 내면, IDE 확장이나 브라우저 세션과는 다른 터미널 개발 도구 프록시 문제를 훨씬 빠르게 닫을 수 있습니다.

Cursor·GitHub·Claude 웹 글에서 이미 정리한 분류 뼈대를 Codex CLI에 이식할 수 있지만, 실제 호스트 집합은 제품 버전마다 달라진다는 전제를 잃지 마세요. 같은 Mihomo 코어를 쓰더라도 클라이언트 UI의 로그 표현은 조금씩 다를 수 있으나, 어떤 규칙에 맞았는지와 어느 그룹으로 나갔는지만 일관되게 확인할 수 있으면 충분합니다. 일상용 프로필과 AI 실험용 프로필을 나누는 것도 운영 부담을 줄이는 현실적인 타협입니다.

브라우저 한정 시나리오보다 터미널은 변수가 많지만, 그만큼 Clash의 도메인 단위 분류 능력을 활용했을 때 체감이 크게 좋아지는 영역이기도 합니다. 다른 범용 AI 글과 겹치지 않게, CLI와 API 축에만 집중해 두면 이후 OpenAI 쪽 제품이 늘어나도 프로필을 덜 고쳐도 됩니다.

Clash를 무료로 내려받고 터미널 OpenAI 트래픽 분류와 DNS를 안정적으로 맞춰 보기