PrivateGPT + Claude Code — 사설 서버로 라우팅하기

Claude Code는 Anthropic의 공식 CLI예요. 이것을 private-gpt 서버에 연결하면, 모든 요청이 api.anthropic.com이 아니라 내 사설·자체 호스팅 API로 라우팅돼요. PrivateGPT는 Anthropic API를 구현하므로 Claude 전용 도구와 호환돼요.

출처: https://docs.privategpt.dev/integrations/claude-code

호환성

기능	상태
채팅 & 스트리밍	✅
툴 사용 / 함수 호출	✅
파일 툴 (읽기·쓰기·편집)	✅
멀티 에이전트 (서브 에이전트)	✅
이미지	✅
웹 검색	✅

전제 조건

claude 바이너리 설치 (Claude Code 문서 참고)
private-gpt 서버 실행

실행

private-gpt run은 서버 URL과 API 키를 설정에서 읽어서, Claude Code를 실행하기 전에 자동으로 주입해요.

private-gpt run claude-code

서버가 실행 중이 아니면 자동으로 시작돼요. 외부에서 관리되는 서버를 쓰면 --no-server로 그 확인을 건너뛰어요. 특정 모델을 쓰거나 세션을 재개할 수도 있어요.

private-gpt run claude-code --model default
private-gpt run claude-code -- --resume abc123

CI/비대화형 환경에선 --auto-approve를 쓸 수 있어요.

수동 설정

private-gpt run 대신 환경변수를 직접 관리할 수도 있어요.

export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="secret-key"  # server.auth.secret; 인증 비활성이면 아무 값
claude

ANTHROPIC_DEFAULT_OPUS_MODEL·SONNET_MODEL·HAIKU_MODEL로 모든 Claude 티어를 원하는 모델에 고정할 수도 있어요.

주입되는 변수

private-gpt run claude-code는 실행 전에 ANTHROPIC_BASE_URL(서버 URL), ANTHROPIC_API_KEY(auth secret 또는 "no-auth"), 그리고 모델 고정 변수들을 환경에 주입해요. 값은 실행 시점의 서버 설정에서 유도돼요.

더 알아보기

Claude Desktop·OpenCode 등 다른 클라이언트 연동은 Integrations overview 문서에서 확인할 수 있어요.