From 6afdcaa2c3bc7b9cb9284f4a52a45fb3ba962dc7 Mon Sep 17 00:00:00 2001
From: kjh2064 <kjh2064@gmail.com>
Date: Fri, 26 Jun 2026 23:40:11 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20SSH=20=ED=84=B0=EB=84=90=EC=9D=84=20?=
 =?UTF-8?q?=EC=82=AC=EC=9A=A9=ED=95=9C=20Git=20Push=20=EB=B0=A9=EB=B2=95?=
 =?UTF-8?q?=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CLAUDE.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 5357d21..ec72423 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -179,6 +179,56 @@ INSERT INTO blog_posts (title, content, slug, category_id, is_published, created
 VALUES ('제목', '내용', 'slug-text', 1, true, NOW());
 ```
 
+### 3.5 Git Push with Gitea Token (Windows)
+
+**환경 변수 설정** (한 번만 필요):
+1. 시스템 환경 변수 편집 (`Win+X` → 시스템)
+2. "환경 변수" 버튼 클릭
+3. 새로 만들기 → `GITEA_TOKEN_TAXBAIK` = `[토큰값]`
+4. PowerShell 재시작 필수
+
+**Git Push 방법** (권장: SSH 터널):
+
+#### 방법 A: SSH 터널 + HTTP Push (권장)
+
+**단계 1: 터미널 1 - SSH 터널 유지**
+```bash
+ssh -L 3000:127.0.0.1:3000 kjh2064@178.104.200.7
+# 터널이 열린 상태 유지
+```
+
+**단계 2: 터미널 2 - Git Push**
+```powershell
+cd D:\JobRoomz\taxbaik
+$token = $env:GITEA_TOKEN_TAXBAIK
+git push "http://kjh2064:${token}@localhost:3000/kjh2064/taxbaik.git" master
+```
+
+**장점**:
+- ✅ 로컬 네트워크 차단 회피 (SSH는 열림)
+- ✅ 안전 (token은 로컬 루프백)
+- ✅ 신뢰성 높음
+
+#### 방법 B: SSH로 직접 Push (SSH key 필요)
+
+```bash
+# SSH key가 이미 설정되어 있으면
+git push ssh://git@178.104.200.7:2222/kjh2064/taxbaik.git master
+```
+
+#### 방법 C: HTTPS Direct (네트워크 차단이 없으면)
+
+```powershell
+$token = $env:GITEA_TOKEN_TAXBAIK
+git push "https://kjh2064:${token}@178.104.200.7/kjh2064/taxbaik.git" master
+```
+
+**Gitea Actions 자동 배포**:
+1. git push 성공 → master 브랜치에 커밋
+2. Gitea Actions CI/CD 자동 trigger (.gitea/workflows/deploy.yml)
+3. 빌드 → 배포 → 서비스 재시작 자동 실행
+4. 배포 진행 상황: `http://localhost:3000/kjh2064/taxbaik/actions` (SSH 터널 사용 시)
+
 ---
 
 ## 6. 서버 & 배포