- Published on
Claude Code 6์ ์ ๋ฐ์ดํธ: ์์ด์ ํธ๊ฐ ์์ด์ ํธ๋ฅผ ๋ถ๋ฅธ๋ค
์กฐ์ง์ด ์ปค์ง๋ฉด ํ์ฅ์ด ํ์์๊ฒ ์ผ์ ์์ํ๊ณ , ํ์์ด ๋ค์ ๋ค๋ฅธ ์ฌ๋์๊ฒ ๋ถ์ ํ๋ ๊ตฌ์กฐ๊ฐ ์์ฐ์ค๋ฝ๊ฒ ๋ง๋ค์ด์ง๋ค. Claude Code์ 6์ ์ ๋ฐ์ดํธ๋ AI ์์ด์ ํธ์๋ ์ด ๊ตฌ์กฐ๋ฅผ ๊ทธ๋๋ก ๋์ ํ๋ค.
์์ด์ ํธ๊ฐ ์์ด์ ํธ๋ฅผ ๋ณ๋๋ค. ์ด๊ฒ ์ด๋ฒ ์ ๋ฐ์ดํธ์ ํต์ฌ์ด๋ค.
๋ชฉ์ฐจ
- ์ค์ฒฉ ์๋ธ์์ด์ ํธ: ์์ด์ ํธ ์กฐ์ง๋๊ฐ ์๊ฒผ๋ค
- /cd ๋ช ๋ น์ด: ์ธ์ ์ด๋, ์ด์ ์บ์ ๊ฑฑ์ ์์ด
- --safe-mode: ๋ฌธ์ ์ง๋จ์ ์ํ ์์ ๊ฒฉ๋ฆฌ ๋ชจ๋
- fallbackModel: ๋ชจ๋ธ ์ฅ์ ๋๋น 3๋จ๊ณ ๋ณดํ
- Rate Limit 2๋ฐฐ ํ๋์ ํ๊ดด์ ๋ช ๋ น ์ฐจ๋จ
- ์๋ํ ํฌ ๊ด์ ์ ์ค์ ์๋๋ฆฌ์ค
1. ์ค์ฒฉ ์๋ธ์์ด์ ํธ: ์์ด์ ํธ ์กฐ์ง๋๊ฐ ์๊ฒผ๋ค
์ด์ ์๋ธ์์ด์ ํธ๊ฐ ์๊ธฐ๋ง์ ์๋ธ์์ด์ ํธ๋ฅผ ๋ง๋ค ์ ์๋ค.
๊ธฐ์กด Claude Code์ ์๋ธ์์ด์ ํธ๋ "๋ฉ์ธ ์์ด์ ํธ๊ฐ ๋ณด์กฐ ์์ด์ ํธ์๊ฒ ์ผ์ ๋งก๊ธฐ๋" 1๋จ๊ณ ์์ ๊ตฌ์กฐ์๋ค. 6์ ์ ๋ฐ์ดํธ๋ก ์ด ๊ตฌ์กฐ๊ฐ ๋ค์ธตํ๋๋ค.
๋ฉ์ธ ์์ด์ ํธ๊ฐ ๋ฆฌ์์น ์๋ธ์์ด์ ํธ๋ฅผ ์์ฑํ๊ณ , ๊ทธ ๋ฆฌ์์น ์์ด์ ํธ๊ฐ ๋ฌธ์ ๋ถ์ ์์ด์ ํธ์ ์น ๊ฒ์ ์์ด์ ํธ๋ฅผ ๊ฐ๊ฐ ๋ฐ๋ก ์์ฑํ๋ ์์ด๋ค. ์ต๋ 5๋จ๊ณ ๊น์ด๊น์ง ์ค์ฒฉ์ด ํ์ฉ๋๋ค.
ํ๋กฌํํธ ํจ๋์์ ๋ณด์ด๋ ๊ฒ
์๋ธ์์ด์ ํธ ํจ๋์ ์ด์ ์ ์ฒด ํธ๋ฆฌ ๊ตฌ์กฐ๋ฅผ ๋ณด์ฌ์ค๋ค. ๊ฐ ํ์๋ ํ์ ์๋ธ์์ด์ ํธ ์์ ๋ฉ์ธ ์์ด์ ํธ๋ก ๋์๊ฐ๋ ๊ฒฝ๋ก๊ฐ ํ์๋๋ค. ๋ณต์กํ ์์ ์ด ์ด๋ค ๊ตฌ์กฐ๋ก ๋ถ๋ฐฐ๋๊ณ ์๋์ง ์ค์๊ฐ์ผ๋ก ๋ณผ ์ ์๋ค.
Main Agent
โโโ Research Sub-agent (3 descendants)
โ โโโ Web Search Agent
โ โโโ Document Parser Agent
โโโ Code Review Sub-agent (1 descendant)
โ โโโ Lint Analysis Agent
โโโ Report Writer Sub-agent
๊น์ด ์ ํ์ ์ด์
๋ฐฑ๊ทธ๋ผ์ด๋ ์๋ธ์์ด์ ํธ๋ 5๋จ๊ณ๋ก ์ ํ๋๋ค. ํฌ๊ทธ๋ผ์ด๋ ์ฒด์ธ์ ๊น์ด ์ ํ ์์ด ์๊ธฐ ์๋ ด์ ์ผ๋ก ์๋ํ๋ค. ์ด ์ ํ์ ํต์ ๋์ง ์์ ๋ณ๋ ฌ ํธ๋ฆฌ๊ฐ ๋ฌดํ ํ์ฅ๋๋ ์ํฉ์ ๋ฐฉ์งํ๊ธฐ ์ํ ๊ฒ์ด๋ค.
2. /cd ๋ช ๋ น์ด: ์ธ์ ์ด๋, ์ด์ ์บ์ ๊ฑฑ์ ์์ด
๋ํ ์ค๊ฐ์ ์์ ๋๋ ํ ๋ฆฌ๋ฅผ ๋ฐ๊ฟ๋ ํ๋กฌํํธ ์บ์๊ฐ ์ ์ง๋๋ค.
์ด์ ๊น์ง๋ ์ธ์ ๋์ค ๋ค๋ฅธ ํ๋ก์ ํธ ๋๋ ํ ๋ฆฌ๋ก ์ด๋ํ๋ ค๋ฉด ์ ์ธ์ ์ ์์ํด์ผ ํ๋ค. ์ ์ธ์ ์ ์ด๋ฉด ํ๋กฌํํธ ์บ์๊ฐ ์ด๊ธฐํ๋์ด ์ด์ ์ปจํ ์คํธ๋ฅผ ๋ค์ ๋ก๋ฉํ๋ ๋น์ฉ์ด ๋ฐ์ํ๋ค.
/cd ๋ช
๋ น์ด๋ ์ด ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ค. ํ์ฌ ์ธ์
์ ์ปจํ
์คํธ์ ์บ์๋ฅผ ๊ทธ๋๋ก ์ ์งํ๋ฉด์ ์์
๋๋ ํ ๋ฆฌ๋ฅผ ์ ํํ๋ค. ํ๋ก ํธ์๋ ์์
์ค์ ๋ฐฑ์๋ ๋๋ ํ ๋ฆฌ๋ก ์ ๊น ๋์ด๊ฐ์ผ ํ ๋, ๋งค๋ฒ ์ธ์
์ ๊ป๋ค ์ผ์ง ์์๋ ๋๋ค.
# ํ์ฌ ํ๋ก ํธ์๋ ์์
์ค
/cd ../backend
# ๋ฐฑ์๋ ๋๋ ํ ๋ฆฌ๋ก ์ด๋, ์บ์ ์ ์ง
3. --safe-mode: ๋ฌธ์ ์ง๋จ์ ์ํ ์์ ๊ฒฉ๋ฆฌ ๋ชจ๋
์ค์ ์ด ๊ผฌ์์ ๋, ๊ฐ์ฅ ๋น ๋ฅธ ์ง๋จ๋ฒ.
Claude Code๋ฅผ ์ปค์คํฐ๋ง์ด์งํ๋ค ๋ณด๋ฉด CLAUDE.md ์ค์ , ์ปค์คํ ํ , ํ๋ฌ๊ทธ์ธ๋ค์ด ์๋ก ์ถฉ๋ํ๋ ๊ฒฝ์ฐ๊ฐ ์๊ธด๋ค. ์ด๋์ ๋ฌธ์ ๊ฐ ์๊ฒผ๋์ง ์ฐพ๊ธฐ๊ฐ ์ด๋ ต๋ค.
--safe-mode ํ๋๊ทธ๋ ๋ชจ๋ ์ปค์คํฐ๋ง์ด์ง์ ๋นํ์ฑํํ ์ํ๋ก Claude Code๋ฅผ ์์ํ๋ค. CLAUDE.md๋, ํ
๋, ํ๋ฌ๊ทธ์ธ๋ ์์ด ์์ํ ๊ธฐ๋ณธ ์ํ๋ก ์คํ๋๋ค. ์ฌ๊ธฐ์ ๋ฌธ์ ๊ฐ ์ฌ๋ผ์ง๋ฉด ์ปค์คํฐ๋ง์ด์ง ์ด๋๊ฐ์ ์์ธ์ด ์๋ค๋ ๊ฒ์ ํ์ธํ ์ ์๋ค.
claude --safe-mode
๋๋ฒ๊น
์ ์ฒซ ๋จ๊ณ๋ "๋ฒ์ ์ขํ๊ธฐ"์ธ๋ฐ, --safe-mode๊ฐ ๊ทธ ์ญํ ์ ํ๋ค.
4. fallbackModel: ๋ชจ๋ธ ์ฅ์ ๋๋น 3๋จ๊ณ ๋ณดํ
1์ฐจ ๋ชจ๋ธ์ด ์ ๋๋ฉด 2์ฐจ, 3์ฐจ๋ก ์๋ ์ ํ.
ํ๋ก๋์
ํ๊ฒฝ์์ AI ๋ชจ๋ธ API๊ฐ ๋ค์ด๋๊ฑฐ๋ ์๋ต์ด ์ง์ฐ๋๋ฉด ์ ์ฒด ์ํฌํ๋ก์ฐ๊ฐ ๋ฉ์ถฐ๋ฒ๋ฆฐ๋ค. fallbackModel ์ค์ ์ ์ด ๋จ์ผ ์ฅ์ ์ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ค.
์ต๋ 3๊ฐ์ ํด๋ฐฑ ๋ชจ๋ธ์ ์์๋๋ก ์ง์ ํ ์ ์๋ค. 1์ฐจ ๋ชจ๋ธ ์คํจ ์ 2์ฐจ, 2์ฐจ ์คํจ ์ 3์ฐจ๋ก ์๋ ์ ํ๋๋ค.
{
"model": "claude-opus-4-8",
"fallbackModel": [
"claude-sonnet-4-6",
"claude-haiku-4-5",
"claude-opus-4-7"
]
}
์์ด์ ํฑ ํ์ดํ๋ผ์ธ์ ๊ตฌ์ถํ๋ ํ์๊ฒ๋ SLA(์๋น์ค ์์ค ํ์ฝ) ์ค์์ ์ง์ ์ ์ธ ๋์์ด ๋๋ค.
5. Rate Limit 2๋ฐฐ ํ๋์ ํ๊ดด์ ๋ช ๋ น ์ฐจ๋จ
Rate Limit 2๋ฐฐ
Anthropic์ด Claude Code์ rate limit์ ๋ ๋ฐฐ๋ก ํ๋ํ๋ค. ๊ฐ๋ฐ์ยท์คํํธ์ ยท์ํฐํ๋ผ์ด์ฆ๊ฐ ๋ ์์ ์ ์ผ๋ก ์ค์ผ์ผ์ ํ ์ ์๋๋ก ํ๊ธฐ ์ํ ์กฐ์น๋ค. ๋ณต์กํ ๋ฉํฐ ์์ด์ ํธ ์์ ์์ ๋ณ๋ชฉ์ด ๋ฐ์ํ๋ ๊ตฌ๊ฐ์ด ๋ํญ ์ํ๋๋ค.
ํ๊ดด์ Git ๋ช ๋ น ์๋ ์ฐจ๋จ
์ด๋ฒ ์ ๋ฐ์ดํธ์์ ์กฐ์ฉํ ์ถ๊ฐ๋์ง๋ง ์ค์ง์ ์ผ๋ก ์ค์ํ ๋ณํ๊ฐ ์๋ค. ์ฌ์ฉ์๊ฐ ๋ช ์์ ์ผ๋ก ์์ฒญํ์ง ์์ ๊ฒฝ์ฐ, ๋ค์ ๋ช ๋ น๋ค์ด ์๋์ผ๋ก ์ฐจ๋จ๋๋ค:
git reset --hardgit checkout -- .git clean -fdgit stash dropterraform/pulumi/cdk destroy(ํน์ ์คํ ๋ช ์ ์์ ๊ฒฝ์ฐ)
"์์
์ค์ธ ํ์ผ์ ์ ๋ฆฌํด์ค"๋ผ๋ ์ง์๋ง์ผ๋ก Claude๊ฐ git reset --hard๋ฅผ ์คํํด ์์๊ฐ์ ์์
์ด ๋ ์๊ฐ๋ ์ฌ๊ณ ๋ฅผ ๋ง๊ธฐ ์ํ ์์ ์ฅ์น๋ค.
6. ์๋ํ ํฌ ๊ด์ ์ ์ค์ ์๋๋ฆฌ์ค
์ค์ฒฉ ์๋ธ์์ด์ ํธ๊ฐ ๊ต์ก ํ์ฅ์์ ์ด๋ป๊ฒ ํ์ฉ๋ ์ ์๋์ง ๊ตฌ์ฒด์ ์ผ๋ก ์๊ฐํด๋ดค๋ค.
ํ์ ๊ณผ์ ์๋ ๋ถ์ ํ์ดํ๋ผ์ธ:
๋ฉ์ธ ์์ด์ ํธ: ์ด๋ฒ ์ฃผ ์ ์ถ๋ ์ฝ๋ฉ ๊ณผ์ 30๊ฐ๋ฅผ ๋ถ์ํด์ค
โโโ ์ฝ๋ ํ์ง ์๋ธ์์ด์ ํธ (30๊ฐ ๊ณผ์ ๋ณ๋ ฌ ๋ฆฌ๋ทฐ)
โโโ Lint ๋ถ์ ์์ด์ ํธ (์ฝ๋ ์คํ์ผ ๊ฒ์ฌ)
โโโ ํ
์คํธ ์ปค๋ฒ๋ฆฌ์ง ์์ด์ ํธ (๋จ์ ํ
์คํธ ํ์ธ)
โโโ ๊ฐ์ ์ ์ ์์ด์ ํธ (ํผ๋๋ฐฑ ์์ฑ)
โโโ ๋ณด๊ณ ์ ์๋ธ์์ด์ ํธ (๋ถ์ ๊ฒฐ๊ณผ ์ทจํฉ ๋ฐ ์์ฝ)
๋จ ํ๋์ ์ง์๋ก 30๊ฐ ๊ณผ์ ์ ๋ณ๋ ฌ ๋ถ์ยทํผ๋๋ฐฑยท๋ณด๊ณ ์ ์์ฑ์ด ์๊ฒฐ๋๋ค. ๊ต์ฌ ํ ๋ช ์ด ์ฒ๋ฆฌํ๊ธฐ ์ด๋ ค์ด ๊ท๋ชจ์ ๊ฐ์ธํ ํผ๋๋ฐฑ์ด ์์ด์ ํธ ๊ตฌ์กฐ๋ก ๊ฐ๋ฅํด์ง๋ค.
์ฝํ ์ธ ์ ์ ์๋ํ:
- ๋ฉ์ธ ์์ด์ ํธ๊ฐ ์ฃผ์ ์ ์ ์๋ธ์์ด์ ํธยท๋ฆฌ์์น ์๋ธ์์ด์ ํธยท๊ธ์ฐ๊ธฐ ์๋ธ์์ด์ ํธ๋ฅผ ์์ฐจ์ ์ผ๋ก ์งํ
- ๊ฐ ๋จ๊ณ์ ๊ฒฐ๊ณผ๋ฌผ์ด ๋ค์ ์์ด์ ํธ์ ์ปจํ ์คํธ๋ก ์ด์ด์ง
- ์ต์ข ๊ฒฐ๊ณผ๋ฌผ๊น์ง ์ฌ๋์ ๊ฐ์ ์์ด ์งํ ๊ฐ๋ฅ
๋ง์น๋ฉฐ
Claude Code 6์ ์ ๋ฐ์ดํธ๊ฐ ๋งํ๋ ๊ฒ์ ๋ช ํํ๋ค. AI ๋๊ตฌ๊ฐ ๋จ์ผ ์ด์์คํดํธ์ ์๋๋ฅผ ๋์ด ์์ด์ ํธ ์กฐ์ง์ ์๋๋ก ๋์ด๊ฐ๊ณ ์๋ค.
์ค์ฒฉ ์๋ธ์์ด์ ํธ๋ ๋ณต์กํ ์์ ์ ๋ถ์ ํ๋ฅผ, rate limit 2๋ฐฐ๋ ์ค์ผ์ผ์ ์ ํ์คํ๋ฅผ, ํ๊ดด์ ๋ช ๋ น ์ฐจ๋จ์ ์๋ํ์ ์ฑ ์์ ์ด์ผ๊ธฐํ๋ค. ์ด ์ธ ๊ฐ์ง๊ฐ ๊ฐ์ ์ ๋ฐ์ดํธ์ ํจ๊ป ๋ค์ด์๋ค๋ ๊ฒ์ด ์ฐ์ฐ์ด ์๋ ๊ฒ์ด๋ค.
"์ฌ๋ฌ๋ถ์ ์ํฌํ๋ก์ฐ์์ ์ค์ฒฉ ์๋ธ์์ด์ ํธ๊ฐ ๊ฐ์ฅ ์ ์ฉํ๊ฒ ์ฐ์ผ ๊ฒ ๊ฐ์ ์๋๋ฆฌ์ค๋ ์ด๋ค ๊ฑด๊ฐ์?" ๋๊ธ๋ก ๊ณต์ ํด ์ฃผ์ธ์!
๊ด๋ จ ๊ธ ๋ ์ฝ๊ธฐ
- Claude Code 3์ ๋์ ๋ฐ์ดํธ: ์์ฑยท๋ฃจํยทํ๋ฉด์ ์ด๊น์ง
- NotebookLM 6์ ๋์ ๋ฐ์ดํธ: Gemini 3.5ยท์ฝ๋ ์คํยท์์ด์ ํฑ ๋ฆฌ์์น
Source: