OkayStudy
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을 홈 화면에 추가하고 거기에서 연 뒤 알림을 허용하세요.
클로드 코드 실습

Sonub Lab — 클로드 코드 실습

클로드 코드 설명을 읽으며 옆 터미널에서 바로 연습합니다. 설치 없이 무료인 Sonub Lab 서버의 Sonub 코딩 에이전트나, 내 컴퓨터의 클로드 코드로 시작하세요.

중급 — 매일 쓰는 습관: 지시 파일·권한·컨텍스트

설치하고 첫 작업을 해 봤다면 이제 매일 쓰는 습관을 들입니다. 프로젝트 지시(), 여러 가 함께 읽는 , 과 모드, 정리, 잘 부탁하는 법을 차례로 익히고 연습으로 마무리합니다. 그중 가장 먼저 할 일은 연결입니다 — 가 고친 화면을 직접 열어 확인하게 하세요.

브라우저 연결 — 고친 화면을 Claude 가 직접 열어 확인하게

웹 화면을 만드는 일에서 는 브라우저가 연결되어 있을 때 가장 잘 일합니다. 를 고치고, 를 열고, 클릭과 입력으로 흐름을 따라가고, 와 을 읽고, 틀린 곳을 다시 고치는 바퀴를 사람 없이 끝까지 돕니다. " 통과"라는 말만 믿지 않고 실제 화면에서 확인하게 하는 것 — 이것이 브라우저 연결을 반드시 써야 하는 이유입니다.

Claude 는 을 열어 일하고(마다 탭 그룹 하나로 묶습니다), 내 브라우저의 로그인 상태를 그대로 씁니다. 그래서 따로 를 잇지 않아도 이미 로그인한 관리 화면·Google Docs·Gmail 같은 에서 일할 수 있습니다. 어느 사이트에서 클릭·입력해도 되는지는 의 사이트 권한으로 정합니다.

  • 실시간 — 콘솔 오류와 DOM 상태를 직접 읽고, 원인이 된 코드를 고칩니다.
  • 화면 확인 — 시안대로 만들었는지, 넓은 화면과 좁은 화면에서 깨지지 않는지 열어 봅니다.
  • 웹 앱 테스트 — 폼 검사·로그인·주문 같은 사용자 흐름을 끝까지 따라가 봅니다.
  • 로그인된 사이트에서 일하기 — 설정 바꾸기, 폼 채우기, 의 파일 올리기, 페이지의 를 뽑아 파일로 저장하기.
  • 기록 — 한 일을 로 녹화하거나 을 파일로 저장해 보고에 붙입니다.
claude --chrome

# inside Claude Code
/chrome    # Status: Enabled · Extension: Installed · "Enabled by default"
/mcp       # claude-in-chrome → View tools

I changed the login form validation. Open localhost:3000/login,
submit it with an empty email, and check that the error message
appears and the console has no errors. Fix anything that is wrong.

@browser go to localhost:3000 and check the console for errors

가 안 들으면 /chrome 에서 Reconnect extension 을 고릅니다. 확장과 클로드 코드가 서로 다른 계정이나 조직으로 로그인되어 있으면 "Browser extension is not connected" 가 납니다(/status 로 조직 확인). 이 뜨면 브라우저 이 막히니 직접 닫고 계속하라고 말합니다. 브라우저 도구가 늘 실려 컨텍스트를 조금 더 쓰지만, 웹 일을 한다면 켜 두는 편이 훨씬 낫습니다.

모델과 생각 수준(effort) — 무엇을 쓸까 (추천: Opus 5.5, High)

2026년 11월 기준 개발에는 Opus 5.5 를 High 수준으로 쓰세요. 기본 수준이 medium 이므로 아래처럼 설정하거나 / opus 와 /effort high 를 실행합니다. 모든 모델과 생각 수준, 언제 낮추고 올릴지는 툴 마스터의 툴 추천 사용법에 있습니다.

~/.claude/settings.json
{
  "model": "opus",
  "effortLevel": "high"
}
Terminal
claude --model opus --effort high

# inside Claude Code
/model opus
/effort high

CLAUDE.md — 세션마다 읽는 프로젝트 지시

CLAUDE.md 는 클로드 코드가 세션을 시작할 때마다 읽는 파일입니다. ·테스트 명령, 코드 , 하지 말아야 할 일처럼 매번 말하기 번거로운 것을 적어 둡니다. 을 실행하면 프로젝트를 읽고 첫 CLAUDE.md 를 만들어 줍니다. 여러 곳의 CLAUDE.md 는 서로 덮어쓰지 않고 모두 합쳐 읽습니다.

  • ~/.claude/CLAUDE.md — 내 모든 프로젝트에 쓰는 개인 지시
  • ./CLAUDE.md 또는 ./.claude/CLAUDE.md — 팀이 함께 쓰는 프로젝트 지시( 에 )
  • ./CLAUDE.local.md — 이 프로젝트에서 나만 쓰는 지시( 에 넣음). 단, 하나라도 있으면 AGENTS.md 가 읽히지 않습니다
  • 의 CLAUDE.md — 그 폴더의 파일을 읽거나 고칠 때 더 읽음. .claude/rules/ 의 규칙 파일은 paths 로 특정 파일에만 걸 수 있음
CLAUDE.md
# My App

## Commands
- Install: npm install
- Test: npm test
- Lint: npm run lint

## Rules
- TypeScript strict mode. Do not use `any`.
- Put new API routes in src/routes/.
- Never edit files in vendor/.
- Run the tests before you say a task is done.

@docs/architecture.md

짧게 쓰세요(공식 문서 권장 줄 이하). 매번 읽으므로 길면 자리를 차지하고 중요한 규칙이 묻힙니다. /memory 로 지금 읽힌 지시 파일을 보고 바로 열어 고칠 수 있고, @docs/architecture.md 처럼 로 다른 파일을 불러올 수 있습니다. 여러 AI 를 함께 쓴다면 프로젝트에는 CLAUDE.md 대신 AGENTS.md 만 두는 것이 가장 좋습니다 — 바로 아래 단락을 보세요.

AGENTS.md 만 쓰기 — 여러 AI 가 같은 지시로 일하게

왜 이렇게 할까요? 한 프로젝트에서 클로드 코드와 함께 ·· 같은 다른 AI 도 쓴다면, 도구마다 지시 파일을 따로 두면 금방 내용이 서로 달라집니다. AGENTS.md 는 여러 가 함께 읽는 열린 형식입니다. 규칙을 AGENTS.md 한 곳에 적어 두면 어느 AI 로 일하든 모두 같은 지시를 따릅니다. 아래 방법은 바로 이것 — 하나의 프로젝트에서 여러 AI 가 AGENTS.md 를 통해 모두 같은 지시를 쓰게 하는 것 — 을 위한 것입니다.

클로드 코드도 AGENTS.md 를 직접 읽지만(v2.1.277 이상), CLAUDE.md 와 똑같지는 않습니다.

  • 기본 설정에서는 작업 폴더나 그 위 폴더에 CLAUDE.md·./CLAUDE.md· 가 하나도 없을 때만 AGENTS.md 를 읽습니다. 개인 메모용 CLAUDE.local.md 하나만 만들어도 AGENTS.md 는 읽히지 않습니다(~/.claude/CLAUDE.md 와 .claude/rules/ 는 이 판단에 들어가지 않습니다).
  • 하위 폴더의 AGENTS.md 는 그 폴더의 파일을 Read 도구로 열 때만 읽습니다. 그 폴더에 새 파일을 바로 만들 때는 아직 규칙을 모를 수 있습니다. 하위 폴더의 CLAUDE.md 는 읽기·쓰기·편집 모두에서 읽힙니다.
  • AGENTS.local.md··./ 폴더 안의 파일은 읽지 않고, --add-dir 로 더한 폴더의 AGENTS.md 도 읽지 않습니다.

가장 좋은 방법은 프로젝트 폴더에서 CLAUDE.md 를 아예 쓰지 않고 AGENTS.md 만 쓰는 것입니다. 그러면 내 지시인 ~/.claude/CLAUDE.md 는 그대로 기본으로 읽히고, 프로젝트 폴더에서는 AGENTS.md 가 쓰입니다. Codex 같은 다른 AI 도 같은 AGENTS.md 를 읽으므로, 규칙은 AGENTS.md 한 곳에서만 고치면 됩니다.

하지만 프로젝트 폴더···하위 폴더 중 한 곳에서라도 CLAUDE.md 를 쓴다면, 반드시 모든 폴더에서 CLAUDE.md 를 써야 합니다. 작업 폴더나 그 위에 CLAUDE.md 가 하나라도 있으면 클로드 코드는 AGENTS.md 를 읽지 않으므로, 섞어 쓰면 어떤 폴더의 규칙은 읽히고 어떤 폴더의 규칙은 빠집니다. 이때 AGENTS.md 도 같이 쓰고 싶다면 각 CLAUDE.md 에 @AGENTS.md 한 줄만 더하면 됩니다. @경로 는 그 파일의 내용을 그 자리에 불러오는 문법이고, 공식 문서도 이렇게 불러와도 AGENTS.md 를 두 번 읽지는 않는다고 설명합니다.

  1. 공통 규칙(설치·테스트 명령, 코드 규칙, 하지 말 것)을 프로젝트 맨 위의 AGENTS.md 에 적습니다. Codex 의 /init 으로 만들어도 됩니다.
  2. 프로젝트 안(지금 폴더·상위 폴더·하위 폴더 어디에도)에 CLAUDE.md·.claude/CLAUDE.md·CLAUDE.local.md 를 만들지 않습니다.
  3. 모든 프로젝트에 쓰는 내 개인 지시는 ~/.claude/CLAUDE.md 에 둡니다 — AGENTS.md 와 함께 늘 읽힙니다.
  4. 하위 폴더에 따로 규칙이 있으면(예: api/) 그 폴더에도 AGENTS.md 를 둡니다.
  5. 클로드 코드에서 /memory 를 열어 AGENTS.md 가 읽혔는지 확인합니다. CLAUDE.md 를 쓰기로 했다면 모든 폴더의 CLAUDE.md 에 @AGENTS.md 한 줄이 있는지도 확인합니다.
Best — AGENTS.md only
~/.claude/CLAUDE.md    ← your personal rules (still loaded by default)

my-project/
├── AGENTS.md          ← shared rules for every AI (Claude Code, Codex, Cursor, Gemini …)
└── api/
    └── AGENTS.md      ← rules only for api/

(no CLAUDE.md anywhere in the project)
If you use CLAUDE.md anywhere — put one in every folder
my-project/
├── AGENTS.md
├── CLAUDE.md          ← @AGENTS.md
└── api/
    ├── AGENTS.md
    └── CLAUDE.md      ← @AGENTS.md
CLAUDE.md
@AGENTS.md

알아 둘 점과 다른 방법. ① AGENTS.md 만 쓸 때 하위 폴더의 AGENTS.md 는 그 폴더의 파일을 Read 로 열 때 읽힙니다. ② /config 의 Project instructions 를 claude-md-and-agents-md 로 바꾸면 폴더마다 CLAUDE.md 다음에 AGENTS.md 를 함께 읽습니다. ③ (ln -s AGENTS.md CLAUDE.md)도 되지만 가 섞이면 @AGENTS.md 한 줄이 안전합니다.

권한과 모드 — 묻지 않고 해도 되는 일 정하기

클로드 코드는 파일을 고치거나 명령을 실행하기 전에 허락을 묻습니다. 같은 허락을 매번 누르기 번거로우면 규칙으로 정해 두고, 일의 성격에 맞게 모드를 바꿉니다.

  • — 모드 바꾸기: 기본(매번 묻기) → (파일 편집은 묻지 않음) → plan(읽기만 하고 계획을 보여 줌). auto 모드에서 시작했다면 첫 번째 누름이 기본으로 바꿉니다.
  • /permissions — 허락(allow)·묻기(ask)·거부(deny) 규칙과 그 규칙이 어느 파일에서 왔는지 보고 고칩니다.
  • 은 팀이 함께 쓰는 규칙(커밋), .claude/settings.local.json 은 나만 쓰는 규칙, ~/.claude/settings.json 은 내 모든 프로젝트의 규칙입니다.
  • 규칙은 deny → ask → allow 순서로 봅니다. 어느 곳에서든 deny 한 것은 다른 곳의 allow 로 풀 수 없으니, 같은 비밀 파일은 deny 로 막아 둡니다.
.claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

(--dangerously-skip-permissions)는 모든 확인을 끕니다. 인터넷이 막힌 ·처럼 망가져도 괜찮은 곳에서만 쓰세요.

컨텍스트 관리 — 대화가 길어질 때

Claude 가 한 번에 볼 수 있는 양()은 정해져 있습니다. 대화·읽은 파일·명령 출력이 모두 여기에 쌓이고, 가득 차면 앞의 내용을 요약합니다. 길어질수록 앞의 지시가 흐려지므로 정리하는 습관을 들입니다.

  • /context — 지금 컨텍스트를 무엇이 얼마나 차지하는지 색깔 칸으로 봅니다.
  • /compact — 지금까지의 대화를 요약해 자리를 비웁니다. 남길 것을 덧붙일 수 있습니다(예: /compact 로그인 수정 위주로).
  • — 관계없는 다른 일을 시작할 때 대화를 새로 시작합니다.
  • claude -c 는 이 폴더의 마지막 대화를 이어 가고, claude -r 이나 은 지난 대화를 골라 이어 갑니다.
  • 두 번(또는 /rewind) — 목록에서 앞 시점을 골라 대화·코드를 되돌립니다. 로 지우거나 옮긴 파일은 되돌리지 못하므로 Git 커밋을 대신하지는 않습니다.

한 대화에는 한 가지 일. 일이 바뀌면 /clear 로 새로 시작하는 것이 가장 쉬운 정리입니다.

컨텍스트 아끼기 — SONUB 기준: 약 400k 에서 자동 요약, 기본 컨텍스트는 6% 이하

Claude 는 부탁을 받을 때마다 지금 컨텍스트 전체를 다시 읽습니다. 컨텍스트가 클수록 한 번의 부탁에 드는 이 많아집니다. 그래서 (자동 요약)로 1M 전부가 아니라 약 400k 토큰으로 쓰고, 대화를 시작하기 전부터 자리를 차지하는 기본 컨텍스트(기본 ·· 등)를 6% 이하로 유지합니다. 이렇게 하면 사용량을 크게 줄일 수 있습니다. 약 400k·6% 는 SONUB 이 정한 기준이며 공식 권장값이 아닙니다 — 공식 문서는 설정 방법만 설명합니다.

  • /autocompact 444k — 컨텍스트가 444k 토큰에 이르면 자동으로 요약하게 합니다. 지금 모델의 사용자 설정에 저장되고, /autocompact auto 로 되돌립니다.
  • 모든 모델에 쓰려면 ~/.claude/settings.json 에 "autoCompactWindow": 444000 을 넣습니다(아래 예). 한 번만 쓸 때는 claude --autocompact 444k 로 시작합니다.
  • 새 대화를 열자마자 /context 를 봅니다. 아직 아무것도 부탁하지 않았는데 차지한 몫 — 시스템 프롬프트·시스템 도구·MCP 도구·스킬·(CLAUDE.md·AGENTS.md) — 이 기본 컨텍스트이고, 합이 6% 이하여야 합니다.
  • 6% 를 넘으면 줄입니다 — 쓰지 않는 는 /mcp 에서 끄고, 쓰지 않는 스킬·은 지우고, CLAUDE.md·AGENTS.md 에는 꼭 필요한 규칙만 남깁니다.
~/.claude/settings.json
{
  "autoCompactWindow": 444000
}

기본 컨텍스트는 부탁할 때마다 함께 보내지므로 몇 % 만 줄여도 대화 내내 쌓여 사용량이 크게 줄어듭니다. 압축되기 전이라도 일이 바뀌면 /clear 로 새로 시작하는 것이 가장 큰 절약입니다.

잘 부탁하는 법 — 어디·무엇·어떻게 확인

좋은 부탁에는 세 가지가 들어 있습니다: 어디(파일·폴더), 무엇(바라는 동작), 어떻게 확인할지(테스트·명령·화면). 셋이 분명할수록 Claude 가 덜 헤매고 결과를 스스로 확인합니다.

  • 막연한 부탁: "로그인 고쳐 줘"
  • 또렷한 부탁: "@app//Controllers/LoginController.php 에서 비밀번호가 틀리면 가 나. 422 와 오류 문구를 돌려주게 고치고, tests/Feature/LoginTest.php 에 테스트를 더해 통과하는 것까지 확인해 줘."
  • @ 를 입력하면 파일을 골라 부탁에 붙일 수 있습니다(@src/login.ts).
  • 오류 화면·디자인 은 스크린샷을 붙여 넣거나 끌어다 놓습니다.
  • 큰 일은 "먼저 읽고 계획만 보여 줘, 아직 고치지 마"로 시작하거나 /plan 으로 에 들어갑니다.
  • 어려운 문제는 /model 에서 모델과 (effort)을 높이거나, 부탁에 를 넣어 그 차례만 더 깊이 생각하게 합니다.
  • <> — 다음 부탁 없이도 그 기준을 채울 때까지 Claude 가 차례를 이어 가며 일합니다(예: /goal tests/ 의 테스트가 모두 통과한다, or stop after 20 ). /goal 만 치면 상태를 보고, /goal clear 로 지웁니다.

모범 사례 — Anthropic 이 권하는 Claude Code 사용법

줄이면 — Claude 가 스스로 확인할 방법을 주고, 어려운 일은 먼저 계획하고, 구체적으로 부탁하고, CLAUDE.md 는 짧게, 일 사이에는 컨텍스트를 비웁니다. 두 공식 안내의 좋은 습관 여섯과 Claude Code·Codex 명령은 툴 추천 사용법에 있습니다.

흔한 실수 — 그리고 고치는 법

공식 안내는 실패 패턴 다섯을 경고합니다 — 잡탕 세션, 고치고 또 고치기, 너무 긴 CLAUDE.md, 확인 없이 믿기, 끝없는 조사. 두 안내의 흔한 실수 열 가지와 고치는 법은 툴 추천 사용법에 있습니다.

중급 연습 — 내 프로젝트에서 해 보기

  1. 내 프로젝트 맨 위에 AGENTS.md 를 만들어 테스트 명령과 규칙 세 가지를 적고, 프로젝트 안에 CLAUDE.md 가 없는지 확인합니다.
  2. /memory 를 열어 AGENTS.md 와 ~/.claude/CLAUDE.md 가 읽혔는지 확인합니다.
  3. .claude/settings.json 에 테스트 명령 하나를 allow 로, .env 를 deny 로 넣고 /permissions 로 확인합니다.
  4. 작은 기능 하나를 계획 모드로 부탁하고, 계획을 읽고 고친 뒤 승인합니다.
  5. /context 로 차지한 양을 보고, /compact 로 줄인 뒤 다시 봅니다.

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

공식 문서

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

Sonub 코딩 에이전트

아직 연결되지 않았습니다. 아래 단계로 설치하거나, 내 컴퓨터에서 sonub start 를 실행하세요 — 이 화면이 저절로 열립니다.

내 컴퓨터에 연결하는 중…

실습 상자를 여는 중…

연결됨: ·

셸이 끝났습니다. [새 셸] 을 눌러 다시 여세요.

이 터미널은 지금 다른 탭에서 열려 있습니다.

연결이 끊겼습니다. 내 컴퓨터에서 sonub start 가 아직 돌고 있으면 [다시 연결] 을 누르세요. 다시 실행했다면 새로 열린 탭을 쓰세요.

새 sonub 이 나왔습니다 — 아래 설치 명령을 다시 실행하면 바뀝니다.

해 보기:

3단계로 시작

내 컴퓨터의 파일로 하고 싶으면 아래처럼 내 컴퓨터에 설치합니다(고급).

  1. 설치 — 내 컴퓨터의 터미널에 한 줄을 붙여 넣기 관리자 암호도 재부팅도 없습니다. 클로드 코드(없을 때만)와 작은 sonub 명령을 내 홈 폴더에만 넣습니다.

    로그인되어 있습니다 — 이 명령에 내 계정의 1회용 코드가 들어 있어(30분 동안, 한 번만) 승인 단계 없이 바로 연결됩니다.

    먼저 로그인하면 승인 단계 없이 명령 한 줄로 바로 연결됩니다. 로그인

    macOS · Linux 터미널 앱
    curl -fsSL https://okaystudy.com/install.sh | bash
    Windows PowerShell
    irm https://okaystudy.com/install.ps1 | iex
  2. 승인 — SONUB 계정으로 코드를 확인브라우저가 터미널에 보이는 코드가 담긴 화면을 엽니다. 로그인하고 [승인] 을 누르세요.
  3. 연결 — 이 화면이 열리고 터미널이 연결됩니다실습하는 동안 터미널 창을 열어 두세요. 다음부터는 sonub start 만 실행하면 됩니다.

무료 실습 두뇌

  • 회원마다 하루 1,000,000 토큰까지(UTC 00:00 에 초기화).
  • 요청 한 번에 100,000 토큰까지 — 클로드 코드가 대화를 스스로 압축합니다.
  • 실습용입니다: sonub 명령이 연 클로드 코드에서만 됩니다. 내 Claude 설정(~/.claude)은 건드리지 않습니다.
  • 클라우드 실습 상자: 무료, 하루 시간 제한 없음. 소너브 코드는 상자 안에서 명령 실행·웹 검색·패키지 설치까지 모두 하지만 상자 밖에는 닿지 않습니다. 두뇌는 SONUB 가 무료로 제공하는 오픈 모델 Ling 3.0 Flash / Nex-N2.5-Mini / DeepSeek-V4.1-Flash-1017 입니다. 파일은 마지막으로 쓴 뒤 7일이 지나면 지웁니다.
  • 터미널은 내 컴퓨터에서 돕니다 — 클로드 코드가 만든 파일은 내 컴퓨터의 sonub-lab 폴더에 남습니다.
  • sonub start 가 연 sonub.com 화면만, 1회용 짝 코드로, 이 컴퓨터 안에서만 연결할 수 있습니다.
  • 끄려면 sonub 창에서 Ctrl+C 를 누르세요. 지우려면: sonub uninstall

취소할 대기 예약을 선택하세요. 각 예약은 확인 후 취소됩니다.

내 :

닫기