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을 지원합니다. 괄호 안에 레벨을 지정하면 돼요.

제 설정을 보면:

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가 있어요:

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

# 평소엔 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 전자책을 출간했습니다.

👉 상세페이지 구경가기

현직 개발자입니다. Claude Code가 프리뷰로 나온 날부터 지금까지, 거의 모든 업무에 붙여서 쓰고 있어요.

어느 날 팀원의 엑셀 작업을 Claude Code로 자동화해줬더니 눈이 휘둥그레졌고,

반복 업무에 지친 친구에게 알려줬더니 "인생이 바뀌었다"고 했습니다.

그때 생각했어요.

"이걸 코딩 모르는 사람도 쓸 수 있게 정리하면 어떨까?"

그렇게 10개 넘는 실무 업무를 하나씩 자동화하면서,

비개발자도 따라할 수 있는 방법을 정리하기 시작했습니다.

이런 분들의 문제를 풀고 싶었습니다

매일 반복되는 하루, 혹시 이런가요?

• 오전 — 출근하자마자 폴더별 파일 정리

• 점심 — 엑셀 데이터 복붙 반복하다 점심시간

• 오후 — 회의록 정리하고 보고서 초안 작성

• 저녁 — 아직 본업도 못 건드림. 야근 확정

하루 3시간 × 20일 = 한 달에 60시간.

시급 2만원으로만 계산해도 월 120만원의 시간을 단순 작업에 쓰고 있는 거예요.

그래서 만든 것

"클로드 코드 — 비개발자편"

터미널이 뭔지 모르는 사람도 처음부터 따라할 수 있는 Claude Code 실전 가이드입니다.

Before → After 실제 사례:

• 폴더 200개 파일 수동 정리 2시간 → "월별로 정리해줘" 한 마디에 3분

• 엑셀 10개 데이터 복붙 취합 1시간 → "매출 데이터 합쳐서 요약해줘" 2분

• 경쟁사 뉴스 검색·정리 40분 → "이번 주 경쟁사 동향 정리해줘" 5분

구성

16장, 5파트 체계적 커리큘럼으로 구성했습니다.

• 파트 1. 시작하기 — 터미널 설치부터 첫 명령어 실행까지

• 파트 2. 업무 자동화 — 파일 정리, 데이터 분석, 리서치, 문서 작성

• 파트 3. 효율적으로 작업하기 — 지시법, 설정, 비용 관리, 문제 해결

• 파트 4. 고급 활용 — 노션·슬랙 연동, 스킬과 Hooks

• 파트 5. 실전 워크플로우 — 실전 사례 모음, 팀 협업

+) 파트별 실전 부록 5개, 장마다 실습 체크리스트, 실무 Commands 10+ 제공

다른 자료와 다른 점

체계적 커리큘럼

유튜브/블로그 → 단편적 팁 / ChatGPT → 질문할 줄 알아야 함 / 이 콘텐츠 → ✅ 16장 단계별 구성

실습 체크리스트

유튜브/블로그 → 보기만 함 / ChatGPT → 알아서 해야 함 / 이 콘텐츠 → ✅ 장마다 포함

최신 정보

유튜브/블로그 → 올린 시점에 고정 / ChatGPT → 학습 데이터 한계 / 이 콘텐츠 → ✅ 노션으로 지속 업데이트

질문/지원

유튜브/블로그 → 댓글 달고 기다림 / ChatGPT → 맥락 기억 못함 / 이 콘텐츠 → ✅ 카톡 채널 지원

PDF에 갇힌 콘텐츠가 아닙니다.

노션으로 제공되어 Claude Code가 업데이트되면 콘텐츠도 함께 업데이트됩니다.

가격

정가 59,000원

🎁 얼리버드 특가: 29,500원 (50% 할인 · 선착순 100명 한정)

⏳ 타임딜: 38,940원 (34% 할인 · 2월 28일까지)

하루 30분, 1주일이면 반복 업무가 눈에 띄게 줄어듭니다.

이 콘텐츠의 가격은 절약되는 시간 하루치도 안 돼요.

👉 지금 시작하기

코딩 몰라도, 터미널 처음 열어도 괜찮습니다.

반복 업무에 하루 3시간 쓰는 사람을 위한, 진짜 실전 Claude Code 활용법입니다.