pandacode: Claude Code 경험을 모든 모델에서 실행하기

Claude Code는 대화형 경험이 뛰어납니다—세션, 도구 호출, 파일 읽기/쓰기, 원격 제어까지 완벽한 세트를 제공합니다. 하지만 Anthropic 모델에 종속되어 있습니다: 구독에는 한도가 있고, API 종량제 요금은 저렴하지 않으며, 일부 팀은 회사 내부 네트워크의 모델 게이트웨이만 사용해야 해서 Anthropic에 연결조차 할 수 없습니다.

pandacode는 이러한 상황을 위해 만들어졌습니다: Rust로 처음부터 작성된 경량 코딩 에이전트 엔진으로, 외부 동작은 Claude Code와 완전히 동일하지만 (동일한 스트리밍 출력, 동일한 도구 루프, 동일한 세션 프로토콜) 모델 백엔드는 사용자가 결정합니다.

어떤 모델을 연결할 수 있나

pandacode는 두 가지 API 형식을 동시에 지원하므로, 시중의 거의 모든 모델 서비스를 연결할 수 있습니다:

또한 커스텀 HTTP 헤더 인증을 지원합니다—많은 기업 내부망 프록시는 표준 Bearer 토큰을 사용하지 않고 access_token이나 출발지 IP 같은 커스텀 헤더를 요구하는데, pandacode가 기본 지원하므로 설정에 작성하기만 하면 됩니다.

기능 개요

• 6개의 내장 도구: Read / Write / Edit / Bash / Glob / Grep—코드 읽기, 파일 수정, 명령 실행, 프로젝트 검색 등 코딩 에이전트의 핵심 동작을 모두 갖추고 있습니다;
• 완전한 도구 루프: 모델이 연속적으로 도구를 호출하고, 결과를 받고, 추론을 계속하여 작업이 완료될 때까지 진행할 수 있습니다;
• 스트리밍 출력: 단어 단위로 응답을 렌더링하여 Claude Code와 동일한 느낌을 제공합니다;
• PandaNpc 제품군과 통합: 독립적인 "엔진"으로 실제 Claude Code와 공존합니다—PandaNpc App (데스크톱/웹/iPhone)에서 연결에 pandacode 엔진을 선택하면 원격으로 제어할 수 있으며, 세션 헤더에 🐼 pandacode 배지가 표시됩니다;
• 매우 작은 크기: 단일 바이너리 약 2MB로, pandapaw와 함께 배포됩니다.

설치

pandacode는 pandapaw (PandaNpc의 통합 커맨드라인 도구)에 내장되어 있으며, 한 줄 명령으로 설치할 수 있습니다:

# macOS / Linux
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

# Windows (PowerShell)
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

설치 스크립트는 pandapaw와 pandacode를 함께 설치합니다. 이미 pandapaw를 설치한 기존 사용자는 pandapaw update를 한 번 실행하면 pandacode가 자동으로 추가됩니다.

모델 백엔드 설정

방법 1: DeepSeek (가장 간단)

DeepSeek는 Anthropic 호환 엔드포인트를 제공하며, 한 줄 명령으로 키를 입력하면 됩니다:

pandapaw pandacode set-key sk-你的DeepSeek密钥
pandapaw install   # 注册 pandacode 常驻服务

기본적으로 https://api.deepseek.com/anthropic + deepseek-chat를 가리키며, 설치 후 바로 사용 가능합니다.

방법 2: OpenAI 형식 엔드포인트 (Qwen / vLLM / Ollama / 내부망 프록시)

~/.pandapaw/config.toml을 편집하여 [pandacode] 섹션을 추가합니다:

[pandacode]
format   = "openai"                      # OpenAI Completions 格式
base_url = "http://your-llm-gateway/v1"  # 端点 = base_url + /chat/completions
token    = "sk-your-key"                 # 标准 Bearer；无 Bearer 鉴权就填 sk-not-required
model    = "qwen3.5-plus"

# 内网代理用自定义头鉴权？加这段（token 填 sk-not-required 即不发 Bearer）：
[pandacode.headers]
access_token = "你的内网token"

수정 후 pandapaw install (또는 pandacode 서비스 재시작) 하면 적용됩니다. 로컬 Ollama도 같은 방식으로 작성합니다: base_url = "http://127.0.0.1:11434/v1", model = "qwen2.5-coder", token은 아무 값이나 입력합니다.

모델 키는 사용자 기기의 설정 파일에만 저장되며, 서버에 업로드되거나 데이터베이스에 저장되지 않습니다.

앱에서 사용하기

설치가 완료되면, 이 기기는 your-machine-name-pc라는 ID로 PandaNpc의 릴레이 네트워크에 등록됩니다. PandaNpc App (pandanpc.com 웹 버전 또는 데스크톱/iPhone 클라이언트)을 열고:

1. 새 Claude Code 연결을 생성(또는 수정)하고 엔진을 pandacode로 선택합니다;
2. 세션을 열고 정상적으로 메시지를 보냅니다—코드 작성, 버그 수정, 명령 실행 등 Claude Code와 동일한 경험을 제공합니다;
3. 세션 헤더의 🐼 배지는 이 세션이 사용자 자신의 모델에서 실행되고 있음을 나타냅니다.

동일한 세션 프로토콜을 사용하기 때문에, 휴대폰에서의 원격 제어, 연결 끊김 후 재연결, 기록 재생 등 PandaNpc의 모든 기능을 사용할 수 있습니다.

언제 pandacode를 선택하고, 언제 진짜 Claude Code를 선택할까

두 엔진은 앱에서 공존합니다: 같은 기기에 Claude Code 연결과 pandacode 연결을 동시에 두고 작업에 따라 선택하여 사용할 수 있습니다.

요약

pandacode는 "Claude Code의 경험"과 "Anthropic의 모델"을 분리합니다: 경험은 유지하고, 모델은 자유롭게 선택할 수 있습니다. 한 줄의 설치 명령과 몇 줄의 설정만으로 DeepSeek / Qwen / 내부망 모델에 원격으로 제어 가능한 코딩 에이전트를 갖출 수 있습니다.

설치 후 문제가 있으면 pandanpc.com에서 피드백을 보내주세요.