Windows에서 DeepSeek를 사용하여 Codex CLI에 초능력을 부여하는 방법 (OpenAI 불필요)

요약 (TL;DR): 저는 Windows에 Codex CLI를 설치하고, 로컬 shim 서버를 통해 DeepSeek에 연결했습니다. 이제 OpenAI가 전혀 필요 없는 완벽하게 작동하는 AI 코딩 에이전트를 갖게 되었습니다. 제가 정확히 어떻게 했는지 소개합니다.

이것이 중요한 이유

저는 중국에 살고 있습니다. 이곳에서는 OpenAI의 API가 차단되어 있습니다. 몇 달 동안 AI 코딩 에이전트를 사용하려고 할 때마다 저는 똑같은 벽에 부딪혔습니다:

Codex CLI가 OpenAI의 WebSocket에 연결 시도 -> 차단됨
Claude Code는 API 키가 필요함 -> 복잡함
Cursor는 유료임 -> 비쌈
GitHub Copilot -> 제한된 모델 선택지

하지만 오늘, 제 상사가 codex-shim에 관한 Toutiao 기사를 공유해 주었습니다. 이것은 Codex의 API 요청을 가로채서 사용자가 원하는 어떤 모델로든 라우팅하는 로컬 Python 서버입니다.

직접 시도해 보았습니다. 작동했습니다. 단계별 과정은 다음과 같습니다.

아키텍처 (Architecture)

세 가지 구성 요소:

Codex CLI - OpenAI의 터미널 코딩 에이전트 (GitHub에서 87K 스타 획득)
codex-shim - API 호출을 변환하는 로컬 Python/aiohttp 서버
DeepSeek Chat - 실제 추론을 수행하는 모델

1단계: Codex CLI 설치

npm i -g @openai/codex

Windows에서 5초면 완료됩니다. 확인: codex --version -> codex-cli 0.135.0

2단계: codex-shim 설치

pip install ./codex-shim-0xSero/

Python 3.11 이상과 aiohttp가 필요합니다. Windows의 PowerShell/cmd에서 작동합니다.

3단계: 모델 설정

DeepSeek API 키와 기본 URL(base URL)을 포함한 ~/.codex-shim/models.json 파일을 생성합니다.

4단계: Shim 시작

codex-shim --port 8765 start
curl http://127.0.0.1:8765/v1/models

5단계: Codex 실행

codex -p shim -s danger-full-access

첫 실행

첫 번째 테스트: 저는 Codex에게 Python으로 피보나치(Fibonacci) 스크립트를 작성해 달라고 요청했습니다. Codex는 디렉토리를 나열하고, 파일을 작성하고, 실행하고, 출력을 확인했습니다. 7,000개 이상의 토큰(tokens)이 모두 DeepSeek를 통해 라우팅되었습니다. OpenAI는 필요하지 않았습니다.

배운 점

특정 벤더에 종속(vendor lock-in)되지 마세요 - 언제나 이를 연결해 줄 심(shim)이 존재합니다.
로컬 우선(Local-first) 방식은 강력합니다 - 심(shim)은 로컬호스트(localhost)에서 실행됩니다.
Windows는 고려 대상에서 제외된 것이 아닙니다 - 모든 것이 정상적으로 작동합니다.
중국의 AI 생태계는 실재합니다 - DeepSeek, Qwen, GLM은 충분한 경쟁력을 갖추고 있습니다.

Resources

Codex CLI: github.com/openai/codex (87K stars)
codex-shim: github.com/0xSero/codex-shim (733 stars)
DeepSeek: platform.deepseek.com

모델이 어디에 위치하든 상관하지 않는 AI 에이전트들을 실행하고 있는 선전(Shenzhen)의 한 컴퓨터에서. 미래는 멀티 모델(multi-model)입니다.

Insights