AI 게임 · 바이브 코딩

CLI로 코딩하고, 스프라이트로 캐릭터를 움직이세요

StudyVerse 계정 하나로 VS Code 터미널에서 AI 코딩 CLI를 쓰고, 캐릭터 이미지를 업로드해 게임용 스프라이트 시트를 생성합니다. 개인 API 계정은 필요 없습니다.

STEP 1

CLI 연결 방법

VS Code 터미널의 AI 코딩 CLI(aider·Claude Code 등)에서 StudyVerse 게이트웨이를 사용합니다. 개인 API 키는 필요 없습니다.

CLI가 뭐예요?

내 컴퓨터 터미널에서 AI 코딩 도구(aider·Claude Code)를 쓸 때, 개인 API 키 없이 StudyVerse 키만 넣으면 학교가 비용을 대는 AI를 한도 내에서 사용합니다. AI는 터미널 안에서 동작합니다(이 웹페이지가 아니라).

💡 aider는 코딩 도구지 채팅봇이 아닙니다. “안녕” 같은 잡담엔 “무슨 코드를 고칠까요?”만 반복해요(정상). 실력을 보려면 코딩 작업을 시키세요: “hello.py 만들어서 안녕 출력해줘”, “이 함수 버그 고쳐줘”.

따라하기 (4단계)

  1. 도구 설치 (최초 1회): 아래 ① 블록 (pip install aider-chat)
  2. 모델 정보 등록 (최초 1회): 아래 ② 블록 — 안 하면 “token limit” 오류남
  3. 키 발급: 오른쪽 ‘키 발급’ 버튼 → sk-... 복사 (한 번만 표시)
  4. 실행 + 코딩: 작업 폴더로 이동(cd) → 아래 ③ 블록 실행 → 켜지면 코딩 작업을 한국어로 지시

🛠️ 자주 쓰는 명령: /add 파일명(편집할 파일 추가) · /clear(대화 비우기) · /tokens(사용량) · /exit(종료)

⚠️ 키는 본인만 사용 · 노출 시 ‘키 재발급’으로 폐기 · 사용량/한도는 오른쪽 확인(매일 리셋) · 모델은 아래에서 선택 · 순정 Gemini CLI 미지원(OpenAI 호환 도구·aider 권장).

🤖 모델 선택

아래에서 모델을 고르면 명령어·메타데이터가 자동으로 바뀝니다. 똑똑할수록 하루 한도($1)가 빨리 소진돼요.

선택됨: Gemini 2.5 Flash — 아래 ②③ 블록이 이 모델로 맞춰집니다.

① aider 설치 (최초 1회)
# Python 필요. 아래가 에러나면 두번째 줄로:
python -m pip install aider-chat
curl -LsSf https://aider.chat/install.sh | sh   # (대안) 격리 설치
② 모델 정보 등록 (최초 1회 · "token limit" 오류 방지) — Gemini 2.5 Flash
printf '%s' '{"openai/gemini-2.5-flash":{"max_input_tokens":1000000,"max_output_tokens":8192,"litellm_provider":"openai","mode":"chat"}}' > ~/.aider.model.metadata.json
③ 환경변수 + 실행 (작업 폴더에서) — Gemini 2.5 Flash
export OPENAI_API_BASE="https://cli.studyverse.co.kr/v1"
export OPENAI_API_KEY="<발급받은 내 키 sk-...>"

# 한국어로 답 + diff 편집모드(출력 절약) — 권장
aider --model openai/gemini-2.5-flash --chat-language korean --edit-format diff
Windows (PowerShell) — export 대신 이렇게
$env:OPENAI_API_BASE="https://cli.studyverse.co.kr/v1"
$env:OPENAI_API_KEY="<발급받은 내 키 sk-...>"
aider --model openai/gemini-2.5-flash --chat-language korean --edit-format diff
연결 확인 (선택) — 한 줄 테스트
curl https://cli.studyverse.co.kr/v1/chat/completions \
  -H "Authorization: Bearer <발급받은 내 키 sk-...>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-2.5-flash","messages":[{"role":"user","content":"안녕"}]}'

내 CLI 키

실제 외부 키는 서버에만 있고, 학생에게는 사용량이 제한된 가상 키만 발급됩니다.

불러오는 중...

사용량 / 제한

키를 발급하면 사용량이 표시됩니다.