번역 자료

[Claude Code 번역] Claude Code Troubleshooting (Claude Code Troubleshooting)

출처: https://docs.anthropic.com/en/docs/claude-code/troubleshooting개요Claude Code 설치 및 사용 중 자주 발생하는 문제에 대한 해결 방법을 안내합니다.일반적인 설치 문제Linux 권한 문제npm으로 Claude Code를 설치할 때, npm 글로벌 프리픽스가 사용자 쓰기 권한이 없는 경로(예: /usr, /usr/local)로 설정되어 있으면 권한 오류가 발생할 수 있습니다.권장 해결책: 사용자 쓰기 가능한 npm 프리픽스 설정가장 안전한 방법은 홈 디렉터리 내에 npm 글로벌 패키지 경로를 설정하는 것입니다.# 기존 글로벌 패키지 목록 저장npm list -g --depth=0 > ~/npm-global-packages.txt# 글로벌 패키지..

2025. 5. 28. 19:56
번역 자료

[Claude Code 번역] Claude Code Tutorials (Claude Code Tutorials)

출처: https://docs.anthropic.com/en/docs/claude-code/tutorials개요이 가이드는 Claude Code를 개발 워크플로우에 효과적으로 활용할 수 있는 실용적인 예제와 패턴을 제공합니다. 각 튜토리얼에는 단계별 설명, 예제 명령어, 베스트 프랙티스가 포함되어 있어 Claude Code를 최대한 활용할 수 있도록 돕습니다.목차이전 대화 이어서 작업하기새로운 코드베이스 이해하기버그 효율적으로 수정하기코드 리팩터링테스트 작업Pull Request 생성문서화 작업이미지 작업확장된 사고 활용프로젝트 메모리 설정Model Context Protocol(MCP) 설정유닉스 스타일 유틸리티로 Claude 사용커스텀 슬래시 명령어 만들기Git 워크트리로 병렬 세션 운영이전 대화 이..

2025. 5. 28. 19:55
번역 자료

[Claude Code 번역] Claude Code SDK (Claude Code SDK)

출처: https://docs.anthropic.com/en/docs/claude-code/sdk개요Claude Code SDK를 사용하면 Claude Code를 프로그래밍적으로 애플리케이션에 통합할 수 있습니다. SDK는 Claude Code를 서브프로세스로 실행할 수 있게 하여, Claude의 기능을 활용하는 AI 기반 코딩 어시스턴트 및 도구를 구축할 수 있습니다.현재 SDK는 커맨드라인 사용을 지원합니다. TypeScript 및 Python SDK는 곧 제공될 예정입니다.기본 SDK 사용법Claude Code SDK를 사용하면 애플리케이션에서 비대화(non-interactive) 모드로 Claude Code를 사용할 수 있습니다. 기본 예시는 다음과 같습니다:# 단일 프롬프트 실행 후 종료 (pr..

2025. 5. 28. 19:55
번역 자료

[Claude Code 번역] Claude Code GitHub Actions (Claude Code GitHub Actions)

출처: https://docs.anthropic.com/en/docs/claude-code/github-actions개요Claude Code GitHub Actions를 사용하면 자동화된 코드 리뷰, PR 관리, 이슈 분류 등 GitHub 워크플로우에 AI 기반 자동화를 통합할 수 있습니다.간단히 PR이나 이슈에서 @claude를 멘션하면 Claude가 코드를 분석하고, 풀 리퀘스트를 생성하며, 기능을 구현하고, 버그를 수정합니다. 이 모든 과정에서 프로젝트의 표준을 준수합니다.Claude Code GitHub Actions는 현재 베타 버전입니다. 기능과 사용성은 지속적으로 개선될 수 있습니다.Claude Code GitHub Actions는 Claude Code SDK 위에 구축되어 있어, SDK를 ..

2025. 5. 28. 19:54
번역 자료

[Claude Code 번역] Claude Code Bedrock, Vertex, 프록시 연동 가이드

출처: https://docs.anthropic.com/en/docs/claude-code/bedrock-vertex-proxies모델 구성(Model configuration)Claude Code는 기본적으로 다음 모델을 사용합니다:제공자기본 모델명Anthropic Consoleclaude-sonnet-4-20250514Claude Maxclaude-opus-4-20250514 또는 claude-sonnet-4-20250514 (Max 사용량에 따라)Amazon Bedrockclaude-3-7-sonnet-20250219Google Vertex AIclaude-sonnet-4-20250514우선순위: --model CLI 플래그 > ANTHROPIC_MODEL 환경 변수 > 사용자 설정 파일(~/.cl..

2025. 5. 28. 19:47
번역 자료

[Claude Code 번역] Claude Code 비용 관리

출처: https://docs.anthropic.com/en/docs/claude-code/costs개요Claude Code는 각 상호작용마다 토큰을 소비하며, 평균적으로 개발자 1인당 하루 약 $6, 90% 사용자는 하루 $12 미만의 비용이 발생합니다. 비용은 코드베이스 크기, 쿼리 복잡도, 파일 수, 대화 길이, compact 빈도 등에 따라 달라집니다.비용 추적 방법/cost 명령어로 현재 세션의 사용량 확인Anthropic Console 사용자:콘솔에서 과거 사용량 확인(관리자/청구 권한 필요)워크스페이스별 지출 한도 설정(관리자 권한 필요)Max 요금제 사용자: 사용량이 구독에 포함됨토큰 사용량 절감 팁대화 compact 활용context가 95% 이상 차면 자동 compact(기본값)/con..

2025. 5. 28. 19:46
번역 자료

[Claude Code 번역] Claude Code 사용량 모니터링(OpenTelemetry)

출처: https://docs.anthropic.com/en/docs/claude-code/monitoring-usage개요Claude Code는 OpenTelemetry(OTel) 메트릭을 지원하여 사용량 모니터링 및 관측이 가능합니다. OTel을 통해 시간 기반의 메트릭 데이터를 외부 모니터링 시스템으로 내보낼 수 있습니다. (현재 베타, 세부 내용은 변경될 수 있음)빠른 시작(Quick Start)환경 변수로 OpenTelemetry를 설정할 수 있습니다:# 1. 텔레메트리 활성화export CLAUDE_CODE_ENABLE_TELEMETRY=1# 2. Exporter 선택 (otlp, prometheus, console)export OTEL_METRICS_EXPORTER=otlp# 3. OTLP ..

2025. 5. 28. 19:46
번역 자료

[claude-code 번역] 팀 설정 (Team setup)

출처: https://docs.anthropic.com/en/docs/claude-code/teamClaude Code팀 설정Claude Code를 팀에 온보딩하는 방법, 사용자 관리, 보안, 모범 사례에 대해 알아보세요.사용자 관리Claude Code를 설정하려면 Anthropic 모델에 대한 접근 권한이 필요합니다. 팀의 경우 다음 세 가지 방법 중 하나로 Claude Code 접근을 설정할 수 있습니다:Anthropic API (Anthropic Console을 통해)Amazon BedrockGoogle Vertex AIAnthropic API를 통한 팀 접근 설정 방법:기존 Anthropic Console 계정을 사용하거나 새로 생성하세요.아래 방법 중 하나로 사용자를 추가할 수 있습니다:Cons..

2025. 5. 28. 19:45
번역 자료

[claude-code 번역] 권한 및 보안 관리 (Manage permissions and security)

출처: https://docs.anthropic.com/en/docs/claude-code/securityClaude Code권한 및 보안 관리Claude Code의 권한 시스템, 도구 접근, 보안 보호장치에 대해 알아보세요.Claude Code는 강력함과 안전성을 균형 있게 제공하기 위해 계층적 권한 시스템을 사용합니다:도구 유형예시승인 필요 여부"예, 다시 묻지 않기" 동작읽기 전용파일 읽기, LS, Grep아니오해당 없음Bash 명령셸 명령 실행예프로젝트 디렉터리 및 명령어별로 영구 승인파일 수정파일 편집/쓰기예세션 종료 시까지 승인 유지Claude가 사용할 수 있는 도구Claude Code는 코드베이스를 이해하고 수정하는 데 도움이 되는 다양한 강력한 도구에 접근할 수 있습니다:도구설명권한 필요 ..

2025. 5. 28. 19:44
번역 자료

[claude-code 번역] Claude Code 설정 (Claude Code settings)

출처: https://docs.anthropic.com/en/docs/claude-code/settingsClaude CodeClaude Code 설정글로벌 및 프로젝트별 설정, 테마, 환경 변수 등 Claude Code의 다양한 설정 방법을 알아보세요.Claude Code는 다양한 설정 옵션을 제공하여 사용자의 필요에 맞게 동작을 조정할 수 있습니다. 터미널에서 claude config를 실행하거나, 대화형 REPL에서는 /config 명령을 사용해 설정할 수 있습니다.설정 계층 구조새로운 settings.json 파일은 Claude Code의 계층적 설정을 위한 공식 메커니즘입니다:사용자 설정: ~/.claude/settings.json에 저장되며 모든 프로젝트에 적용됩니다.프로젝트 설정: 프로젝트 ..

2025. 5. 28. 19:44
번역 자료

[claude-code 번역] Claude의 메모리 관리 (Manage Claude's memory)

출처: https://docs.anthropic.com/en/docs/claude-code/memoryClaude CodeClaude의 메모리 관리Claude Code의 세션 간 메모리 위치와 관리 방법, 그리고 모범 사례에 대해 알아보세요.Claude Code는 스타일 가이드라인, 자주 사용하는 명령어 등 사용자의 선호를 세션 간에 기억할 수 있습니다.메모리 유형 결정하기Claude Code는 각기 다른 목적을 가진 세 가지 메모리 위치를 제공합니다:메모리 유형위치목적사용 예시프로젝트 메모리./CLAUDE.md프로젝트 팀이 공유하는 지침프로젝트 아키텍처, 코딩 표준, 공통 워크플로우사용자 메모리~/.claude/CLAUDE.md모든 프로젝트에 적용되는 개인 선호코드 스타일 선호, 개인 도구 단축키프로젝..

2025. 5. 28. 19:43
번역 자료

[claude-code 번역] IDE 통합 (IDE integrations)

출처: https://docs.anthropic.com/en/docs/claude-code/ide-integrationsClaude CodeIDE 통합Claude Code를 선호하는 개발 환경(IDE)과 통합하세요Claude Code는 인기 있는 통합 개발 환경(IDE)과 원활하게 통합되어 코딩 워크플로우를 향상시킵니다. 이 통합을 통해 선호하는 개발 환경 내에서 Claude의 기능을 직접 활용할 수 있습니다.지원되는 IDEClaude Code는 현재 두 가지 주요 IDE 계열을 지원합니다:Visual Studio Code (Cursor, Windsurf 등 인기 포크 포함)JetBrains IDE (PyCharm, WebStorm, IntelliJ, GoLand 등)주요 기능빠른 실행: Cmd+Esc(..

2025. 5. 28. 19:42
번역 자료

[Claude Code 번역] CLI 사용법 및 제어 (CLI usage and controls)

원문: CLI usage and controlsClaude Code를 커맨드라인에서 사용하는 방법(CLI 명령어, 플래그, 슬래시 명령어 등)을 안내합니다.시작하기Claude Code는 두 가지 주요 상호작용 방식을 제공합니다:대화형 모드: claude를 실행하여 REPL 세션 시작원샷 모드: claude -p "query"로 빠른 명령 실행# 대화형 모드 시작claude# 초기 쿼리와 함께 시작claude "explain this project"# 단일 명령 실행 후 종료claude -p "what does this function do?"# 파이프된 내용 처리cat logs.txt | claude -p "analyze these errors"CLI 명령어명령어설명예시claude대화형 REPL 시작cl..

2025. 5. 28. 19:42
번역 자료

[Claude Code 번역] 핵심 작업 및 워크플로우 (Core tasks and workflows)

원문: Core tasks and workflowsClaude Code의 강력한 기능을 활용하여 개발 워크플로우에서 편집, 검색, 테스트, 자동화를 수행할 수 있습니다.Claude Code는 터미널에서 직접 동작하며, 프로젝트 컨텍스트를 이해하고 실제 작업을 수행합니다. 별도로 파일을 컨텍스트에 추가할 필요 없이 Claude가 코드베이스를 자동으로 탐색합니다.익숙하지 않은 코드 이해하기> what does the payment processing system do?> find where user permissions are checked> explain how the caching layer worksGit 작업 자동화> commit my changes> create a pr> which commit a..

2025. 5. 28. 19:41
번역 자료

[Claude Code 번역] Claude Code 시작하기 (Getting started with Claude Code)

원문: Getting started with Claude CodeClaude Code 설치, 인증, 사용 시작 방법을 안내합니다.시스템 요구 사항 확인운영체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 Windows(WSL을 통해)하드웨어: 최소 4GB RAM소프트웨어:Node.js 18+ git 2.23+ (선택 사항)PR 워크플로우를 위한 GitHub 또는 GitLab CLI (선택 사항)향상된 파일 검색을 위한 ripgrep(rg) (선택 사항)네트워크: 인증 및 AI 처리를 위해 인터넷 연결 필요지역: 지원되는 국가에서만 사용 가능WSL 설치 문제 해결현재 Claude Code는 Windows에서 직접 실행되지 않으며, WSL이 필요합니다. WSL에서 문제가 발..

2025. 5. 28. 19:40
반응형