diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..3d6da2e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,58 @@
+# VHills App - Project Documentation
+
+## Project Overview
+
+- **App Name**: vhills
+- **Framework**: React Native 0.74.5 (TypeScript)
+- **React Version**: 18.2.0
+- **Platforms**: Android, iOS
+- **Node Requirement**: >= 18
+
+## Repository & Server Info
+
+| Item | Detail |
+|------|--------|
+| **Gitea URL** | http://116.122.157.166:3001/javamon/app_vhills |
+| **Gitea Account** | javamon / @W3e4r5t (admin) |
+| **Git Remote** | http://116.122.157.166:3001/javamon/app_vhills.git |
+| **Default Branch** | main |
+
+## Development Commands
+
+```bash
+# Metro 서버 시작
+npm start
+
+# Android 실행
+npm run android
+
+# iOS 실행
+npm run ios
+
+# Lint
+npm run lint
+
+# Test
+npm test
+```
+
+## Project Structure
+
+```
+app_vhills/
+├── App.tsx              # 앱 진입 컴포넌트
+├── index.js             # 앱 등록 엔트리
+├── android/             # Android 네이티브
+├── ios/                 # iOS 네이티브
+├── __tests__/           # 테스트
+├── package.json
+├── tsconfig.json
+├── babel.config.js
+├── metro.config.js
+└── jest.config.js
+```
+
+## Status
+
+- Initial boilerplate (react-native init) 상태
+- 추가 라이브러리 미설치