Claude Code를 쓰다가 API 비용이 부담되신 적 있으신가요?
이제 CLIProxyAPI로 GPT 모델을 연동 할 수 있습니다!

저는 핸드폰 번호를 모아서 40개월어치 사놨습니다.

https://gift.kakao.com/product/12953074

들어가며

Claude Code는 정말 강력한 도구지만, Anthropic API 사용료가 만만치 않죠. 특히 Opus 모델을 자주 쓰다 보면… 💸

그런데 CLIProxyAPI를 사용하면 Claude Code에서 GPT-5.3-codex 같은 다른 모델을 이식하여 서브 모델로 사용할 수 있습니다!

GPT 상품을 카카오톡을 통해 구매하셨다면, 아래 글을 순서대로 따라하시면 됩니다.

따라하기 어려우신 분을 위해서 퀵 가이드를 만들었습니다.

---

CLIProxyAPI란?

CLIProxyAPI는 다양한 AI 모델 API를 통합해서 제공하는 로컬 프록시 서버입니다.

주요 특징:

• 여러 AI API를 하나의 인터페이스로 통합
• 무료 OAuth 인증 지원 (Gemini CLI, Codex 등)
• 로컬 서버라 빠른 응답

---

설치 과정 (macOS 기준)

1단계: CLIProxyAPI 설치

Homebrew로 간단하게 설치할 수 있어요.

brew install cliproxyapi

---

2단계: API 키 인증 비활성화

CLIProxyAPI는 기본적으로 API 키 인증이 활성화되어 있는데, OAuth를 사용할 거라면 이걸 비활성화해야 합니다.

자동으로 주석 처리:

sed -i.bak '/^api-keys:/,/^  - "your-api-key-3"/s/^/#/' /opt/homebrew/etc/cliproxyapi.conf

수동으로 수정하려면:

vim /opt/homebrew/etc/cliproxyapi.conf

아래 부분을 찾아서 주석(#) 처리:

# api-keys:
#   - "your-api-key-1"
#   - "your-api-key-2"
#   - "your-api-key-3"

---

3단계: 서버 시작

이제 CLIProxyAPI 서버를 백그라운드 서비스로 시작합니다.

# 서비스 시작
brew services start cliproxyapi

# 상태 확인
brew services list | grep cliproxyapi

정상적으로 시작되면 started 상태로 표시됩니다.

서버 작동 확인:

curl http://127.0.0.1:8317/

정상 응답:

{
  "endpoints": [
    "POST /v1/chat/completions",
    "POST /v1/completions",
    "GET /v1/models"
  ],
  "message": "CLI Proxy API Server"
}

---

Claude Code 연동하기

여기서 중요한 건, 기존 Claude Code 설정과 충돌하지 않게 하는 겁니다!

많은 가이드에서 이렇게 하라고 하죠:

# ~/.zshrc에 추가
export ANTHROPIC_BASE_URL=http://127.0.0.1:8317
export ANTHROPIC_AUTH_TOKEN=sk-dummy
# ...

하지만 이 방식은 모든 claude 명령에 영향을 줍니다! 😱

기존에 Anthropic API를 쓰던 설정이 있다면? 다 깨집니다.

alias로 분리하기

저는 이렇게 했어요:

# ~/.zshrc에 추가

# 기존 Claude Code (Anthropic 공식 API)
alias cc='claude --dangerously-skip-permissions'

# CLIProxyAPI 사용 (GPT 모델)
alias ccgpt='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 ANTHROPIC_AUTH_TOKEN=sk-dummy ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh) ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium) ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low) cc'

✅ 기존 cc 명령은 Anthropic API 사용
✅ ccgpt 명령은 CLIProxyAPI 사용
✅ 필요할 때 각각 선택해서 사용
✅ 설정 충돌 전혀 없음

적용하기

source ~/.zshrc

---

Thinking Level로 성능 최적화

CLIProxyAPI는 Thinking Level을 지원합니다. 괄호 안에 레벨을 지정하면 돼요.

Level	설명	추천 용도
(low)	빠른 응답	간단한 질문, 코드 리뷰
(medium)	일반 작업	일반적인 코딩 작업
(high)	복잡한 작업	복잡한 알고리즘, 리팩토링
(xhigh)	최고 성능	아키텍처 설계, 디버깅

제 설정을 보면:

ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh)    # 최고 성능
ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium) # 일반 작업
ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low)     # 빠른 응답

모델 Opus 선택하면 → codex(xhigh)

모델 Sonnet 선택하면 → codex(medium)

우회를 해서 이식을 한거라, GUI가 조금 어색하긴 합니다.

---

실제 사용해보기

첫 실행: OAuth 인증

이제 새 터미널을 열고 ccgpt를 실행해보세요.

ccgpt

처음 실행하면 OAuth 인증 화면이 뜹니다. 브라우저가 자동으로 열리면서:

1. Gemini CLI, Codex, Claude 등 인증할 서비스 선택
2. 구글 계정 또는 해당 서비스 계정으로 로그인
3. 권한 승인

인증이 완료되면 터미널로 돌아옵니다.

모델 목록 확인

인증 후에는 사용 가능한 모델 목록을 확인할 수 있어요:

curl -s http://127.0.0.1:8317/v1/models | jq -r '.data[].id' | head -10

실제로 사용해보기

ccgpt

이제 평소처럼 Claude Code를 사용하면 됩니다!

차이점은? GPT-5.3-codex 모델을 사용할 수 있다는 것! 🎉

---

명령어 정리

제 최종 설정에는 이렇게 여러 alias가 있어요:

명령어	API	모델	용도
cc	Anthropic	Claude Sonnet 4.5	계획 실행
cco	Anthropic	Claude Opus 4.6	브레인스토밍 및 계획 작성
ccc	Anthropic	(continue 모드)	이전 대화 이어가기
ccz	z.ai	GLM-5	벌크 작업 및 잡무
ccgpt	CLIProxyAPI	GPT-5.3-codex	벌크 작업 및 잡무

이렇게 하면 상황에 맞게 골라 쓸 수 있어요!

# 평소엔 Claude 공식 API
cc

# GPT 써보고 싶을 때
ccgpt

# 최고 성능이 필요할 때
cco

---

트러블슈팅

Q: 서버가 안 켜져요

# 재시작
brew services restart cliproxyapi

# 로그 확인
brew services log cliproxyapi

# 프로세스 확인
ps aux | grep cliproxyapi

Q: API Error: 502

위 이미지 처럼 된다면:

/opt/homebrew/opt/cliproxyapi/bin/cliproxyapi -codex-login

를 실행 후 OAuth 인증을 진행하세요. 브라우저가 뜨고 인증 진행:

완료 후 터미널에서 Enter:

Q: 모델 목록이 비어있어요

OAuth 인증을 먼저 해야 합니다! ccgpt를 실행하면 자동으로 인증 화면이 뜹니다.

Q: 기존 Claude Code 설정이 안 먹혀요

전역 환경변수 방식을 쓰셨다면, .zshrc에서 아래 부분을 제거하세요:

# 이 부분 삭제
export ANTHROPIC_BASE_URL=http://127.0.0.1:8317
export ANTHROPIC_AUTH_TOKEN=sk-dummy
# ...

그리고 alias 방식으로 변경하시면 됩니다!

---

⚡️ 퀵 가이드 (클로드 코드 실행 후 복사 붙여넣기 해주세요)

# CLIProxyAPI Quick Setup Guide

한 번에 설치하고 Claude Code와 연동하는 방법입니다.

---

## 1단계: 설치

### macOS

brew install cliproxyapi


### Linux

curl -fsSL https://raw.githubusercontent.com/router-for-me/CLIProxyAPI/main/scripts/install.sh | bash


---

## 2단계: 설정 (인증 제거)

### macOS

# 설정 파일 열기
vim /opt/homebrew/etc/cliproxyapi.conf

# 아래 줄 찾아서 주석 처리:
# api-keys:
#   - "your-api-key-1"
#   - "your-api-key-2"
#   - "your-api-key-3"


또는 자동으로 주석 처리:

sed -i.bak '/^api-keys:/,/^  - "your-api-key-3"/s/^/#/' /opt/homebrew/etc/cliproxyapi.conf


---

## 3단계: 서버 시작


# 서비스로 시작 (권장)
brew services start cliproxyapi

# 서비스 상태 확인
brew services list | grep cliproxyapi

# 서버 작동 확인
curl http://127.0.0.1:8317/


**정상 응답:**
json
{
  "endpoints": ["POST /v1/chat/completions", ...],
  "message": "CLI Proxy API Server"
}


---

## 4단계: Claude Code 연동

### 방법 1: 한 줄로 실행 (임시)


ANTHROPIC_BASE_URL=http://127.0.0.1:8317 \
ANTHROPIC_AUTH_TOKEN=sk-dummy \
ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex \
ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex \
ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex \
claude


### 방법 2: 영구 설정 (전역 환경변수)

`~/.zshrc` 맨 아래에 추가:


# CLIProxyAPI
export ANTHROPIC_BASE_URL=http://127.0.0.1:8317
export ANTHROPIC_AUTH_TOKEN=sk-dummy
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex


적용:

source ~/.zshrc
claude


> ⚠️ **주의**: 이 방법은 모든 `claude` 명령에 영향을 줍니다. 기존 Claude Code 설정과 충돌할 수 있어요!

### 방법 3: alias로 분리 (권장) ⭐️

기존 `claude` 또는 `cc` 명령은 그대로 두고, CLIProxyAPI만 별도 명령으로 사용:

`~/.zshrc`의 alias 섹션에 추가:


# Claude Code aliases
alias cc='claude --dangerously-skip-permissions'
alias ccgpt='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 ANTHROPIC_AUTH_TOKEN=sk-dummy ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh) ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium) ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low) cc'


적용:

source ~/.zshrc


**사용 예시:**

# 기존 Claude Code (Anthropic 공식 API)
cc

# CLIProxyAPI로 GPT 모델 사용
ccgpt


---

## 5단계 (선택): Thinking Level 추가

더 나은 성능을 위해 괄호로 레벨 지정:


export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh)
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low)


**지원 레벨:**
- `(low)` - 빠른 응답
- `(medium)` - 일반 작업
- `(high)` - 복잡한 작업
- `(xhigh)` - 최고 성능

---

## 완료! 🎉

이제 Claude Code가 CLIProxyAPI를 통해 실행됩니다.

**테스트:**

# 서버 확인
curl http://127.0.0.1:8317/

# OAuth 인증 후 모델 목록 확인
ccgpt  # 첫 실행 시 OAuth 인증 필요


---

## 트러블슈팅

### 서버가 안 켜져요

# 재시작
brew services restart cliproxyapi

# 로그 확인
brew services log cliproxyapi

# 프로세스 확인
ps aux | grep cliproxyapi


### Claude Code 연결 안 됨

# 환경변수 확인
echo $ANTHROPIC_BASE_URL

# 서버 확인
curl http://127.0.0.1:8317/

# alias 확인
type ccgpt


### 모델 목록이 비어있어요

# OAuth 인증 필요 - ccgpt 실행 시 자동으로 인증 창이 뜹니다
ccgpt

# 인증 후 모델 목록 확인
curl -s http://127.0.0.1:8317/v1/models | jq -r '.data[].id' | head -5


---

## Quick Commands (복사해서 실행)

### 방법 A: 전역 환경변수 방식


# 1. 설치
brew install cliproxyapi

# 2. API 키 비활성화
sed -i.bak '/^api-keys:/,/^  - "your-api-key-3"/s/^/#/' /opt/homebrew/etc/cliproxyapi.conf

# 3. 서비스 시작
brew services start cliproxyapi

# 4. 환경변수 설정 (~/.zshrc에 추가)
cat >> ~/.zshrc <<'EOF'
# CLIProxyAPI
export ANTHROPIC_BASE_URL=http://127.0.0.1:8317
export ANTHROPIC_AUTH_TOKEN=sk-dummy
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh)
export ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low)
EOF

# 5. 적용
source ~/.zshrc
claude


### 방법 B: alias 분리 방식 (권장) ⭐️


# 1. 설치
brew install cliproxyapi

# 2. API 키 비활성화
sed -i.bak '/^api-keys:/,/^  - "your-api-key-3"/s/^/#/' /opt/homebrew/etc/cliproxyapi.conf

# 3. 서비스 시작
brew services start cliproxyapi

# 4. alias 추가 (~/.zshrc의 alias 섹션에 추가)
cat >> ~/.zshrc <<'EOF'
# Claude Code aliases
alias cc='claude --dangerously-skip-permissions'
alias ccgpt='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 ANTHROPIC_AUTH_TOKEN=sk-dummy ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh) ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium) ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low) cc'
EOF

# 5. 적용 및 실행
source ~/.zshrc
ccgpt  # CLIProxyAPI 사용
cc     # 기존 Anthropic API 사용


---

## 💡 Tips

### 여러 alias 활용하기

다양한 용도로 여러 alias를 만들 수 있어요:


# ~/.zshrc에 추가
alias cc='claude --dangerously-skip-permissions'
alias cco='claude --dangerously-skip-permissions --model claude-opus-4-6'
alias ccc='claude --dangerously-skip-permissions --continue'
alias ccgpt='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 ANTHROPIC_AUTH_TOKEN=sk-dummy ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex(xhigh) ANTHROPIC_DEFAULT_SONNET_MODEL=gpt-5.3-codex(medium) ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.3-codex(low) cc'


| 명령어 | 설명 |
|--------|------|
| `cc` | 기본 Claude Code (Anthropic API) |
| `cco` | Opus 모델 사용 |
| `ccc` | continue 모드 |
| `ccgpt` | CLIProxyAPI (GPT 모델) |

---

**공식 문서:** https://help.router-for.me/

⚡️⚡️⚡️⚡️⚡️⚡️⚡️⚡️⚡️

비개발자를 위해 Claude Code 전자책을 출간했습니다.

👉 상세페이지 구경가기