개인 구독 연동

개인 구독 ≠ 개발자 API

개인 구독의 이미지·TTS는 별도 판정

최신 CLIProxyAPI에는 Codex·xAI image model을 위한 /v1/images/generations route가 있지만, AI Influence가 요구하는 Player2 /v1/image/generate 요청·응답과 다릅니다. GameMaster도 현재 image/TTS 변환 route가 없습니다. 기술적으로 adapter를 새로 만들 수 있어도 OAuth token replay와 제3자 backend 사용은 공식 media API 통합이 아니므로 권장하지 않습니다.[13]

모든 경로의 공통 안전 절차

1. 별도 폴더와 가능하면 별도 표준 Windows 사용자에서 실행합니다. 개인 문서·SSH key·개발용 MCP가 없는 환경이 좋습니다.
2. Node.js·Go·Python·CLI는 공식 사이트에서 설치합니다. 카페 첨부 EXE와 Drive binary를 사용하지 않습니다.
3. bridge는 GitHub source를 git clone하여 실행합니다. Release EXE도 이 가이드에서는 제외합니다.
4. server bind를 127.0.0.1로 제한합니다. 0.0.0.0, router port forwarding, Cloudflare Tunnel, Tailscale 공유를 사용하지 않습니다.
5. Windows Defender Firewall의 외부 inbound 허용 팝업에서 Public/Private network 허용을 체크하지 않습니다.
6. 공식 브라우저 domain에서만 로그인합니다. 비밀번호·2FA code를 bridge console에 입력하지 않습니다.
7. AI Influence connection test → NPC 한 명 대화 → log 확인 순으로 검증합니다.
8. rate limit·경고가 나오면 중단합니다. 다중 계정 회전·제한 우회는 하지 않습니다.

Claude Pro/Max

Anthropic은 Claude Code를 Pro/Max 계정으로 쓰는 것을 공식 지원하지만, Pro/Max에 일반 API가 포함되는 것은 아닙니다.[7][6] 커뮤니티의 MIT 공개소스 bridge는 AI Influence의 Ollama 요청을 claude -p로 변환하며 tools·MCP·session persistence를 끕니다.[5]

A. 공식 CLI 로그인

npm install -g @anthropic-ai/claude-code
claude

열린 브라우저의 Anthropic 공식 로그인 화면에서 Pro/Max 계정으로 인증합니다. CLI 안에서 짧은 질문을 보내 정상 응답을 먼저 확인합니다.

B. bridge를 source로 설치

git clone https://github.com/kubilaiswf/claude-bannerlord-proxy.git
cd claude-bannerlord-proxy
git log -1 --oneline
npm ci
npm audit --omit=dev
npm start

console에 Listening on http://127.0.0.1:11434가 표시되어야 합니다. 다른 주소라면 중단하고 HOST=127.0.0.1로 고칩니다.

C. server만 단독 확인

Invoke-RestMethod http://127.0.0.1:11434/api/tags

PowerShell에 JSON이 돌아오면 AI Influence에서 다음을 설정합니다.

AI Provider: Ollama
Ollama API URL: http://127.0.0.1:11434
Ollama Model: claude-haiku:latest  # 속도 우선
# 또는 claude-sonnet:latest       # 품질 우선

Gemini 개인 계정·plan

Google의 공식 Gemini CLI는 브라우저 OAuth를 지원합니다.[27] 커뮤니티 bridge도 존재하지만, 현재 source는 Gemini CLI를 --yolo로 실행해 모든 tool 호출을 자동 승인합니다.[15] 그 상태로는 사용하지 않습니다.

A. CLI 설치와 인증

npm install -g @google/gemini-cli
gemini

Google 공식 화면에서 로그인하고 CLI 단독 응답을 확인합니다. 개인 Gemini plan과 개발자 API billing은 동일한 상품으로 가정하지 않습니다.

B. source 설치

git clone https://github.com/kubilaiswf/gemini-bannerlord-proxy.git
cd gemini-bannerlord-proxy
git log -1 --oneline
npm ci
npm audit --omit=dev

C. 반드시 --yolo 제거

server.js의 cliArgs 배열에서 다음 한 줄을 삭제합니다.

-      "--yolo",

D. 모든 Gemini tool을 deny

%USERPROFILE%\.gemini\policies\bannerlord-deny-tools.toml을 만들고 다음을 저장합니다. Gemini CLI 공식 policy engine의 * wildcard는 모든 built-in·MCP tool을 가리킵니다.

[[rule]]
toolName = "*"
decision = "deny"
priority = 1000
denyMessage = "AI Influence dialogue mode: tools are disabled."

개인용 %USERPROFILE%\.gemini\GEMINI.md와 MCP 설정이 NPC prompt에 섞일 수 있으므로, 전용 Windows 사용자에서 비워 둡니다. 그 다음 npm start를 실행합니다.

E. AI Influence 설정

AI Provider: Ollama
Ollama API URL: http://127.0.0.1:11434
Ollama Model: gemini-flash:latest

ChatGPT Plus/Pro → Codex

OpenAI는 Codex에서 “Sign in with ChatGPT”와 API key 인증을 공식 지원하며, ChatGPT plan에 Codex 사용량이 포함될 수 있습니다.[29][9] Codex의 $imagegen도 공식 구독 기능이지만, AI Influence 전용 media bridge는 아닙니다.[52]

A. source로 CLIProxyAPI build

공식 Go toolchain과 Git을 설치한 뒤 별도 폴더에서 실행합니다. 현재 source의 go.mod 요구 버전은 Go 1.26.0입니다.

git clone https://github.com/router-for-me/CLIProxyAPI.git
cd CLIProxyAPI
git log -1 --oneline
copy config.example.yaml config.yaml
go build -o cli-proxy-api.exe ./cmd/server

B. localhost 전용 config

config.yaml의 최소 보안 항목을 다음처럼 바꿉니다. LOCAL_RANDOM_KEY는 provider token이 아니라 GameMaster가 local proxy에 인증할 임의의 긴 값입니다.

host: "127.0.0.1"
port: 8317
auth-dir: "./auths"
api-keys:
  - "LOCAL_RANDOM_KEY"
debug: false
remote-management:
  allow-remote: false
  secret-key: ""
  disable-control-panel: true

C. Codex OAuth

.\cli-proxy-api.exe -config config.yaml -codex-login

OpenAI 공식 domain의 브라우저 화면에서 로그인합니다. 완료 후 일반 server mode로 실행합니다.

.\cli-proxy-api.exe -config config.yaml

D. GameMaster를 EXE 없이 source로 실행

git clone https://github.com/segarega/GameMaster.git
cd GameMaster
start.bat

start.bat는 Python virtual environment와 dependency를 source에서 설치합니다.[14] General의 main provider를 다음처럼 설정하고 Fetch Models로 실제 노출 model을 확인합니다.

API URL: http://127.0.0.1:8317/v1
API Key: LOCAL_RANDOM_KEY
Model: Fetch Models 결과에서 Codex model 선택

Selector 기능은 처음에는 끄거나 같은 local endpoint의 작은 model을 선택합니다. GameMaster server를 127.0.0.1:5100에서 시작한 뒤 AI Influence를 다음처럼 설정합니다.

AI Backend: Player2
URL: http://127.0.0.1:5100
API Key: 비워 둠

SuperGrok/X plan → Grok Build

xAI의 Grok Build는 공식적으로 interactive TUI와 headless script·bot·ACP 사용을 지원합니다.[11][12] Grok plan의 image/video 기능과 xAI Developer API billing은 별도입니다.[64][68] 최신 CLIProxyAPI source가 Grok image route를 구현하지만 공식 Player2 adapter는 아니며 실제 개인 plan entitlement는 계정별 확인이 필요합니다.

구성은 위 Codex 절차와 같고 OAuth flag만 바뀝니다.

.\cli-proxy-api.exe -config config.yaml -xai-login
.\cli-proxy-api.exe -config config.yaml

GameMaster의 API URL은 동일한 http://127.0.0.1:8317/v1이고, Fetch Models에서 실제 Grok model이 반환될 때만 선택합니다. CLIProxyAPI source가 제공하는 현재 flag 이름은 -xai-login입니다.[13]

카페의 Python bridge: Vertex AI 경로

카페 게시물 298399에 공유된 bridge.py는 AI Influence의 Ollama 형식을 Google Vertex AI generateContent 요청으로 변환합니다.[30] 인증은 google.auth.default()로 Application Default Credentials를 얻고, aiplatform.googleapis.com을 호출합니다. 따라서 Gemini 앱 개인 구독이 아니라 Google Cloud project의 Vertex AI quota·billing을 사용합니다.[31][32]

더 안전하게 참고하는 원칙

1. 원본의 작성자 project ID fallback을 삭제하고, 인증 실패 시 server를 즉시 종료합니다.
2. local 개발에서는 JSON key file을 내려받지 말고 Google Cloud CLI의 ADC login을 사용합니다.[33]
3. GOOGLE_CLOUD_PROJECT를 명시하고 billing budget·alert·quota를 먼저 설정합니다.
4. 허용 model을 고정 allowlist로 검증해 request가 임의 model endpoint를 호출하지 못하게 합니다.
5. request body 크기와 동시 요청 수를 제한하고, prompt·응답·Authorization header를 log에 남기지 않습니다.
6. FastAPI·uvicorn·httpx·google-auth dependency version을 고정한 virtual environment에서 실행합니다.

gcloud auth application-default login
gcloud config set project YOUR_PROJECT_ID
set GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID

더 안전한 공식 API 대안

사용 중단·session 철회

1. 게임과 bridge·GameMaster·CLIProxyAPI를 모두 종료합니다.
2. Windows에서 11434·5100·8317 port listener가 사라졌는지 확인합니다.
3. 서비스 계정의 공식 Connected Apps/Sessions 화면에서 해당 CLI session을 철회합니다.
4. Claude ~/.claude, Gemini ~/.gemini, CLIProxyAPI auth-dir는 token 저장 위치입니다. backup·Git·Cloud sync 대상에서 제외합니다.
5. 의심스러운 로그인·rate-limit 경고가 있었다면 비밀번호 변경, 다른 session 로그아웃, 2FA 확인을 수행합니다.

Get-NetTCPConnection -State Listen |
  Where-Object LocalPort -in 11434,5100,8317

출력이 비어 있어야 bridge가 종료된 것입니다.