월 100원 미만으로 토큰 자유를 얻는 방법 (단계별 가이드)

긴 글 주의, 먼저 저장해 두시길 권장합니다.

솔루션 개요: sub2api + 다중 계정 풀 아키텍처#

• 통합 인터페이스: 여러 Claude/Codex Plus 계정을 단일 API 엔드포인트로 통합합니다.
• 지능형 스케줄링: 실시간 할당량을 기반으로 사용 가능한 계정을 자동 선택하여 속도 제한을 방지합니다.
• 로드 밸런싱: 계정 그룹화 및 가중치 구성을 지원하여 요청을 합리적으로 분배합니다.
• 카풀 공유: 여러 API Key를 생성하여 친구들과 사용량을 공유할 수 있습니다.
• 사용량 모니터링: 웹 패널을 통해 각 계정의 사용량 및 요청 통계를 실시간으로 확인할 수 있습니다.

사용자 애플리케이션/도구
    ↓ (API Key 사용)
sub2api 게이트웨이 (Docker 배포)
    ↓ (지능형 스케줄링)
계정 풀: Plus 계정 1, Plus 계정 2, Plus 계정 3...
    ↓
Claude/Codex 공식 API

비용 및 사전 요구 사항#

1. 해외 VPS
   • 권장: 중국에서 지연 시간이 낮고 안정적인 액세스를 위해 싱가포르 노드.
   • 알리바바 클라우드/텐센트 클라우드의 경량 서버로 월 약 30위안이면 충분합니다.
2. 여러 Codex Plus 계정
   • 수량은 사용 강도에 따라 다릅니다. 테스트용으로 2개부터 시작하여 필요에 따라 추가하는 것이 좋습니다.
   • ⚠️ 중요 참고 사항: 계정 자체를 구매하는 것이 아니라, "Business 팀에 초대"되는 서비스 비용을 지불하는 것입니다. OpenAI에 이미 등록된 이메일 주소를 제공해야 합니다. 판매자가 귀하의 계정을 자신의 Business 팀에 초대하여 Codex 5.3에 액세스할 수 있도록 합니다.
   • Xianyu(셴위)에서의 가격은 일반적으로 계정당 약 10위안입니다(월별 청구).
3. 도메인 이름 (권장)
   • ⚠️ 중요: IP를 통한 직접 액세스는 프론트엔드 JS 파일 로드에 실패할 수 있습니다. 도메인 이름을 바인딩하는 것을 강력히 권장합니다.
   • 알리바바 클라우드나 텐센트 클라우드와 같은 플랫폼에서 도메인 이름을 구매할 수 있습니다. 저렴한 것으로 충분합니다.

배포 단계#

사전 준비#

1. Docker 및 Docker Compose 설치
   서버에 Docker와 Docker Compose V2가 설치되어 있는지 확인하세요.
2. 1Panel 설치 (권장)
   1Panel은 오픈 소스 Linux 서버 운영 및 유지 관리 패널입니다. Docker 컨테이너 관리, 리버스 프록시 구성, 도메인 이름 바인딩 등을 용이하게 합니다. 특히 도메인 이름 액세스가 필요한 시나리오에서 적극 권장됩니다.
   설치 명령어:

   bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

   설치 단계:
   1. 언어 선택 (중국어/영어).
   2. 기본 구성을 사용하려면 계속 Enter 키를 누릅니다.
   3. 중요: 설치 후 표시되는 다음 정보를 기억하세요:
      • 보안 진입점
      • 패널 사용자 이름
      • 패널 비밀번호
      • 외부 액세스 주소 (예: http://YOUR_SERVER_IP:24045/security_entry)
   
   1. 브라우저에서 외부 주소에 접속하고 사용자 이름과 비밀번호로 로그인합니다.
   
   패널에 접속할 수 없는 경우:
   서버 방화벽에서 포트가 열려 있지 않을 가능성이 높습니다. 1Panel은 기본적으로 포트 24045를 사용합니다. 클라우드 서버의 보안 그룹에 인바운드 규칙을 추가하여 이 포트를 열어야 합니다.
   
   1Panel의 역할:
   • Docker 컨테이너를 시각적으로 관리합니다.
   • Nginx 리버스 프록시를 구성하고 도메인 이름을 바인딩합니다.
   • SSL 인증서(Let's Encrypt)를 자동으로 신청하고 갱신합니다.
   • 서버 리소스 사용량을 모니터링합니다.
   설치 후 sub2api 배포를 진행할 수 있습니다.

sub2api 배포#

• docker-compose.local.yml: 데이터가 로컬 디렉토리에 저장되어 백업 및 마이그레이션이 더 쉽습니다 (권장).
• docker-compose.yml: 데이터가 Docker 명명된 볼륨에 저장되어 간단한 시나리오에 적합합니다.

Docker Compose 배포 단계#

mkdir -p ~/sub2api && cd ~/sub2api

wget https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-compose.local.yml

curl -o docker-compose.local.yml https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-compose.local.yml

cat > .env << 'EOF'

# 데이터베이스 구성
POSTGRES_USER=sub2api
POSTGRES_PASSWORD=your_secure_db_password_here
POSTGRES_DB=sub2api

# Redis 구성
REDIS_PASSWORD=your_secure_redis_password_here

# 애플리케이션 구성
JWT_SECRET=your_jwt_secret_here_min_32_chars
ADMIN_PASSWORD=your_admin_password_here

# 서비스 포트 (선택 사항, 기본값 8080)
APP_PORT=8080
EOF

# JWT_SECRET 생성 (최소 32자)
openssl rand -base64 32

# ADMIN_PASSWORD 생성
openssl rand -base64 16

sed -i "s|your_jwt_secret_here_min_32_chars|$(openssl rand -hex 32)|" .env
sed -i "s|your_admin_password_here|$(openssl rand -hex 16)|" .env
sed -i "s|your_secure_db_password_here|$(openssl rand -hex 16)|" .env
sed -i "s|your_secure_redis_password_here|$(openssl rand -hex 16)|" .env

docker compose -f docker-compose.local.yml up -d

docker compose -f docker-compose.local.yml ps

• sub2api (메인 서비스)
• postgres (데이터베이스)
• redis (캐시)

cat .env | grep ADMIN_PASSWORD

cat .env

도메인 액세스 구성 (권장)#

1. 1Panel에서 "웹사이트""웹사이트 생성" → "리버스 프록시"를 선택합니다.
2. 구성을 입력합니다.
   • 메인 도메인: 도메인 입력 (예: sub2api.yourdomain.com)
   • 프록시 주소: 127.0.0.1:8080
   • 다른 옵션은 기본값으로 유지
3. 확인을 클릭하여 생성합니다.

• 레코드 유형: A
• 호스트 레코드: sub2api (또는 원하는 서브도메인)
• 레코드 값: 서버의 공인 IP
• TTL: 기본값 (보통 600초)

첫 로그인#

• 이메일: admin@sub2api.local
• 비밀번호: .env 파일에 설정된 ADMIN_PASSWORD

cat ~/sub2api/.env | grep ADMIN_PASSWORD

계정 풀 구성#

1. 계정 그룹 생성#

• 그룹 이름: 그룹의 이름 (예: "Codex 계정 풀")
• 플랫폼: 플랫폼 유형 선택
  • Codex Plus 계정의 경우 OpenAI 선택
  • 공식 Claude 계정의 경우 Claude 선택
  • Antigravity 서비스의 경우 Antigravity 선택
• 설명: 그룹 설명 (선택 사항)

2. Codex Plus 계정 추가#

• 계정 유형: 계정 유형에 따라 선택
  • Codex Plus 계정: OpenAI 선택
  • 공식 Claude 계정: Claude 선택
  • Antigravity 서비스: Antigravity 선택
• 세션 키: 계정의 Session Token 입력
• 계정 이름: 계정을 식별할 수 있는 이름 지정 (예: "Codex Plus 계정 1")
• 그룹: 방금 생성한 그룹 선택 (예: "Codex 계정 풀")
• 가중치: 숫자가 높을수록 스케줄링 확률이 높아짐 (기본값 1로 충분)

1. 인증 링크를 복사하여 새 탭에서 엽니다.
2. 플랫폼에 로그인하면 인증 페이지로 리디렉션됩니다.
3. 인증을 클릭하면 localhost 주소로 리디렉션됩니다.
4. 전체 localhost 링크를 복사하여 붙여넣습니다.

3. API 키 생성#

• 키 이름: API 키의 이름 (예: "내 개발 환경")
• 속도 제한: 속도 제한 (선택 사항)
• 할당량: 할당량 제한 (선택 사항)
• 계정 그룹: 이전에 생성한 그룹 선택

4. 계정 충전 (사용 코드 사용)#

1. 관리 패널에서 "사용 코드"를 클릭합니다.
2. 사용 코드 정보를 입력합니다.
   • 금액: 충전 금액 (내부 청구를 위한 가상 할당량)
   • 만료일: 사용 코드 유효 기간 (선택 사항)
   • 최대 사용 횟수: 최대 사용 횟수 (기본값 1)
3. 생성을 클릭하면 시스템이 사용 코드를 생성합니다.

1. 관리 패널에서 오른쪽 상단의 사용자 메뉴"사용"을 클릭합니다.
2. 생성된 사용 코드를 입력합니다.
3. "사용"을 클릭하여 충전을 확인합니다.
4. 충전이 완료되면 계정 잔액이 증가하고 API 키를 정상적으로 사용할 수 있습니다.

• 사용 코드 시스템은 주로 카풀 시나리오를 위한 것입니다. 관리자가 코드를 생성하여 다른 사용자에게 배포할 수 있습니다.
• 개인 사용의 경우 큰 금액의 코드를 생성하여 한 번에 계정을 충전하세요.
• 충전 금액은 가상이며 실제 통화 거래를 포함하지 않습니다. 내부 할당량 관리에 사용됩니다.

코딩 에이전트에서 API 사용#

방법 1: cc-switch를 사용한 빠른 구성 (권장)#

• API 키는 계정 그룹에 바인딩됩니다. 다른 플랫폼은 해당 API 키를 생성해야 합니다.
• 예: Codex, Claude, Gemini는 세 개의 별도 API 키가 필요합니다 (각각 해당 계정 그룹과 연결).
• 통합 관리를 위해 API 키 생성 시 이름을 사용자 정의하고 동일한 키 값을 사용할 수 있습니다 (단, 키가 모든 플랫폼의 계정 그룹과 연결되어 있는지 확인).

1. Claude 구성

1. Codex 구성

방법 2: 수동 구성 파일 수정#

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://sub2api.yourdomain.com/v1",
        "apiKey": "your_claude_api_key"
      }
    },
    "google": {
      "options": {
        "baseURL": "https://sub2api.yourdomain.com/v1beta",
        "apiKey": "your_gemini_api_key"
      }
    },
    "openai": {
      "name": "OpenAI",
      "options": {
        "baseURL": "https://sub2api.yourdomain.com/v1",
        "apiKey": "your_codex_api_key"
      }
    }
  }
}

• sub2api.yourdomain.com을 실제 도메인으로 바꾸세요.
• your_api_key를 sub2api 관리 패널에서 생성한 API 키로 바꾸세요.
• 다른 플랫폼에 해당하는 API 엔드포인트를 사용하세요 (Claude와 OpenAI는 /v1, Google은 /v1beta 사용).

사용 효과 및 고려사항#

1. 자동 전환: 계정이 속도 제한에 도달하면 시스템이 자동으로 다른 사용 가능한 계정으로 전환하여 작업 흐름이 중단되지 않습니다.
2. 사용량 모니터링: 관리 패널에서 각 계정의 실시간 사용량과 남은 할당량을 확인할 수 있습니다.
3. 비용 최적화: 여러 사용자가 공유할 경우 1인당 비용이 크게 절감됩니다.

• 개인 대량 사용자: 일반적으로 Plus 계정 3-5개면 충분합니다.
• 2-3명 카풀: 1인당 2개 계정, 총 4-6개 계정 풀 구성.
• 소규모 팀(5명): 10-15개 계정, 1인당 평균 2-3개.

자주 묻는 문제#

1. IP를 통한 프론트엔드 JS 파일 로드 실패#

1. 도메인을 준비하고 A 레코드를 서버 IP로 설정합니다.
2. 1Panel에서 리버스 프록시를 구성합니다:
   • 1Panel에서 "웹사이트""웹사이트 생성" → "리버스 프록시"로 이동
   • 도메인: 도메인 입력 (예: sub2api.yourdomain.com)
   • 프록시 주소: http://127.0.0.1:8080
   • HTTPS 활성화 (선택 사항)
3. 도메인으로 접속: https://sub2api.yourdomain.com

environment:
  - BASE_URL=http://YOUR_SERVER_IP:8080

docker compose -f docker-compose.local.yml down
docker compose -f docker-compose.local.yml up -d

요약#

• 개인 대량 사용: 단일 계정 속도 제한에서 해방됩니다. 다중 계정 자동 전환으로 AI 코딩 작업 흐름이 중단되지 않습니다.
• 친구와 카풀: 여러 명이 비용을 분담합니다. 각자 매우 적은 비용으로 충분히 사용할 수 있습니다. 코드 교환 시스템으로 유연하게 할당량을 관리할 수 있습니다.
• 팀 협업: 소규모 개발 팀의 경우 이 솔루션이 구독 계정의 가치를 극대화합니다. 각자 개별적으로 Plus 계정을 구매하는 것보다 중앙 관리형 계정 풀이 더 저렴할 뿐만 아니라 실제 사용량에 따라 동적으로 리소스를 할당할 수 있어, 계정이 유휴 상태가 되거나 다른 사람이 속도 제한에 자주 걸리는 문제를 방지합니다. 팀 관리자는 사용량을 모니터링하고 할당량 한도를 설정하여 공정한 리소스 분배를 보장할 수 있습니다.

• sub2api GitHub: https://github.com/Wei-Shaw/sub2api
• 온라인 데모: https://demo.sub2api.org/
• 1Panel 웹사이트: https://1panel.cn/

스레드#

최근 새 글입니다. 도움이 되셨다면 좋아요를 눌러주세요 — 저에게 정말 큰 힘이 됩니다, 감사합니다! 🫡#

작성자: mkdev | 저는 칭부량을 좋아합니다 (@mkdir700) URL: https://x.com/mkdir700/status/2030299845739811086

https://t.co/KODdmd8r7M