SONUB
KO English 한국어 日本語 中文 हिन्दी বাংলা اردو Español Português Français Deutsch Русский العربية Bahasa Indonesia Tiếng Việt ไทย Türkçe

알림을 켜는 방법

이 브라우저 또는 주소에서는 알림을 사용할 수 없습니다. 지원되는 브라우저로 보안 연결된 SONUB 사이트에 접속해 주세요.

알림이 차단되어 있으면 브라우저 설정에서 허용해 주세요.

  1. 주소 표시줄 옆의 사이트 설정 또는 브라우저의 사이트 설정을 열고, 이 사이트의 알림을 허용으로 바꾸세요.
  2. 기기 설정에서 브라우저 알림을 허용하고 방해 금지 또는 집중 모드를 확인하세요.
  3. SONUB으로 돌아와 페이지를 새로고침하세요. 알림이 켜지면 벨은 사라집니다.

iPhone 또는 iPad에서는 SONUB을 홈 화면에 추가하고 거기에서 연 뒤 알림을 허용하세요.
관리자 로그인 화면 테마 기본 테마 다크 테마 핑크 테마 채팅 1:1 채팅 그룹 채팅 게시판 공지사항 뉴스 게시판 건의 게시판 자기소개 게시판 주요 메뉴 로그아웃

클로드 코드 — 터미널에서 일하는 Anthropic 의 에이전틱 코딩 도구

반복하는 일은 로 가르치고, 큰 일은 에게 나눠 맡기고, 꼭 지켜야 할 것은 으로 강제하고, 바깥 는 로 잇고, 사람 없이 돌릴 일은 claude -p 로 스크립트에 넣습니다.

고급 — 넓히기: 스킬·서브 에이전트·훅·MCP·헤드리스

에이전트 스킬 — 반복하는 일을 가르치기

)

은 가 든 폴더입니다. 는 평소에는 스킬의 이름과 설명만 알고 있다가, 일이 그 설명에 맞으면 본문을 읽어 따릅니다. 그래서 스킬을 많이 둬도 자리를 거의 차지하지 않습니다. 예전의 사용자 명령(.claude/commands/)도 이제 스킬로 합쳐졌습니다.

  • .claude/skills/<이름>/SKILL.md 는 이 프로젝트, ~/.claude/skills/<이름>/SKILL.md 는 내 모든 프로젝트에서 씁니다.
  • description 에 무엇을 하고 언제 쓰는지 분명히 적어야 Claude 가 알아서 고릅니다.
  • /<스킬 이름> 으로 직접 부를 수도 있습니다. 새 스킬을 만들기 전에 /skills 로 이미 쓰는 이름을 확인하세요 — 다른 곳의 스킬과 이름이 같으면 /<이름> 으로는 그중 하나만 실행됩니다(이름 은 아래 두 단락).
  • ·참고 문서는 같은 폴더에 두고 SKILL.md 에서 가리킵니다. SKILL.md 는 500줄 아래로 짧게 둡니다.
.claude/skills/release-notes/SKILL.md
---
name: release-notes
description: Write release notes from the git log. Use when the user asks for release notes, a changelog or "what changed since the last tag".
---

# Release notes

1. Find the last tag: `git describe --tags --abbrev=0`
2. Read the commits since then: `git log <tag>..HEAD --oneline`
3. Group them under Added / Fixed / Changed.
4. Write plain sentences a user can understand. Skip internal refactors.

스킬은 열린 표준 — 하지만 클로드 코드는 자기 방식으로 동작

)

스킬은 Claude 를 만든 이 처음 만들어 무료로 공개했고, 지금은 agentskills.io 에서 라는 범용 으로 관리합니다. ··· 등 많은 도구가 같은 SKILL.md 폴더를 읽습니다.

하지만 주의하세요. 표준은 스킬 폴더 안에 무엇을 넣는지만 정하고, 스킬을 어디서 찾는지·이름이 겹치면 무엇을 쓰는지는 도구마다 다릅니다. 는 agentskills.io 가 권하는 방식과 다르게 동작하므로, 다른 도구에서 잘 되던 스킬이 클로드 코드에서는 다르게 동작할 수 있습니다.

  • 폴더: agentskills.io 는 여러 도구가 함께 쓰는 .agents/skills/ 를 권하지만, 클로드 코드는 (프로젝트)와 ~/.claude/skills/(개인)를 읽습니다. .agents/skills/ 는 읽지 않습니다.
  • 이름이 겹칠 때: 표준의 일반 규칙은 프로젝트 스킬이 개인 스킬을 이기지만, 클로드 코드는 반대입니다 — 엔터프라이즈 > 개인(~/.claude/skills/) > 프로젝트 순이라 개인 스킬이 실행됩니다.
  • 상위·: 표준은 정하지 않습니다. 클로드 코드는 시작한 폴더와 그 위로 까지를 읽고, 하위 폴더는 그곳에서 일할 때 읽습니다(다음 단락).
  • : 표준 필드는 name·description··compatibility·· 여섯 개입니다. 클로드 코드는 disable-model-invocation·: fork·paths 같은 필드를 더했는데, 다른 도구는 이를 무시하고 claude.ai 업로드· 는 오류로 멈춥니다.

다른 AI 도구와 함께 쓸 스킬은 frontmatter 를 표준 여섯 필드로만 쓰세요. 그러면 클로드 코드와 다른 도구에서 고치지 않고 그대로 읽힙니다.

클로드 코드가 스킬을 찾는 곳 — 지금 폴더와 상위 폴더를 함께

)

클로드 코드는 claude 를 시작한 폴더와, 그 위로 git 저장소 루트까지 모든 의 .claude/skills/ 를 읽어 함께 씁니다 — apps/web/ 에서 시작해도 루트의 스킬이 함께 잡힙니다( 에서는 worktree 루트까지만 올라갑니다). 저장소 루트보다 위 폴더의 .claude/skills/ 는 읽지 않으므로, 여러 프로젝트에 공통으로 쓸 스킬은 ~/.claude/skills/ 에 두세요.

  • 시작한 폴더보다 아래(하위) 폴더의 스킬은 처음엔 읽지 않습니다. Claude 가 그 폴더의 파일을 처음 읽거나 고칠 때 읽혀 이 끝날 때까지 남고, 그 전에는 / 메뉴에도 없습니다. 미리 읽으려면 /add-dir 로 그 폴더를 더합니다.
  • 루트와 apps/web/ 양쪽에 스킬이 있으면 둘 다 남습니다. /deploy 는 루트의 스킬, /apps/web:deploy 는 apps/web/ 의 스킬을 실행합니다. 클로드 코드는 Claude 에게 두 스킬을 모두 보여 주면서 작업 중인 파일이 있는 폴더의 스킬을 쓰라는 지시를 함께 붙이므로, apps/web/ 에서 하는 일에는 apps/web/ 의 스킬이 쓰입니다(공식 문서: Skills — 이름이 같은 스킬).
  • 스킬은 /<플러그인 이름>:<스킬 이름> 으로 따로 구분되므로 내 스킬과 겹치지 않습니다.
Run claude in apps/web/
~/projects/                    ← above the repository root
├── .claude/skills/            ← not loaded (put shared skills in ~/.claude/skills/)
└── repo/                      ← git repository root
    ├── .claude/skills/        ← loaded
    └── apps/web/              ← run claude here
        ├── .claude/skills/    ← loaded (used together with the root)
        └── src/
            └── .claude/skills/  ← not at start — loads when Claude first reads or edits a file in src/
Same name in two folders (claude started at the repository root)
repo/
├── .claude/skills/deploy/SKILL.md            → /deploy
└── apps/web/.claude/skills/deploy/SKILL.md   → /apps/web:deploy

지금 어떤 스킬이 읽혔는지는 /skills 로 봅니다. 상위·하위에 스킬을 많이 쌓으면 자주 안 쓰는 스킬부터 설명이 잘리므로, 가끔 /skill-doctor 로 점검하세요.

서브 에이전트 — 일을 나눠 맡기기

)

는 자기만의 과 지시·를 가진 도우미입니다. 다시 볼 일 없는 검색 결과·로그·파일 내용으로 대화를 가득 채울 곁가지 일 — 큰 조사, 검토, 실행 — 을 맡기세요. 그 안에서 파일을 아무리 많이 읽어도 요약만 돌아오므로, 메인 대화는 짧게 내 일에만 집중합니다. 다루기도 쉬워집니다: 쓸 수 있는 도구를 제한하고(읽기만 하는 검토자), 더 빠르고 싼 로 돌리고, 매번 같은 지시로 일하게 할 수 있습니다. 같은 종류의 도우미를 자주 부른다면 하나 만들어 두세요.

  • .claude/agents/<이름>.md 는 프로젝트(해 팀과 나눔), ~/.claude/agents/ 는 나만 씁니다. 꼭 필요한 항목은 name 과 description 뿐입니다.
  • tools 로 쓸 수 있는 도구를 줄이면 안전합니다 — 검토 담당은 읽기만 하게 둡니다.
  • 시작되는 길은 둘입니다. ① 에서 직접 부탁 — 이름을 말하거나("code-reviewer 서브 에이전트로 이 변경을 검토해 줘") @ 를 쳐서 고르면 그 서브 에이전트가 확실히 실행됩니다. ② Claude 가 알아서 맡김 — 내 부탁을 서브 에이전트 파일의 description 과 비교해 정하므로, description 에 무엇을 하고 언제 쓰는지 적으세요. "use proactively"를 넣으면 더 적극적으로 맡깁니다.
  • 새 서브 에이전트는 Claude 에게 만들어 달라고 하거나 위 폴더에 파일을 직접 씁니다. 처음부터 들어 있는 Explore·Plan 도 있습니다.
.claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews code changes for bugs, security problems and missing tests. Use after writing or changing code.
tools: Read, Grep, Glob, Bash
model: sonnet
---

You are a careful senior reviewer.
Run `git diff` to see the changes, then report:
1. Bugs (with file and line)
2. Security problems
3. Missing tests
Do not edit files.

훅 — 정해진 때 반드시 실행되는 명령

)

는 부탁이라 가끔 잊힐 수 있지만, 은 클로드 코드가 정해진 순간마다 반드시 실행하는 명령입니다. 파일을 고친 뒤 돌리기, 위험한 명령이나 비밀 파일 편집 막기, 일이 끝나면 알림 받기에 씁니다.

  • — 도구를 쓰기 전(막을 수 있음), — 도구를 쓴 뒤
  • — 부탁을 보낼 때, Stop — Claude 가 답을 마칠 때, SessionStart — 세션을 시작할 때, Notification — 내 확인이 필요할 때
  • 로 어느 도구에 걸지 고릅니다(예: Edit|Write, ).
  • 2의 효과는 이벤트마다 다릅니다. PreToolUse 에서는 동작이 막히고 에 쓴 이유가 Claude 에게 전달됩니다. PostToolUse 에서는 도구가 이미 실행된 뒤라 Claude 가 그 이유를 피드백으로 받을 뿐입니다.
  • /hooks 로 지금 걸린 훅을 봅니다. 아래 예는 Claude 가 고치거나 쓴 파일마다 를 돌립니다: 가 훅 입력에서 파일 를 꺼내고 npx prettier --write 가 그 파일을 정리하므로, jq 와 ()가 있어야 합니다.
.claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

훅은 에서 내 으로 실행됩니다. 남이 준 훅은 명령을 읽고 이해한 뒤에만 넣으세요.

MCP — 바깥 도구와 잇기

)

는 AI 도구가 바깥 서비스(이슈 관리···문서 도구)를 쓰게 하는 열린 표준입니다. 를 하나 더하면 그 가 주는 도구를 Claude 가 쓸 수 있습니다.

  • claude mcp add --transport http <이름> <주소> — 인터넷에 있는 원격 서버를 더합니다.
  • <이름> -- <명령> — 내 컴퓨터에서 실행하는 서버(stdio)를 더합니다. 는 그대로 서버에 넘어갑니다.
  • project 로 더하면 맨 위의 에 저장돼 팀이 함께 씁니다(처음 쓸 때 승인을 묻습니다).
  • /mcp 로 연결 상태를 보고 로그인()합니다. claude mcp list 로 목록을 봅니다.
# A remote server (HTTP)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# A server that runs on your computer (stdio)
claude mcp add playwright -- npx @playwright/mcp@latest

# Share it with the team — saved in .mcp.json
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

claude mcp list

헤드리스 — 대화 화면 없이 스크립트로

)

claude -p "…" 는 대화 화면 없이 한 번 실행하고 결과를 출력한 뒤 끝납니다. 쉘 스크립트·· 에서 Claude 를 부품처럼 씁니다.

  • 파이프로 입력을 넘깁니다(cat error.log | claude -p "…").
  • 은 결과·세션 id·비용을 JSON 으로, stream-json 은 진행을 줄마다 내보냅니다.
  • --allowedTools 로 이번 실행에 허락할 도구를, --max-turns 로 최대 차례 수를 정합니다.
  • claude -p --continue 로 앞 실행을 이어 가거나, <세션 id> 로 그 세션을 이어 갑니다.
Terminal
# One question, one answer
claude -p "Explain what src/auth.ts does in 5 lines"

# Pipe input in
cat build-error.log | claude -p "Find the cause and suggest a fix"

# JSON output for scripts (result, session_id, total_cost_usd)
claude -p "List the TODO comments in src/" --output-format json

# Limit what it may do and how long it runs
claude -p "Run the tests and fix failures" \
  --allowedTools "Read,Edit,Bash(npm test *)" --max-turns 10

스크립트에서는 를 붙이면 CLAUDE.md·훅·플러그인·MCP 를 읽지 않고 빠르게 시작합니다(공식 문서는 앞으로 -p 의 기본이 된다고 안내합니다). 프로젝트 지시가 필요하면 빼세요.

고급 연습

)
  1. 자주 하는 일 하나(예: , 커밋 메시지)를 .claude/skills/ 에 스킬로 만들고 /스킬이름 으로 불러 봅니다.
  2. 읽기만 하는 code-reviewer 서브 에이전트를 만들어 지금 변경을 검토하게 합니다.
  3. PostToolUse 훅으로 파일을 고칠 때마다 포매터나 가 돌게 합니다.
  4. MCP 서버 하나를 더하고 /mcp 로 연결을 확인합니다.
  5. claude -p 로 를 요약하는 한 줄짜리 쉘 스크립트를 만듭니다.

다섯 가지를 모두 해 봤다면 [마스터] 탭으로 넘어가세요.

공식 문서

2026-10-19 에 공식 문서로 확인했어요. 도구가 자주 바뀌니 명령이 안 되면 공식 문서를 보세요.

클로드 코드 실습 Sonub Lab — 클로드 코드 실습 내 컴퓨터의 진짜 클로드 코드를 이 화면의 터미널에서 씁니다 — 세 단계로 설치하고 sonub start 를 실행하세요. SONUB 실습 두뇌를 쓰므로 Claude 구독·API 키가 없어도 됩니다.
다음 걸음

가이드라인

인공지능

에이전트 툴

바이브코딩

AI 활용

AI 인증서

화상 수업

IT 기초

채팅

게시판

만들기

소통

더보기

용어 사전

모르는 말을 골라 보세요. 쉬운 설명과 관련 용어를 볼 수 있어요.

찾는 용어가 아직 없어요.

용어를 고르면 설명이 보여요.
읽기 창