첫 번째 Claude Code 프로젝트
입문 6 min
Claude Code를 처음 시작하면 다양한 기능에 압도될 수 있습니다. 이 입문 가이드에서는 필수 설정 단계를 안내합니다: CLI 설치, 첫 CLAUDE.md 작성, 권한 설정, 그리고 첫 AI 지원 코딩 세션 실행까지. 가이드를 마치면 Claude Code의 효과를 극대화할 수 있는 체계적으로 구성된 프로젝트를 갖추게 됩니다.
설정입문CLAUDE.md권한온보딩
설치 및 인증
Claude Code is installed as a global npm package. After installation, you authenticate with your Anthropic account. The CLI stores your credentials securely and manages sessions automatically.
Once authenticated, navigate to your project directory and run 'claude' to start an interactive session. Claude Code automatically detects your project structure, reads package.json, and understands your tech stack without any configuration.
For team environments, consider using environment variables for authentication so that CI/CD pipelines and shared development machines can use Claude Code without manual login steps.
# Install Claude Code globally
npm install -g @anthropic-ai/claude-code
# Authenticate (opens browser)
claude auth login
# Start your first session
cd ~/my-project
claude
# Verify installation
claude --version
CLAUDE.md 작성하기
CLAUDE.md is the single most important file for Claude Code productivity. It acts as persistent instructions that Claude reads at the start of every session. Think of it as onboarding documentation for your AI pair programmer.
Start minimal. A good CLAUDE.md answers three questions: What is this project? What tech stack does it use? What conventions should Claude follow? Resist the urge to write a comprehensive document on day one. Instead, add rules organically as you discover patterns.
Place CLAUDE.md at the project root. Claude Code searches for it automatically. You can also create a ~/.claude/CLAUDE.md for global instructions that apply to all projects.
# CLAUDE.md
## Project
E-commerce API built with Node.js + Express + PostgreSQL.
## Stack
- Runtime: Node.js 20
- Framework: Express 4
- Database: PostgreSQL 16 + Prisma ORM
- Testing: Vitest
- Linting: ESLint + Prettier
## Conventions
- Use async/await, never raw promises
- All API responses follow { data, error, meta } shape
- Database queries go through Prisma, no raw SQL
- Tests are co-located: foo.ts → foo.test.ts
권한 설정
Claude Code uses a permission model to control which actions it can take autonomously. By default, it asks for confirmation before running shell commands, editing files, or making network requests. This is safe but can slow you down.
For trusted projects, you can pre-approve specific actions. The three permission modes are: ask (default), auto-approve for read-only operations, and full auto-approve. Most developers start with the default and gradually allow more as they build trust.
You can also configure per-tool permissions. For example, you might allow file edits automatically but require confirmation for git operations. This granular control lets you balance speed with safety.
# Check current permission settings
claude config list
# Allow file reads without confirmation
claude config set autoApprove.read true
# Allow file edits in specific directories
claude config set autoApprove.editPaths "src/**,tests/**"
# In CLAUDE.md, set project-level permissions
# These apply only to this project:
# Allow: Read, Edit, Glob, Grep
# Ask: Bash, Write (new files)
첫 번째 코딩 세션
With setup complete, it is time to do real work. Start with a small, well-defined task to build confidence. Good first tasks include: adding a utility function, writing tests for existing code, or fixing a known bug.
Be specific in your prompts. Instead of 'make the code better,' say 'add input validation to the createUser endpoint in src/routes/users.ts.' Specific prompts produce better results and consume fewer tokens.
After each session, review what Claude did. Check the git diff, run your tests, and note any patterns you want to encode into CLAUDE.md for future sessions. This feedback loop is how you progressively make Claude Code more effective for your specific project.
# Good first tasks - specific and scoped
claude "add a validateEmail utility in src/utils/validators.ts with tests"
claude "fix the null pointer in src/services/user.ts line 47"
claude "add JSDoc comments to all exported functions in src/utils/"
# Review what changed
git diff
npm test
# If something went wrong, undo easily
git checkout -- .
실행 미리보기
첫 번째 Claude Code 프로젝트
첫 번째 Claude Code 프로젝트에 대해
Claude Code 가이드는 Claude Code의 특정 측면을 마스터하기 위한 심층적인 단계별 안내를 제공합니다. 첫 번째 Claude Code 프로젝트은(는) 입문 수준의 가이드로, 일상 워크플로우에서 Claude Code를 최대한 활용하기 위한 베스트 프랙티스, 실전 기법, 실용적인 팁을 안내합니다.