2026년 현재 많은 개발자들이日常 개발 환경으로 VSCode + Codex(GPT-5.x) 조합을 활용하고 있다.
그러나 현실적인 문제점이 존재한다:
공식 API의 불안정성 / 네트워크 복잡성 / 비용 관리 불가
이러한 이유로 점점 더 많은 개발자들이 선택하는 방법이:
sub2api(OpenAI 호환 게이트웨이)를 활용한 Codex 연동
이 글에서 다루고자 하는 핵심 내용:
VSCode에서 Codex CLI가 sub2api를 통해 Codex에 연결되도록 설정하는 방법
一, 동작 원리 파악하기（매우 중요）
VSCode는 Codex에 직접 연결되는 것이 아니다.
실제 연결 흐름은 다음과 같다:
VSCode
↓
Codex CLI（로컬）
↓
OpenAI 호환 API（sub2api）
↓
Codex / GPT-5.4
핵심은 단一句话:
Codex CLI의 base_url을 sub2api로 지정하는 것
二, 사전 준비
필요한 요소:
- sub2api 주소 (예: https://xxx.com/v1)
- API Key
- Node.js 환경
三, 핵심 설정 단계（최종 권장 방안 ⭐）
1️⃣ Codex CLI 설치
npm install -g @openai/codex
2️⃣ Codex 설정（가장 중요한 단계）
설정 파일 생성:
~/.codex/config.toml
다음 내용 입력:
model = "gpt-5.4"
model_provider = "sub2api"
model_reasoning_effort = "high"
[model_providers.sub2api]
name = "sub2api"
base_url = "https://사용자_도메인/v1"
wire_api = "responses"
requires_openai_auth = true
️ 주의사항（자주 발생하는 문제）
base_url에는 반드시 /v1 포함
👉 그렇지 않으면 다양한 오류 발생
3️⃣ API Key 설정
export OPENAI_API_KEY=sk-xxx
4️⃣ VSCode 실행（중요）
code .
반드시 터미널에서 VSCode를 실행해야 함 그렇지 않으면 환경 변수를 인식하지 못함
5️⃣ Codex 확장 프로그램 설치
VSCode 확장 프로그램 검색에서:
Codex (OpenAI)
설치 완료
설정 완료
현재 연결 구조:
VSCode → Codex → sub2api → GPT-5.4
四, 연동 효과
성공적으로 연동되면 다음과 같은 기능 사용 가능:
- VSCode 내 대화창에서 코드 작성
- 프로젝트 파일 자동 수정
- 전체 프로젝트 구조 이해
- Agent 작업 실행（AI 엔지니어에 가까운 수준의 작업）
五, 대안 방안（구성은 자유롭지만 기능이 제한적）
Codex CLI를 사용하고 싶지 않다면:
Continue 확장 프로그램（오픈소스 방안）
확장 프로그램 설치: Continue
설정:
{
"models": [
{
"title": "Codex",
"provider": "openai",
"model": "gpt-5.4",
"apiBase": "https://사용자_도메인/v1",
"apiKey": "sk-xxx"
}
]
}
장점
- sub2api 완전 지원
- CLI 의존성 없음
- 설정이 단순
단점
- 완전한 Agent 미지원（프로젝트 자동 수정 불가）
六, 방안 선택 기준
| 방안 | 추천도 | 설명 |
|---|---|---|
| Codex CLI + VSCode | ⭐⭐⭐⭐⭐ | 가장 강력한 기능（추천） |
| Continue | ⭐⭐⭐⭐ | 단순하고 유연함 |
추가 참고: ccswitch도 방법 중 하나로,图形UI 제공: https://kazjsfecs3y.feishu.cn/wiki/JNXAwxqeOiI3Hxky3BXcYdkrnYb
七, 자주 묻는 질문
1: VSCode 연결이 안 되는 이유는?
90% 확률로 다음 원인:
/v1누락- 터미널에서 VSCode 실행 안 함
- API Key가 적용 안 됨
2: 요청이 실패하는 경우는?
확인 방법:
curl https://사용자_도메인/v1/models
연결 가능한지 확인
3: cc-switch 비추천 이유
이유는:
- 중계 단계 증가 = 불안정성
- CLI에서 이미 base_url 네이티브 지원
- 서버 환경 사용 시 불필요한 오버헤드
八, 심화 활용법
이미 sub2api를 사용 중이라면:
완전한 AI 플랫폼 구성 가능:
VSCode / Cursor / CLI
↓
sub2api
↓
다양한 모델（Codex / Claude / Gemini）
확장 가능한 기능:
- 다중 키 로테이션
- 요청 제한
- 사용자 과금
- 폴백 메커니즘
- SaaS 패널
이 정도면 "연동 가이드"를 넘어서: 👉:
AI 개발 인프라 구축
九, 정리
VSCode와 Codex 연동의 본질은 Codex CLI가 sub2api를 가리키도록 설정하는 것