leo/claude-code
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
152d2dde95
claude-code/docs/ko/appendix/glossary.md
JuYoung Jeong 3358348196 docs: add comprehensive Korean source code analysis (19 documents, 6,926 lines) 
Add complete Korean-language technical documentation analyzing Claude Code CLI
internals, organized in a leveled guide structure (Level 1-3 + Appendix).

Level 1 (입문): architecture overview, request lifecycle, key concepts
Level 2 (시스템): QueryEngine, Tool system, Command system, Permission system,
  Agent coordinator, UI/Ink components
Level 3 (심화): MCP/LSP integration, IDE bridge, Plugin/Skill system,
  Context compression, OAuth/Auth, Telemetry
Appendix: Korean-English glossary, file map, design patterns

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-31 19:39:03 +09:00

161 lines
11 KiB
Markdown
Raw Blame History

# 한영 용어 대조표
> Claude Code 소스코드에서 사용되는 주요 기술 용어의 한국어 번역, 영문 원어, 정의, 소스코드 위치를 정리한 참조 테이블이다.
---
## 핵심 아키텍처
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 도구 | Tool | LLM이 호출할 수 있는 기능 단위. `name`, `description`, `inputSchema`, `call()` 메서드를 가진다 | `src/Tool.ts` |
| 도구 등록소 | Tool Registry | 활성화된 도구 집합을 중앙에서 관리하는 패턴. `getTools()`가 도구 배열을 반환 | `src/tools.ts` |
| 에이전트 | Agent | 독립적인 LLM 루프를 실행하는 서브프로세스. AgentTool을 통해 생성 | `src/tools/AgentTool/` |
| 서브에이전트 | Sub-agent | 코디네이터 또는 부모 에이전트로부터 위임받은 작업을 독립 실행하는 에이전트 | `src/tools/AgentTool/AgentTool.ts` |
| 질의 엔진 | QueryEngine | LLM API 호출, 도구 실행, 대화 루프를 조율하는 중앙 엔진 | `src/QueryEngine.ts` |
| 쿼리 | Query | 단일 LLM API 호출 + 응답 처리 사이클 | `src/query.ts` |
| 에이전트 루프 | Agent Loop | LLM 응답 → 도구 실행 → 결과 피드백 → LLM 응답을 반복하는 제어 흐름 | `src/QueryEngine.ts` |
| 코디네이터 모드 | Coordinator Mode | 여러 서브에이전트를 조율하는 상위 에이전트 실행 모드 | `src/coordinator/coordinatorMode.ts` |
| 팀메이트 | Teammate | 스웜(swarm) 아키텍처에서 협력하는 에이전트 인스턴스 | `src/utils/teammate.ts` |
---
## 권한 시스템
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 권한 모드 | Permission Mode | 도구 실행 시 사용자 승인 요구 수준. `default`, `acceptEdits`, `bypassPermissions`, `plan`, `dontAsk`, `auto` | `src/types/permissions.ts` |
| 권한 결과 | PermissionResult | 도구 실행 전 권한 검사 결과. `allow`, `deny`, `ask` | `src/types/permissions.ts` |
| 권한 인터셉터 | Permission Interceptor | 도구 실행 전 승인 여부를 결정하는 게이트 로직 | `src/hooks/useCanUseTool.ts` |
| 바이패스 권한 | Bypass Permissions | 모든 도구 실행을 자동 승인하는 최고 신뢰 모드 | `src/types/permissions.ts` |
| 계획 모드 | Plan Mode | 파일 수정 없이 계획만 수립하는 읽기 전용 권한 모드 | `src/tools/EnterPlanModeTool/` |
| 정책 제한 | Policy Limits | 관리자 또는 MDM을 통해 부과되는 외부 제약 | `src/services/policyLimits/` |
---
## UI/렌더링
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 인크 컴포넌트 | Ink Component | React 기반 터미널 UI 컴포넌트. Ink 라이브러리의 커스텀 구현 | `src/ink/` |
| 스트리밍 | Streaming | LLM 응답을 토큰 단위로 실시간 수신·렌더링하는 기법 (SSE 기반) | `src/services/api/claude.ts` |
| SSE | Server-Sent Events | LLM API가 스트리밍 응답을 전송하는 HTTP 프로토콜 | `src/services/api/` |
| REPL | Read-Eval-Print Loop | 대화형 입력-처리-출력 반복 루프. 인터랙티브 세션 진입점 | `src/replLauncher.tsx` |
| 오버레이 | Overlay | 메인 UI 위에 표시되는 모달 또는 프롬프트 레이어 | `src/context/overlayContext.tsx` |
---
## 명령어 시스템
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 슬래시 커맨드 | Slash Command | `/` 접두사로 시작하는 사용자 입력 명령어 | `src/commands.ts` |
| 스킬 | Skill | 슬래시 커맨드 형태로 등록되는 재사용 가능한 작업 템플릿 | `src/skills/` |
| 스킬 도구 | Skill Tool | 스킬을 LLM 도구로 노출하는 래퍼 | `src/tools/SkillTool/SkillTool.ts` |
| 빌트인 플러그인 | Bundled Plugin | 기본 내장된 플러그인. 동적 로딩 없이 번들에 포함 | `src/plugins/bundled/` |
| 플러그인 | Plugin | 기능을 확장하는 모듈 단위. 도구, 커맨드, 스킬을 제공 | `src/types/plugin.ts` |
---
## 컨텍스트 & 메모리
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 컨텍스트 윈도우 | Context Window | LLM이 한 번에 처리할 수 있는 최대 토큰 수 | `src/utils/context.ts` |
| 토큰 예산 | Token Budget | 단일 쿼리 또는 세션에서 사용 가능한 최대 토큰 할당량 | `src/utils/thinking.ts` |
| 컴팩트 | Compact | 긴 대화 히스토리를 요약하여 컨텍스트 윈도우를 확보하는 작업 | `src/QueryEngine.ts` |
| 메모리 프롬프트 | Memory Prompt | `CLAUDE.md` 등 파일에서 로드되는 지속적 지시사항 | `src/memdir/memdir.ts` |
| 세션 | Session | UUID로 식별되는 단일 대화 세션. 트랜스크립트 저장 단위 | `src/bootstrap/state.ts` |
| 트랜스크립트 | Transcript | 세션 내 모든 메시지와 도구 결과의 기록 | `src/utils/sessionStorage.ts` |
---
## 로딩 & 최적화
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 지연 로딩 | Lazy Loading | 모듈을 즉시 임포트하지 않고 필요 시점에 `require()`로 동적 로드하는 패턴 | `src/main.tsx:69-82` |
| 병렬 프리페치 | Parallel Prefetch | 독립적인 초기화 작업을 동시에 실행하는 스타트업 최적화 기법 | `src/main.tsx:16-20` |
| 데드 코드 제거 | Dead Code Elimination | `feature()` 플래그 기반으로 번들 타임에 미사용 코드를 제거하는 최적화 | `src/tools.ts:14-52` |
| 메모이제이션 | Memoization | 동일 인자에 대한 함수 결과를 캐시하여 재계산을 방지하는 기법 | `src/services/analytics/datadog.ts` |
---
## 외부 서비스 & 프로토콜
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| MCP | Model Context Protocol | 외부 서버가 도구와 리소스를 Claude에 제공하는 표준 프로토콜 | `src/services/mcp/` |
| LSP | Language Server Protocol | 코드 지능(정의 이동, 참조 검색 등)을 제공하는 표준 프로토콜 | `src/tools/LSPTool/` |
| OAuth | OAuth 2.0 | Claude.ai 계정 인증에 사용하는 표준 인증 위임 프로토콜 | `src/services/oauth/` |
| JWT | JSON Web Token | OAuth 인증 흐름에서 사용하는 토큰 포맷 | `src/utils/auth.ts` |
| gRPC | gRPC | 1P 이벤트 로깅 익스포터가 사용하는 원격 프로시저 호출 프로토콜 (HTTP/2 기반) | `src/services/analytics/firstPartyEventLoggingExporter.ts` |
| OpenTelemetry | OpenTelemetry | 1P 이벤트 로깅에 사용하는 벤더 중립적 관측성 프레임워크 | `src/services/analytics/firstPartyEventLogger.ts` |
---
## 보안 & 인증
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 키체인 | Keychain | macOS 보안 자격증명 저장소. OAuth 토큰과 API 키를 보관 | `src/utils/secureStorage/` |
| 키체인 프리페치 | Keychain Prefetch | 스타트업 레이턴시 감소를 위해 키체인 읽기를 병렬로 미리 실행 | `src/utils/secureStorage/keychainPrefetch.ts` |
| MDM | Mobile Device Management | 기업 환경에서 Claude Code 설정을 중앙 관리하는 시스템 | `src/utils/settings/mdm/` |
| 신뢰 다이얼로그 | Trust Dialog | 새 프로젝트 디렉토리에 대한 사용자 신뢰 확인 UI | `src/bootstrap/state.ts` |
---
## 피처 플래그 & A/B 테스트
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| GrowthBook | GrowthBook | 피처 플래그와 A/B 테스트를 관리하는 외부 서비스 | `src/services/analytics/growthbook.ts` |
| 피처 플래그 | Feature Flag | 런타임에서 기능을 켜고 끄는 제어 메커니즘 | `src/services/analytics/growthbook.ts` |
| 피처 게이트 | Feature Gate | GrowthBook의 불리언 피처 플래그. `checkStatsigFeatureGate_CACHED_MAY_BE_STALE()` | `src/services/analytics/growthbook.ts` |
| 동적 설정 | Dynamic Config | GrowthBook에서 런타임에 제공되는 구조화된 설정값 | `src/services/analytics/growthbook.ts` |
| 번들 피처 | Bundle Feature | 번들 타임에 평가되는 `feature()` 플래그 (Bun 번들러 전용) | `src/types/permissions.ts` |
---
## 런타임 & 빌드
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| Bun | Bun | Claude Code의 JavaScript 런타임 및 번들러 | `bun.lock`, `package.json` |
| `bun:bundle` | bun:bundle | Bun 번들러가 제공하는 특수 모듈. `feature()` 함수로 번들 타임 조건 분기 | `src/main.tsx:21` |
| Commander.js | Commander.js | CLI 인자 파싱에 사용하는 라이브러리 (`@commander-js/extra-typings`) | `src/main.tsx:22` |
| Zod | Zod | 스키마 검증 라이브러리. 도구 입력 스키마와 설정 파일 검증에 사용 | `src/Tool.ts` |
---
## 데이터 & 타입
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| DeepImmutable | DeepImmutable | 타입 레벨에서 중첩 객체까지 불변성을 강제하는 유틸리티 타입 | `src/utils/` |
| 마커 타입 | Marker Type | 실제 값을 담지 않고 개발자 의도를 타입 시스템에 문서화하는 `never` 기반 타입 | `src/services/analytics/index.ts:19` |
| PII 태깅 | PII Tagging | 개인 식별 정보를 `_PROTO_*` 키로 표시하여 특권 스토리지로만 라우팅하는 패턴 | `src/services/analytics/index.ts:27` |
---
## 브릿지 & 통합
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 브릿지 | Bridge | Claude Code와 외부 환경(Chrome, 원격 세션)을 연결하는 통신 레이어 | `src/bridge/` |
| 훅 | Hook | 특정 이벤트 시점에 실행되는 사용자 정의 스크립트 (Pre/PostToolUse 등) | `src/types/hooks.ts` |
| 워크트리 | Worktree | Git worktree를 활용한 병렬 개발 환경 관리 기능 | `src/tools/EnterWorktreeTool/` |
| 업스트림 프록시 | Upstream Proxy | 기업 네트워크에서 Claude API 요청을 중계하는 프록시 설정 | `src/upstreamproxy/` |
---
## 분석 & 모니터링
| 한국어 | English | 정의 | 소스코드 위치 |
|--------|---------|------|--------------|
| 분석 싱크 | Analytics Sink | 이벤트를 실제 백엔드로 전달하는 라우팅 레이어 | `src/services/analytics/sink.ts` |
| 이벤트 샘플링 | Event Sampling | 고빈도 이벤트의 일부만 기록하여 스토리지 비용을 절감하는 기법 | `src/services/analytics/firstPartyEventLogger.ts` |
| 사용자 버킷 | User Bucket | 사용자 ID 해시 기반 0~29 정수. 고유 사용자 수를 PII 없이 근사하는 데 사용 | `src/services/analytics/datadog.ts` |
| 킬스위치 | Killswitch | 런타임에서 특정 분석 싱크를 즉시 비활성화하는 메커니즘 | `src/services/analytics/sinkKillswitch.ts` |
| 텔레메트리 | Telemetry | 앱 동작에 관한 사용 데이터를 자동 수집·전송하는 시스템 전체 | `src/services/analytics/` |
Reference in New Issue View Git Blame Copy Permalink