Claude 공식 릴리스 노트의 새 항목을 AI가 분석·정리한 글입니다. 정확한 내용은 하단 원문에서 확인해 주세요.
🤖 AI 분석 (Claude)
Claude Code 2.1.248은 보안, 성능, 진단 기능을 개선한 업데이트입니다. `--restricted` 플래그로 민감한 환경에서 명령 실행 도구와 WebFetch를 제한할 수 있고, 에이전트별 프롬프트 캐시 TTL을 설정하여 성능을 최적화할 수 있습니다.
설정 로드 실패 시 `/doctor`와 `/status`로 원인을 진단할 수 있고, GitHub CLI 토큰 검증 및 세션 간 메시징이 추가되었으며, 장시간 세션에서 발생하던 프롬프트 캐시 미스 버그가 수정되었습니다.
왜 중요한가
`--restricted` 플래그는 보안이 중요한 환경에서 Claude Code의 실행 권한을 제한할 수 있게 해줍니다. 에이전트별 캐시 TTL 설정과 캐시 미스 버그 수정으로 긴 세션에서의 안정성과 응답성이 향상되며, 진단 기능은 설정 문제를 빠르게 파악하고 해결하는 데 도움이 됩니다.
실제로 써보려면
`--restricted` 또는 `CLAUDE_CODE_RESTRICTED=1` 환경변수로 Claude Code를 실행하거나, 에이전트 frontmatter에 `experimental.cacheTtl` 값("5m" 또는 "1h")을 추가할 수 있습니다. `claude self-hosted-runner --client-label <label>` 명령으로 자체 호스트 러너의 클라이언트 레이블을 커스터마이징하거나, 설정 문제 발생 시 `/doctor` 또는 `/status` 명령으로 진단 정보를 확인할 수 있습니다.
⚠️ AI가 원문을 바탕으로 생성한 분석입니다. 사실 확인은 아래 원문에서 해 주세요.
변경 내용 (원문)
- Added `--restricted` (or `CLAUDE_CODE_RESTRICTED=1`): removes the built-in tools that run commands or code and `WebFetch` (unless named in `--tools`), keeps file tools inside the working directory, refuses `bypassPermissions`, and ignores user, project and local settings files - Added `experimental.cacheTtl` (`"5m"` or `"1h"`) to agent frontmatter: a per-agent prompt cache TTL used when no subagent TTL setting is configured - Added `claude self-hosted-runner --client-label <label>` (or `SELF_HOSTED_RUNNER_CLIENT_LABEL`) to override the label the runner registers with (default: hostname) - Added server-managed settings diagnostics: a startup warning when the settings fail to load, and a `/doctor` and `/status` line explaining a load failure or why they weren't fetched (Bedrock/Vertex/third-party provider, custom `ANTHROPIC_BASE_URL`) - Added a warning in `/web-setup` when the GitHub CLI token lacks the `workflow` scope, since pushes to very large repositories can be rejected without it - Added `/usage-credits` for Enterprise organizations billed through AWS Marketplace, self-serve Enterprise, and Enterprise trials, so members can request a higher usage limit from their admin - Added cross-session messaging (`SendMessage` / `ListAgents`) between sessions on the same machine on Bedrock, Vertex, and Foundry, and when telemetry is disabled - Fixed a prompt-cache miss (and lost extended-thinking context) roughly once an hour in long sessions, caused by tool definitions being re-r
출처: Claude Code 변경로그 (원문 보기)