claude-code-best-practice
튜토리얼shanraisshan/claude-code-best-practice
Claude Code 모범 사례 및 사용 가이드.
개요
Claude Code의 에이전트, 명령어, 스킬, 워크플로우, 메모리, MCP 서버 등의 모범 사례와 구현 예제를 포함하여 개발자가 초보부터 전문가 수준까지 성장할 수 있도록 돕습니다.
README 미리보기
# claude-code-best-practice\nfrom vibe coding to agentic engineering - practice makes claude perfect\n\n \n\n[](best-practice/) [](implementation/) [](orchestration-workflow/orchestration-workflow.md) [](https://code.claude.com/docs) [](#-tips-and-tricks) [](#-subscribe) \n = Agents · = Commands · = Skills\n\n\n \n \n\n\n\n \n\n\n\n \n Boris Cherny on X (tweet 1 · tweet 2 · tweet 3)\n\n\n> [!TIP]\n> Visit the [**How to Use**](#how-to-use) section to take full advantage of this repo.\n\n## 🧠 CONCEPTS\n\n| Feature | Location | Description |\n|---------|----------|-------------|\n| [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/.md` | [](best-practice/claude-subagents.md) [](implementation/claude-subagents-implementation.md) |\n| [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/.md` | [](best-practice/claude-commands.md) [](implementation/claude-commands-implementation.md) |\n| [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills//SKILL.md` | [](best-practice/claude-skills.md) [](implementation/claude-skills-implementation.md) [Official Skills](https://github.com/anthropics/skills/tree/main/skills) · [Skills for Mono-repos](reports/claude-skills-for-larger-mono-repos.md) |\n| [**Workflows**](https://code.claude.com/docs/en/common-workflows) | [`.claude/commands/weather-orchestrator.md`](.claude/commands/weather-orchestrator.md) | [](orchestration-workflow/orchestration-workflow.md) |\n| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [](https://github.com/shanraisshan/claude-code-hooks) [](https://github.com/shanraisshan/claude-code-hooks) [Guide](https://code.claude.com/docs/en/hooks-guide) |\n| [**MCP Servers**](https://code.claude.com/docs/en/mcp) | `.claude/settings.json`, `.mcp.json` | [](best-practice/claude-mcp.md) [](.mcp.json) |\n| [**Plugins**](https://code.claude.com/docs/en/plugins) | distributable packages | [Marketp
FAQ (1)
문제 해결Windows에서 winsound.PlaySound를 사용할 때 후크 사운드가 잘리거나 끝까지 재생되지 않는 이유는 무엇인가요?
문제 해결
Windows에서 winsound.PlaySound를 사용할 때 후크 사운드가 잘리거나 끝까지 재생되지 않는 이유는 무엇인가요?Windows winsound.PlaySound 호출에 winsound.SND_SYNC가 누락되어 있어 재생이 기본적으로 비동기 방식으로 이루어집니다. 이로 인해 스크립트가 곧바로 종료되어 재생이 완료되기 전에 중단됩니다. .claude/hooks/scripts/hooks.py의 호출에 SND_SYNC를 추가하여 수정하세요(존재하는 경우 이에 해당하는 .codex 훅 스크립트도 함께 수정):
winsound.PlaySound(
str(file_path),
winsound.SND_FILENAME | winsound.SND_NODEFAULT | winsound.SND_SYNC
)이렇게 하면 재생이 동기적으로 이루어져 스크립트가 종료되기 전에 소리가 끝까지 재생됩니다.