[docs] CLAUDE.md SDK 초기화 정정 및 Node 버전 명시

[seongwon030]

개요

CLAUDE.md 정확성 점검 중 발견한 두 가지 불일치를 수정합니다.

변경 사항

1. SDK 초기화 위치 정정 — 기존 "모든 SDK는 initSDK.ts에서 초기화" 문구는 부정확. 실제로 initSDK.ts는 Mixpanel·Sentry·Channel.io만 초기화하며, Naver Map은 src/utils/loadNaverMapScript.ts로 동적 로드됨.
2. Node 버전 명시 — .nvmrc가 22.12.0을 고정하고 있으나 문서에 안내가 없어 추가.

검증

• src/utils/initSDK.ts: Mixpanel·Sentry·Channel.io만 init 확인
• src/utils/loadNaverMapScript.ts: Naver Map 동적 로드 확인
• .nvmrc: 22.12.0 확인

문서 변경만 포함 (코드 영향 없음).

Summary by CodeRabbit

Documentation

• 개발 환경 설정 가이드 업데이트: Node 22.12.0 권장 버전 명시 및 nvm 사용법 안내 추가
• 외부 SDK 초기화 및 동적 로드 방식 설명 개선: Mixpanel, Sentry, Channel.io 초기화 위치와 Naver Map 동적 로드 방식 명확화
• 필수 환경 변수 설정 가이드 추가

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
moadong	Ready	Preview, Comment	Jun 9, 2026 1:43am

[coderabbitai]

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)

Validation error: Invalid regex pattern for base branch. at "reviews.auto_review.base_branches[0]"

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

개요

frontend/CLAUDE.md 개발 환경 가이드에 Node.js 버전 권장사항(22.12.0)을 추가하고, 외부 SDK 초기화 및 로드 방식을 명확히 했다.

변경 사항

개발 환경 설정 문서

레이어 / 파일	요약
Node.js 버전 및 SDK 초기화 가이드 frontend/CLAUDE.md	CLAUDE.md에 Node.js 22.12.0 버전 권장사항과 .nvmrc/nvm use 준수 방법을 추가했다. 또한 Mixpanel·Sentry·Channel.io는 initSDK.ts에서 초기화되고, Naver Map은 loadNaverMapScript.ts로 동적 로드되며, 각 서비스별 환경 변수가 필요함을 명시했다.

🎯 1 (Trivial) | ⏱️ ~3 분

관련 PR

• Moadong/moadong#1503: 동일한 frontend/CLAUDE.md 파일의 SDK 초기화 관련 문서를 수정하며, src/utils/initSDK.ts 가이드와 같은 영역의 SDK 통합 문서를 참고하는 PR이다.

추천 레이블

📃 Docs, 💻 FE

추천 검토자

• lepitaaar

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	PR 제목이 변경 사항의 주요 내용을 명확하게 요약하고 있습니다. 'SDK 초기화 정정' 및 'Node 버전 명시'라는 두 가지 주요 변경 사항을 간결하고 구체적으로 표현하고 있습니다.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/claude-md-accuracy-fixes

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Code Review

This pull request updates the frontend/CLAUDE.md documentation to specify the Node version and clarify the initialization and loading mechanisms of various SDKs. The reviewer noted that Kakao SDK is also initialized in src/utils/initSDK.ts and suggested updating the description to include it for accuracy.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@frontend/CLAUDE.md`:
- Line 68: 문서의 68번째 문단에 Kakao 초기화가 빠져 있으므로 CLAUDE.md의 해당 문장을 업데이트해
`src/utils/initSDK.ts`에서 Kakao도 초기화된다고 명시하세요; 구체적으로 initializeKakaoSDK()와
window.Kakao.init(import.meta.env.VITE_KAKAO_JAVASCRIPT_KEY) 호출을 포함해
"initSDK.ts에서 초기화" 목록에 Kakao를 추가하면 됩니다.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ec75d74a-e153-4ee4-9bc9-d5ec77f0eaa1

📥 Commits

Reviewing files that changed from the base of the PR and between cca0b82 and 6c8bd4c.

📒 Files selected for processing (1)

• frontend/CLAUDE.md