Anthropic의 Claude Code와 더 광범위한 Claude 제품군은 이제 개발자에게 전례 없는 제어권을 제공합니다. 얼마 요 모델은 보고 얼마나 깊이 이유가 있습니다. 최근 제품 업데이트(특히 Sonnet 4의 1만 토큰 컨텍스트 창과 Claude의 확장된 "생각" 컨트롤)는 컨텍스트 관리를 더욱 강력하고 중요하게 만듭니다. 단일 세션에서 전체 저장소를 처리할 수 있지만, 프롬프트, 파일 및 세션 상태를 의도적으로 구조화해야 합니다. 이 문서에서는 Claude Code의 컨텍스트를 안정적으로 관리하는 방법을 설명합니다. 명령 및 사용법, 생각 예산 제어, CLAUDE.md 패턴, 하위 에이전트 워크플로, 고급 사용자 팁, 문제 해결, 복사하여 붙여넣을 수 있는 구체적인 코드 예제 등이 포함됩니다.
클로드 코드?
클로드 코드는 Anthropic의 에이전트 코딩 CLI — 개발 환경을 Claude 모델에 연결하여 어시스턴트가 터미널에서 저장소를 읽고, 명령을 실행하고, 파일을 편집하고, 테스트를 실행하고, 커밋을 생성하고, 여러 단계의 워크플로를 실행할 수 있도록 지원하는 터미널 기반 도구입니다. AI가 셸에서 "살아" 코드베이스에서 작업할 수 있도록 설계되었으며, 저장소 스캐닝, 슬래시 명령, 하위 에이전트(격리된 컨텍스트를 가진 특수 어시스턴트), 외부 도구와의 모델 컨텍스트 프로토콜(MCP) 통합 등의 기능을 제공합니다.
왜 관리해야 하나요? 문맥 클로드 코드?
맥락은 관련성 + 비용 + 안전성과 직결되기 때문입니다. 관리하지 않으면 오랜 역사가 다음과 같은 결과를 초래합니다.
- 토큰 사용량이 많음(비용이 많이 들고 응답 속도가 느림).
- 컨텍스트 드리프트(오래된/관련 없는 정보로 인해 출력이 혼란스러워짐).
- 정보 유출(세션에 비밀이나 중요한 로그가 갇힘).
맥락을 관리하면 결과물의 정확성, 예측 가능성, 그리고 비용 절감이 유지됩니다.
클로드 코드는 프로젝트 맥락을 어떻게 구성하고 보존합니까?
Claude Code는 저장소, 도구 및 구성을 일류 컨텍스트 소스로 처리하는 에이전트 기반 CLI입니다. 프로젝트 파일을 읽고, CLAUDE.md로컬 도구 및 구성된 MCP 서버도 지원합니다. 또한 각각 자체 컨텍스트 창을 갖는 하위 에이전트도 지원하므로 주요 대화가 지저분해지는 것을 방지하는 데 도움이 됩니다. 이를 통해 주요 전략을 전문 에이전트 메모리(예: 테스트 러너, 코드 검토자)와 분리할 수 있습니다.
Claude Code는 어떻게 리포 컨텍스트와 도우미 파일을 수집하나요?
- 작업 디렉토리와 추가한 모든 디렉토리를 스캔합니다.
--add-dir). - 그것은 찾습니다
.claude/하위 폴더(명령, 에이전트) 및CLAUDE.md. - 외부 도구 액세스를 위해 MCP(Model Context Protocol) 서버를 연결할 수 있으며, Claude Code는 해당 도구를 자체 도구 세트로 상속할 수 있습니다.
Claude 코드에서 컨텍스트를 관리하기 위해 어떤 방법을 사용할 수 있나요?
- 컨텍스트에 맞는 기본 CLI 명령을 숙지하세요. 재사용 가능한 프롬프트는 .claude/commands/에 슬래시 명령으로 저장하여 긴 프롬프트를 반복해서 붙여넣는 것을 방지하세요.
- CLAUDE.md 파일을 적절하게 설계하세요. CLAUDE.md를 저장소 루트에 추가하여 목표, 허용 도구, 스타일, 에스컬레이션 규칙 및 유용한 슬래시 명령을 정의하세요. (Claude Code는 이를 자동으로 읽고 권위 있는 지침으로 사용합니다.)
- 작업 분리를 위해 하위 에이전트를 사용하세요. 각 하위 에이전트는 자체 컨텍스트 창과 도구 권한을 가지므로 메인 세션이 폴링되지 않습니다. 하위 에이전트는 .claude/agents/에 저장하고 버전 관리가 가능합니다.
기본 컨텍스트 관리 명령은 무엇입니까?
다음은 Claude Code에서 대화형 상태를 관리하는 데 가장 자주 사용되는 명령입니다. 동작, 사용 예, 권장 시나리오, 관련 CLI 플래그에 대한 정보를 제공합니다.
/clear — “새로운 시작”
그것은 무엇을 : 세션에서 현재 대화 기록을 삭제하여 이후 프롬프트가 깨끗한 상태에서 시작되도록 합니다. REPL 세션은 계속되지만, 주고받은 메시지는 모델의 컨텍스트에서 제거됩니다. (프로젝트 파일 및 CLAUDE.md (Claude Code에서는 계속 접근 가능합니다.)
언제 사용 하는가?
- 기능이나 티켓 작업을 마친 후 관련 없는 작업을 위해 깔끔한 세션을 원할 때.
- 세션에서 탐색적 전환이 많이 누적되어 답변이 저하되는 경우.
- 이전 대화 상태가 유출되는 것을 방지하기 위해 다른 사용자/에이전트에게 세션을 넘기기 전에.
용법
# in the interactive REPL
/clear
참고사항 및 팁
/clear해당 세션의 대화 기록에 파괴적인 영향을 미칩니다./resume/--continue디스크에 저장된 이전 세션으로 돌아가려는 경우.
/compact — “요약하고 요약하다”
그것은 무엇을 : 현재 대화를 핵심 사실과 결정 사항을 보존하는 짧은 요약으로 압축한 다음, 장황한 과거 기록을 해당 요약으로 대체하여 중요한 맥락을 잃지 않고 세션을 계속 진행할 수 있도록 합니다. 이를 통해 토큰 사용량을 줄이는 동시에 연속성을 유지합니다.
언제 사용 하는가?
- 스레드의 중요한 상태를 유지하면서 토큰 공간을 줄이려는 경우.
- 그렇지 않으면 컨텍스트 창을 한계까지 밀어붙일 수 있는 긴 새 작업이 필요합니다.
- 중요한 결정을 기억하는 동시에 간결한 세션 "기억"을 원할 때.
용법
# in the interactive REPL
/compact
# or with an instruction to guide the summary
/compact Summarize decisions, open TODOs, and config changes only
참고사항 및 팁
auto-compact,microcompact일부 빌드 또는 설정에서 대화 길이가 제한에 도달하면 , 및 기타 지능형 압축 동작이 자동으로 실행될 수 있습니다. 이러한 기능은 출시 중이며 설치 환경이나 호스팅 환경에 적용될 수 있습니다. (커뮤니티 및 변경 로그에서 마이크로 압축 및 자동 압축 동작에 대한 내용을 확인할 수 있습니다.)
--continue, --resume및 세션 제어(CLI 수준)
그들이 무엇을 할: CLI에서 세션 지속성과 선택을 제어합니다.
claude --continue(또는claude -c) — 현재 프로젝트 디렉토리에서 가장 최근의 대화를 다시 열고 계속합니다.claude --resume(또는claude -r <session-id>) — 대화형 선택기를 표시하거나 ID로 특정 세션을 다시 시작할 수 있습니다. 여러 세션을 저장한 후 하나를 선택하여 계속 진행하고 싶을 때 유용합니다.
사용 예
# continue the most recent session
claude --continue
# open an interactive session picker
claude --resume
# resume by id (non-interactive)
claude --resume 550e8400-e29b-41d4-a716-446655440000
컨텍스트에 중요한 대화형 모드 단축키(터미널 UX)
Ctrl+L— 터미널 화면을 지웁니다(시각적), 그러나 유지 대화 기록. 사용/clear실제로 역사를 재설정하는 것입니다.Ctrl+D— 세션을 종료합니다(EOF).Ctrl+C— 현재 생성을 취소합니다.
이는 편의성 제어입니다. 명시적으로 실행하지 않는 한 터미널 동작에만 영향을 미칩니다./clearor--continue/--resume.
기타 컨텍스트 관련 컨트롤 및 플래그
--add-dir <path>— Claude가 읽을 수 있는 추가 디렉토리를 포함합니다(Claude가 액세스할 수 있는 범위를 지정하고 불필요한 파일 읽기를 줄이는 데 유용함).--allowedTools— Claude가 반복적으로 권한을 묻지 않고도 도구를 실행할 수 있도록 도구를 미리 허용합니다(도구 권한 대화 상자를 앞뒤로 오가며 시끄럽게 묻는 것을 줄입니다).- 슬래시 명령(
/.claude/commands/(또는 MCP 제공) — 자주 사용되는 토큰 효율적인 프롬프트를 저장합니다. 긴 프롬프트를 반복해서 붙여넣는 것보다 슬래시 명령을 호출하는 것이 더 저렴합니다.
프로젝트 컨텍스트를 제어하려면 CLAUDE.md 파일을 어떻게 디자인해야 합니까?
CLAUDE.md란 무엇이고 왜 중요한가요?
CLAUDE.md Claude Code가 저장소에서 시작할 때 자동으로 읽는 사전 프로젝트 수준 프롬프트입니다. 프로젝트에 대한 짧고 실행 가능하며 안정적인 정보(명사, 아키텍처, 표준)를 입력하는 데 사용합니다. 모델이 CLAUDE.md를 프롬프트에 통합하기 때문에, 잘 작성된 파일은 동일한 정보를 반복해서 붙여넣을 필요성을 줄이고 귀중한 토큰 예산을 절약합니다.
CLAUDE.md: 실용적인 템플릿(추천)
다음 규칙을 준수하세요. 짧게(가능하면 100~200줄), 계층적으로(전역 → 프로젝트 → 하위 디렉토리 재정의), 기계가 읽을 수 있는 섹션을 작성하세요.
# CLAUDE.md — top of repository
Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)
# Conventions
- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)
# What I'm asking Claude to do
- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.
배송 시 요청 사항:
- 가치가 높은 항목(API, 중요 파일, 인프라 명령, 테스트 명령)을 먼저 처리하세요.
- 별도로 사용하세요
CLAUDE.md각 모듈에 서로 다른 규칙이 있는 경우 하위 디렉토리의 파일을 Claude가 결합하고 더 구체적인 파일을 우선순위로 지정합니다.
컨텍스트를 관리하고 작업을 병렬화하기 위해 워크플로와 하위 에이전트를 어떻게 조립합니까?
하위 대리인이란 무엇입니까?
하위 에이전트는 주요 에이전트가 개별 작업을 하위 에이전트에게 위임하는 클로드 코드 패턴입니다(예: frontend-agent, backend-agent, qa-agent) 그러면 주 에이전트가 각자의 출력을 조정합니다. 하위 에이전트를 사용하면 모든 작업을 단일 채팅에 몰아넣지 않고도 시스템의 여러 부분을 병렬로 작업할 수 있습니다.
샘플 워크플로: 기능 구현(병렬 에이전트)
main-agentCLAUDE.md를 읽고 계획을 만듭니다.frontend-agent(서브 에이전트)는 UI 계약, 스토리북, 특정 파일 등 집중된 맥락을 얻습니다.backend-agent(하위 에이전트)는 DB 스키마, API 계약을 가져오고 엔드포인트를 구현합니다.qa-agent테스트를 실행하고 실패한 테스트를 다시 작성합니다.main-agent.main-agentCLAUDE.md의 커밋, 병합 요청 및 업데이트를 조정합니다.
CLI 패턴:
# start main session
claude --session main
# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)
claude --session frontend --cwd frontend/
팁: 범위 지정 만들기 CLAUDE.md 하위 디렉토리 아래의 파일(frontend/CLAUDE.md, backend/CLAUDE.md) 따라서 각 하위 에이전트는 필요한 최소한의 컨텍스트로 시작합니다.
하위 대리인 예시: .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---
You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.
전문가가 맥락을 건강하게 유지하고 비용을 절감하기 위해 할 수 있는 팁은 무엇인가요?
1) CLAUDE.md를 간소하고 계층적으로 유지하세요.
거대하고 모놀리식인 CLAUDE.md 파일은 사용하지 마세요. 개발자의 환경 설정에는 하나의 글로벌 파일을 사용하고, 영역별 세부 사항에는 작은 모듈 파일을 사용하세요. 이전 템플릿을 참조하세요.
2) 동사에는 슬래시 명령어를 사용하고 명사에는 CLAUDE.md를 사용합니다.
CLAUDE.md를 장소로 만드십시오 사실 (존재하는 파일, 아키텍처) 및 슬래시 명령은 해당 위치를 나타냅니다. 절차 (테스트 생성, 리팩토링). 이렇게 하면 매 세션마다 절차적 논리를 다시 전송하는 것을 방지할 수 있습니다. 커뮤니티에서는 이러한 분리를 강조합니다.
3) 디버깅 도구로서의 상세 모드 + 계획 모드
클로드가 예상치 못한 동작을 하는 경우, 자세한 내용을 실행하여 정확한 상황을 확인하고, 계획 모드를 사용하여 편집 전에 승인할 수 있는 명시적 계획을 강제로 적용합니다.
4) 예산을 신중하게 생각하세요
기본/최소 수준의 사고 토큰으로 시작하고, 작업에 여러 단계의 추론이 필요한 경우(복잡한 리팩터링, 형식적 검증 등)에만 토큰을 늘리세요. 일상적인 편집에는 예산을 낮추세요.
5) 계측기 출력 및 커밋
테스트를 자동으로 실행하고 해당 출력을 세션에 첨부하는 후크가 있습니다(bash 모드) ! 셸 명령을 실행하고 출력을 컨텍스트로 포함합니다.) 커밋 후크를 사용하여 메시지를 포함한 명확한 원자적 커밋을 만듭니다.
컨텍스트가 "끊어지거나" 클로드가 지침을 잊어버린 경우 문제를 어떻게 해결해야 합니까?
일반적인 증상 및 해결 방법
- 징후: 클로드는 CLAUDE.md 또는 이전 지침을 무시합니다.
- 수정 : 파일이 세션의 현재 작업 디렉토리에 있는지 확인하세요. 보다 구체적인 하위 디렉토리인 CLAUDE.md가 이를 재정의하는지 확인하세요. 자세한 모드를 사용하여 현재 프롬프트를 확인하세요.
- 징후: 세션이 길어지면 성능이 저하됩니다(모델이 초기 부분을 "잊어버림").
- 수정 : 세션을 압축하세요. 안정적인 사실들을 CLAUDE.md로 추출하거나, 대화의 일부를 스냅샷으로 파일로 저장하여 반복하는 대신 참조하세요. 또한 짧은 세션을 다시 시작하고 간결한 맥락만 전달하는 것도 고려하세요.
- 징후: 확장된 사고는 너무 오랜 시간이 걸리거나 시간 초과됩니다.
- 수정 : thinking_budget을 낮추거나, 작업을 더 작은 하위 문제로 나누거나, 매우 큰 예산이 필요한 경우 오프라인 일괄 분석을 실행하세요. Anthropic은 시간 초과를 방지하기 위해 최적의 thinking_budget이 약 32 토큰을 초과할 때 일괄 처리를 권장합니다.
결론
Claude Code에서 컨텍스트를 관리하는 것은 이제 모델 선택, 하위 에이전트 디자인 등 다차원적인 문제입니다. CLAUDE.md 규율, 예산 계획, 툴링 아키텍처는 모두 상호 작용합니다. 12시간을 투자하여 명확한 계획을 세우는 것부터 시작하세요. 3개의 집중 하위 에이전트를 스캐폴딩하고 토큰과 사고 예산을 위한 사용 계측을 추가하면 안정성, 비용 예측성, 팀 생산성이 즉각적으로 향상되는 것을 볼 수 있습니다.CLAUDE.md2
CometAPI를 통해 Claude 코드 사용
CometAPI는 OpenAI의 GPT 시리즈, Google의 Gemini, Anthropic의 Claude, Midjourney, Suno 등 주요 공급업체의 500개 이상의 AI 모델을 단일 개발자 친화적인 인터페이스로 통합하는 통합 API 플랫폼입니다. CometAPI는 일관된 인증, 요청 형식 지정 및 응답 처리를 제공하여 애플리케이션에 AI 기능을 통합하는 과정을 획기적으로 간소화합니다. 챗봇, 이미지 생성기, 음악 작곡가 또는 데이터 기반 분석 파이프라인 등 어떤 제품을 구축하든 CometAPI를 사용하면 AI 생태계 전반의 최신 혁신 기술을 활용하면서 반복 작업을 더 빠르게 수행하고 비용을 관리하며 공급업체에 구애받지 않을 수 있습니다.
CometAPI가 이제 강력한 Claude Code를 완벽하게 지원하게 되어 기쁩니다. Claude Code에서 Comet API 모델을 사용하려면 Claude Code를 설치하고 얻은 Comet API 키와 기본 주소로 인증하기만 하면 됩니다.
CometAPI를 통해 클로드 코드를 사용해야 하는 이유는 무엇입니까?
인공지능의 주요 기능: 개발자를 위해 특별히 구축된 모델을 사용하여 코드를 쉽게 생성, 디버깅 및 최적화합니다.
- 유연한 모델 선택: 포괄적인 모델 범위를 통해 보다 원활하게 개발할 수 있습니다.
- 원활한 통합: API는 항상 사용 가능합니다. Claude Code를 기존 워크플로에 단 몇 분 만에 통합하세요.
- **CometAPI를 통해 Claude Code를 사용하면 더 많은 비용을 절감할 수 있습니다.**CometAPI에서 제공하는 API는 공식 가격 대비 20% 할인된 가격으로 제공되며, 공식 API를 통해 최신 모델로 업데이트됩니다. 최신 모델은 다음과 같습니다. 클로드 오푸스 4.1.
Claude Code를 사용할 준비가 되셨나요? API 가이드 자세한 지침은
