# Step 1: 텔레그램 플러그인 설치
/plugin install telegram@claude-plugins-official

# Step 2: 채널 연결하여 세션 시작
claude --channels plugin:telegram@claude-plugins-official

# Step 3: 텔레그램 봇과 페어링 (QR 또는 코드)
# 페어링 완료 후 allowlist로 접근 가능한 사용자 관리

┌──────────────────┐     아웃바운드       ┌──────────────────────────┐
│  텔레그램 앱       │     HTTPS only     │  MCP 채널 프로토콜 릴레이   │
│  (모바일/데스크톱) │ ─────────────────→ │  (Anthropic 인프라)        │
│                  │ ←───────────────── │                          │
└──────────────────┘                    └────────────┬─────────────┘
                                                     │ 아웃바운드
                                                     │ HTTPS only
                                                     ▼
                                        ┌──────────────────────────┐
                                        │   Claude Code CLI 세션    │
                                        │   (로컬 터미널)            │
                                        │                          │
                                        │   ┌────────────────────┐ │
                                        │   │ 소스 코드 (로컬 유지)│ │
                                        │   └────────────────────┘ │
                                        └──────────────────────────┘

// settings.json (조직 레벨)
{
  "channelsEnabled": false,  // 조직 전체 비활성화
  "allowedChannelPlugins": [
    "telegram@claude-plugins-official"
  ]
}

# 패턴 1: PR 자동 리뷰 (JSON 출력)
claude -p --bare "Review this PR and output JSON with issues found" \
  --allowedTools Read \
  --max-turns 5 \
  --output-format json

# 패턴 2: 보안 취약점 스캔
claude -p --bare "이 디렉토리의 보안 취약점을 분석하고 심각도별로 분류해줘" \
  --allowedTools Read,Grep,Glob \
  --max-turns 10

# 패턴 3: 코드 생성 (단일 파일)
claude -p --bare "Express.js 미들웨어를 생성해줘" \
  --allowedTools Write \
  --max-turns 3 \
  --output-format text

name: Claude Code Automated Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # 변경된 파일만 추출
          CHANGED=$(git diff --name-only ${{ github.event.pull_request.base.sha }})

          # Claude Code로 리뷰 실행
          claude -p --bare \
            "다음 변경 파일들을 리뷰해줘: $CHANGED.
             버그, 보안 이슈, 성능 문제를 JSON 배열로 출력." \
            --allowedTools Read,Grep,Glob \
            --max-turns 15 \
            --output-format json > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const review = require('./review.json');
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## Claude Code Review\n${JSON.stringify(review, null, 2)}`
            });

# VSCode 터미널에서 실행
/rc
# 또는 풀 커맨드
/remote-control

# 출력: QR 코드 + 접속 URL
# 모바일에서 QR 스캔 → 브라우저로 동일 세션 접속

┌──────────────────┐                         ┌────────────────────────┐
│  모바일 브라우저    │ ──── 아웃바운드 ────→   │  Anthropic HTTPS 릴레이 │
│  (Safari/Chrome)  │       HTTPS only       │  (중개 서버)             │
│                  │ ←─── 아웃바운드 ─────    │                        │
└──────────────────┘       HTTPS only        └──────────┬─────────────┘
                                                        │ 아웃바운드
                                                        │ HTTPS only
                                                        ▼
                                             ┌────────────────────────┐
                                             │  로컬 VSCode + CLI      │
                                             │  ┌──────────────────┐  │
                                             │  │ 소스 코드 (로컬)  │  │
                                             │  │ 외부 전송 없음    │  │
                                             │  └──────────────────┘  │
                                             └────────────────────────┘

# 대형 모노레포 전체 의존성 분석 (128K 컨텍스트 + ultrathink)
claude "이 모노레포의 250개 패키지 간 순환 의존성을 찾고 해결 방안을 제시해줘"

# 복잡한 마이크로서비스 아키텍처 설계
claude "결제 서비스와 주문 서비스 간 eventual consistency 패턴을 설계해줘.
       Saga 패턴과 Outbox 패턴을 비교 분석하고 코드로 구현해줘"

MCP 서버              Claude Code CLI           사용자
   │                        │                      │
   │── Elicitation ────────→│                      │
   │   { schema: {          │── 폼 표시 ──────────→│
   │     type: "object",    │                      │
   │     properties: {      │                      │── 값 입력
   │       db_password: {   │                      │   (폼 필드 또는
   │         type: "string",│                      │    브라우저 URL)
   │         format:"pass"  │                      │
   │       }                │←── 입력값 전달 ───────│
   │     }                  │                      │
   │   }}                   │                      │
   │←─ ElicitationResult ──│                      │
   │   { db_password: "***"}│                      │
   │                        │                      │
   │── 도구 실행 계속 ──────→│                      │

Elicitation 훅      → MCP 서버가 입력을 요청할 때 트리거
ElicitationResult 훅 → 사용자가 입력을 완료했을 때 트리거
PostCompact 훅       → 컨텍스트 압축 후 후처리 (동일 릴리즈에 추가)

# 플러그인 내부에서 세션 간 데이터 유지
echo $CLAUDE_PLUGIN_DATA
# → ~/.claude/plugins/{plugin-name}/data/

# 플러그인이 이 경로에 파일을 저장하면 세션 종료 후에도 유지

// settings.json
{
  "plugins": {
    "my-custom-tool": {
      "source": "settings",
      "config": {
        "apiEndpoint": "https://api.example.com",
        "maxRetries": 3
      }
    }
  }
}

---
effort: low
maxTurns: 5
disallowedTools:
  - Bash
  - Write
---
# 경량 분석 에이전트
이 에이전트는 읽기 전용으로 코드를 분석합니다.

# 플러그인 유효성 검증
plugin validate
# → YAML 구문 오류, 스키마 불일치, 필수 필드 누락 등 검출

// 공격 시나리오 (차단됨)
PreToolUse Hook A → allow (정상 판정)
PreToolUse Hook B → deny  (악의적 덮어쓰기)
→ v2.1.80 이후: allow 이후 deny 덮어쓰기 불가

# 상태줄 실시간 표시 (v2.1.80)
[rate: 42/100 (5h) │ 280/1000 (7d)] claude>