Claude Code 데일리 브리핑 - 2026-09-11

최신 릴리스 요약

9/9 v2.1.267에 이어 9/10에 v2.1.268이 나왔습니다. 이번 릴리스는 신규 기능보다 수정에 무게가 실려 있는데, 특히 v2.1.265부터 서드파티 엔드포인트를 아예 못 쓰게 만들던 회귀와 권한 규칙·시크릿 노출 관련 수정이 여럿 포함됐습니다.

전체 릴리스 노트

주요 신규 기능 & 실전 활용

WebFetch에 300초 데드라인이 생겼습니다 — CLAUDE_CODE_WEBFETCH_DEADLINE_MS (v2.1.268)

응답을 끝내지 않고 연결만 열어두는 서버를 만나면 WebFetch가 무한정 매달려 있던 문제가 수정됐습니다. 이제 300초가 지나면 fetch가 실패로 끝나며, CLAUDE_CODE_WEBFETCH_DEADLINE_MS로 이 상한을 바꾸거나 0을 주어 끌 수 있습니다.

# 데드라인을 60초로 줄여 응답 없는 사이트에서 빨리 빠져나오게 합니다
export CLAUDE_CODE_WEBFETCH_DEADLINE_MS=60000

# 0을 주면 데드라인이 꺼집니다 (권장하지 않습니다)
export CLAUDE_CODE_WEBFETCH_DEADLINE_MS=0

무인으로 도는 스케줄 작업이나 CI에서 Claude Code를 쓰고 있다면, 기본 300초도 길게 느껴질 수 있으므로 작업 전체 시간 예산에 맞춰 짧게 낮춰 두는 편이 안전합니다. 같은 릴리스에서 localhost처럼 점이 없는 호스트명을 WebFetch가 거부할 때 이유를 설명하고 curl을 권하도록 메시지도 개선됐습니다. 전체 릴리스 노트

claude plugin 전 서브커맨드에 --json이 붙었습니다 (v2.1.268)

claude plugin install·uninstall·update·enable·disable에 --json이 추가되고, claude plugin list --json 각 행에는 errorDetails와 noteDetails가 들어갑니다. 함께 claude auth status --json 출력에 configDirectory가 추가돼, 지금 세션이 어느 설정 디렉터리를 쓰는지 스크립트에서 바로 확인할 수 있습니다.

# 설치 결과를 JSON으로 받아 실패 여부를 스크립트에서 판정합니다
claude plugin install my-plugin@my-marketplace --json | jq -e '.success'

# 어떤 플러그인이 왜 실패했는지 행 단위로 확인합니다
claude plugin list --json | jq '.[] | select(.errorDetails) | {name, errorDetails}'

팀 온보딩 스크립트나 CI에서 플러그인 설치를 자동화할 때, 예전처럼 사람이 읽는 출력을 파싱하지 않고 종료 코드와 JSON 필드로 판정할 수 있게 됐습니다. 전체 릴리스 노트

게이트웨이 요금 전달과 gatewayInternalNetworks (v2.1.268)

Claude apps 게이트웨이의 gateway.yaml에 pricing:을 설정하면, 로그인한 Claude Code 클라이언트가 관리 설정을 통해 같은 요금 정보를 받아 /cost와 텔레메트리 값이 실제 과금 미터와 일치하게 됩니다. 또한 gatewayInternalNetworks 관리 설정이 추가돼, 조직이 보유한 공인 IPv4 대역에서도 게이트웨이로 /login할 수 있도록 관리자가 허용할 수 있습니다.

# gateway.yaml
pricing:
  # 클라이언트가 이 요금표를 받아 /cost 계산에 사용합니다
  enabled: true

access_control:
  # 비어 있으면 시작 시 경고가 뜨고, 공인 IP에서 첫 요청이 오면 한 번 더 경고합니다
  allow_cidrs:
    - 10.0.0.0/8

게이트웨이를 운영 중이라면 access_control.allow_cidrs를 비워 둔 구성에 이번 릴리스부터 시작 경고가 붙는다는 점을 먼저 확인하는 편이 좋습니다. 전체 릴리스 노트

개발자 워크플로우 팁

모델이 좋아진 만큼 누적된 스킬과 AGENTS.md를 덜어낼 때입니다 (9/9)

코딩 에이전트의 성능이 올라가면서 예전에 필요했던 세세한 유도와 보조 절차의 필요성이 줄었고, 그동안 쌓인 Skills·AGENTS.md·작업 프롬프트를 재검토하는 일이 오히려 더 중요해졌다는 정리입니다. 스킬 설명은 짧고 사용 조건이 명확해야 하며, 여러 작업 흐름을 다루는 스킬은 필요한 문서와 스크립트만 골라 읽도록 구성해야 한다는 것이 요지입니다.

“매번 전체 문서를 읽어라”, “항상 테스트를 돌려라” 같은 CLAUDE.md·AGENTS.md의 포괄적 지시는 컨텍스트를 소모하고 작업을 늦추므로, 작업별로 정말 필요한지 따져 덜어내는 것이 좋습니다. 스킬이 10개를 넘어가기 시작한 저장소라면, 설명 한 줄로 호출 조건이 구분되는지부터 점검해 볼 만합니다. GeekNews

35시간·79커밋·1,200달러가 남긴 것 — 장시간 무인 실행의 함정 (9/11)

가상 스레드와 렉시컬 스코프를 갖춘 Python 구현을 코딩 에이전트에 맡겨 35시간 동안 7만 5,000줄의 코드와 79개의 커밋을 얻었지만, 결국 쓸 만한 결과물은 나오지 않았고 API 원가로 약 1,200달러가 들었다는 기록입니다. 더 눈여겨볼 대목은 도구 실행용으로 짧게 압축해 쓰고 버리는 코드의 스타일이 저장소에 남길 코드까지 번져, 읽기 어려운 테스트와 하드코딩된 숫자가 쌓였다는 관찰입니다.

에이전트를 오래 돌릴수록 결과가 좋아진다는 가정은 위험합니다. 무인 실행에는 시간·비용 상한을 명시적으로 걸고, 중간 산출물을 사람이 읽고 방향을 다시 잡는 체크포인트를 두는 편이 낫습니다. 특히 리뷰 단계에서는 기능 동작뿐 아니라 에이전트가 남긴 일회용 코드 스타일이 저장소 규칙을 침식하지 않았는지도 함께 봐야 합니다. GeekNews

보안/제한 이슈

Anthropic 위협 인텔리전스 리포트 — 가짜 Claude Code 설치 파일과 도난 API 키 시장 (9/10)

Anthropic이 2025년 12월부터 2026년 8월까지 차단한 오용 사례를 정리한 네 번째 위협 인텔리전스 리포트를 9/10에 공개했습니다. Claude Code 사용자에게 가장 직접적인 대목은 “저렴한 Claude 접근”을 내세운 사이트들이 인기 AI 하네스, 특히 Claude Code를 사칭한 클라이언트를 배포해 기기의 모든 자격증명과 세션 토큰을 수집했다는 부분입니다.

리포트는 도난당한 API 키와 세션 토큰 자체가 범죄 조직의 목표가 됐다고 정리합니다. 한 행위자는 AI 업체의 자동 평가 샌드박스에 악성 지시를 주입해 샌드박스가 보관하던 운영 API 키를 넘겨받은 뒤, 나흘 사이 약 30개 AI 기업을 같은 수법으로 공격했습니다. 여러 행위자가 LiteLLM 기반 래퍼 서비스에 프롬프트 인젝션을 걸어 컨테이너 환경의 운영 키를 빼낸 사례도 포함됩니다.

실무적으로는 세 가지를 점검할 만합니다. 첫째, Claude Code는 공식 배포 경로로만 설치할 것. 둘째, 에이전트가 읽을 수 있는 파일·환경변수·샌드박스에 운영 키를 두지 말고 서버 측에서 강제할 것. 셋째, 저장소와 빌드 산출물에 남은 키를 정기적으로 훑을 것입니다 — 리포트에 등장하는 한 조직은 안드로이드 APK 180만 개를 내려받아 하드코딩된 시크릿을 훑었습니다. Anthropic

v2.1.268 보안 수정 — 심볼릭 링크 deny 규칙 우회, 오류 메시지의 시크릿 노출 (9/10)

macOS의 /etc·/tmp·/var, Linux의 /bin처럼 심볼릭 링크로 연결된 디렉터리에 걸어둔 deny·ask 권한 규칙이, 경로를 실제 위치로 지정하면 적용되지 않던 문제가 수정됐습니다. Bash 명령이 심볼릭 링크 표기로 작성된 deny 규칙을 무시하던 문제, 그리고 env -C나 eval처럼 권한 검사기가 분석할 수 없는 명령이 같은 줄에 있으면 Read·Edit deny 규칙이 적용되지 않던 사례도 함께 잡혔습니다.

시크릿 노출도 두 곳에서 수정됐습니다. 플러그인·마켓플레이스 오류가 git 소스 URL에 포함된 토큰이나 비밀번호를 그대로 보여주던 문제, 그리고 /mcp·/plugin 서버 상세와 claude mcp list·get, MCP 로그인 오류가 MCP 설정의 ${VAR} 자리표시자에서 해석된 시크릿을 노출하던 문제입니다. 또한 신뢰하지 않은 폴더에 같은 이름의 에이전트 파일이 있을 때, 재생성된 인프로세스 팀메이트가 그 파일의 도구나 시스템 프롬프트를 가져오던 문제도 수정됐습니다.

권한 규칙을 경로 문자열로 관리하는 팀이라면, 이번 수정으로 기존에 통과하던 명령이 차단될 수 있으므로 업그레이드 후 자주 쓰는 경로부터 확인해 보는 것이 좋습니다. 전체 릴리스 노트

서드파티 엔드포인트가 v2.1.265부터 HTTP 400으로 전부 실패하던 회귀, v2.1.268에서 수정 (9/10)

ANTHROPIC_BASE_URL로 서드파티 Anthropic 호환 엔드포인트를 쓰는 구성에서, v2.1.265 이후 모든 턴이 HTTP 400으로 실패하던 문제가 수정됐습니다. 원인은 Artifact 도구의 입력 스키마에 들어 있던 정규식으로, 해당 엔드포인트들이 이를 거부하면서 요청 자체가 반려된 것입니다.

9/8 v2.1.265부터 9/9 v2.1.267까지 사흘간 이어진 회귀로, 자체 게이트웨이나 프록시를 경유하는 팀은 v2.1.268로 올리는 것이 유일한 해결책입니다. 어제 다룬 CLAUDE_CODE_USE_GATEWAY 회귀에 이어 게이트웨이·프록시 구성이 연달아 영향을 받은 만큼, 해당 구성을 쓴다면 릴리스마다 실제 호출 한 번으로 확인하는 스모크 테스트를 CI에 두는 편이 안전합니다. 전체 릴리스 노트

Claude 서비스 현황 — Cowork Windows 장애 진행 중, 나머지 전 서비스 정상

공식 status.claude.com을 직접 확인한 결과, 9/10 15:54 UTC에 등록된 “Degraded functionality for Claude Cowork on Windows” 인시던트가 9/11 현재 identified 상태로 진행 중입니다. 9월 8일 배포된 Windows 업데이트로 Cowork 워크스페이스가 사용자 PC의 드라이브에 접근하지 못하게 되면서 로컬 명령 실행이 막힌 것으로, 대부분의 사용자에게 채팅과 파일 읽기·편집은 계속 동작합니다. 앱 안에서 쓸 수 있는 우회책은 아직 없고 재시작이나 재설치로도 해결되지 않으며, Microsoft가 수정을 준비 중입니다.

나머지 서비스는 정상입니다. claude.ai·Claude Console·Claude API·Claude Code·Claude for Government 모두 Operational이며, Claude Code 자체는 이번 장애의 영향 범위에 포함되지 않았습니다. Windows에서 Cowork로 로컬 작업을 돌리던 팀이라면 수정 배포 전까지 Claude Code CLI 쪽으로 작업을 옮겨 두는 것이 현실적입니다. Claude Status

생태계 & 플러그인

OpenAI, Codex 기반 에이전트를 앱에 붙이는 Agents API 공개 (9/11)

애플리케이션에서 Codex의 에이전트 실행 기능을 API로 이용할 수 있게 하는 Agents API가 공개됐습니다. 세션 관리, 작업 조율, 문맥 압축과 복구를 OpenAI가 맡고, 개발자는 도구와 실행 환경을 지정하는 구조입니다. 같은 세션에서 이전 작업을 이어가거나 실행 도중 추가 지시로 방향을 바꿀 수 있고, 하위 에이전트에 작업을 나눠 맡길 수도 있으며, OpenAI 호스팅 샌드박스와 자체 호스팅 환경 중에서 고를 수 있습니다.

Claude Agent SDK로 에이전트를 앱에 태우고 있는 팀이라면, 세션·컨텍스트 관리를 직접 들고 갈지 플랫폼에 맡길지를 비교해 볼 만한 지점입니다. GeekNews

Cognition, Fable 5.1에 근접한 코딩 모델 SWE-2 출시 (9/11)

2.8조 매개변수 Kimi K3를 추가 학습한 코딩 모델로, 자체 FrontierCode 1.1 Main 평가에서 Fable 5.1과 0.9%p 차이인 50.0%를 기록하면서 작업당 비용은 64% 낮췄다고 밝혔습니다. 관련 코드만 집중적으로 살펴 불필요한 탐색과 반복 읽기를 줄였고, 문제 해결 여부뿐 아니라 비용과 소요 시간까지 보상에 반영해 여러 추론 수준을 한 번에 학습시킨 것이 특징입니다.

코딩 에이전트 비용이 부담스러운 팀에게는 “정확도 대비 비용” 축에서 대안이 하나 더 생긴 셈이지만, 벤치마크가 자체 평가라는 점은 감안해서 읽어야 합니다. GeekNews

커뮤니티 뉴스

• Shopify, React Native에서 네이티브로 복귀 (9/11): 코딩 에이전트가 같은 기능을 iOS와 Android에 각각 구현하는 비용을 크게 낮추면서, 모든 모바일 앱을 Swift와 Kotlin으로 전환하기로 했다는 발표입니다. React Native의 성능 문제가 아니라 “코드를 공유해야 개발 비용을 줄일 수 있다”는 전제 자체가 달라졌다는 설명입니다. Shop 앱은 개념 증명부터 완전한 네이티브 앱 출시까지 12주가 걸렸고, 300개 이상의 화면을 가진 Shopify 앱도 2026년 안에 전환 버전을 내놓을 예정입니다. 한 번에 코드를 변환하는 대신 작은 작업마다 테스트·화면 비교·코드 리뷰를 거치는 단계별 검증 시스템 Helix를 만들어 돌렸다는 점이, 대규모 마이그레이션을 에이전트에 맡기려는 팀에게 참고가 됩니다. GeekNews
• Anthropic, 2030년 경제 시나리오 탐색기 공개 (9/10): AI의 발전과 도입 속도에 관한 예상을 입력하면 2030년 미국의 경제와 일자리 변화를 보여주는 도구입니다. 직업 전체가 사라지는지만 보는 대신, 직업을 구성하는 업무가 AI로 보조되거나 자동화되고 새로운 업무가 생기는 과정을 모델링한 것이 특징입니다. 제시된 세 시나리오에서 2030년 GDP는 AI가 없는 경우보다 1.6~32.4% 높아지지만, 자동화가 크게 확산되는 시나리오에서는 지식 노동자의 임금이 정체하거나 하락합니다. GeekNews

알아두면 좋은 소소한 변경사항

아래는 모두 v2.1.268(9/10) 항목입니다.

• 오래 켜둔 유휴 세션이 busy loop로 CPU 코어 하나를 계속 점유하던 문제가 수정됩니다. 세션 요약 중 터미널 포커스 이벤트가 빠르게 반복될 때 CPU가 높게 유지되던 문제도 함께 잡혔습니다.
• /compact와 자동 compact가 만든 요약이 $ 시퀀스가 포함된 텍스트를 망가뜨리던 문제가 수정됩니다.
• CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS가 per-hook timeout이 없는 SessionEnd 훅에는 적용되지 않아 1.5초 만에 취소되던 문제가 수정됩니다.
• PermissionRequest 훅이 --print 모드에서 발동하지 않던 문제와 정책 헬퍼 경고가 헤드리스(-p) 실행에서 출력되지 않던 문제가 수정됩니다.
• 작업 추적 도구(TaskCreate/Get/Update/List, TodoWrite)가 Claude 3.x, Opus 4.04.7, Sonnet 4.04.6, Haiku 4.5에만 제공되도록 바뀝니다. 그 외 모델에서 쓰려면 CLAUDE_CODE_ENABLE_TODO_TOOLS=1을 설정해야 합니다.
• /plugin에서 설치·활성화·비활성화가 메뉴를 닫는 시점에 바로 반영되어, 이후 /reload-plugins가 필요 없게 됩니다.
• claude self-hosted-runner --remove-session-state(기본 꺼짐)가 추가되어, 세션이 끝날 때 <base-dir>/_sessions/ 아래 세션별 디렉터리를 삭제할 수 있습니다.
• auto 모드 거부 메시지가 개선되어, 어떤 규칙이 동작을 막았는지 Claude에게 알려주고 더 안전한 방법을 시도한 뒤 관련 없는 작업까지 마치고 물어보도록 안내합니다.
• --continue·--resume이 SessionStart 훅을 기다리지 않고 대화를 즉시 표시하며, 첫 메시지에서 전체 트랜스크립트를 다시 읽지 않습니다.

추천 칼럼 & 읽을거리

• ‘소프트웨어는 어떻게 사람을 미치게 만드는가’ (9/11): 소프트웨어에서는 화면부터 사업 모델까지 무엇이든 바꿀 수 있다 보니 “할 수 있다”가 “해야 한다”로, 다시 “왜 아직 안 됐나”로 바뀌며 모든 일이 긴급해지기 쉽다는 글입니다. 집의 부엌을 옮기면 뜯어낸 배관이 눈에 보이지만, 코드 변경이 남기는 문맥 전환·회귀 위험·합의 비용은 보이지 않는다는 비유가 핵심입니다. 에이전트로 변경 비용이 더 싸 보이게 된 지금, “잘 작동하는 것을 건드리지 않는 능력”도 엔지니어링이라는 지적이 특히 읽어볼 만합니다. GeekNews
• ‘모든 어른은 한때 어린이였지만, 그것을 기억하는 어른은 드물다’ (9/10): 수학자 테렌스 타오가 AI가 문제를 풀더라도 그 과정에서 사람이 얻는 배움과 통찰까지 대신하는 것은 아니라며 호기심에 이끌리는 탐구의 가치를 짚은 글입니다. 아이들이 ‘가장 큰 수 말하기’ 놀이에서 스스로 ‘더하기 1’을 발견하듯, 정답을 곧바로 알려주면 목표는 달성해도 탐색하며 배우는 즐거움은 사라질 수 있다는 대목이 인상적입니다. 에이전트에 구현을 맡기는 비중이 커질수록 팀에서 무엇을 직접 해볼지 정하는 기준으로 삼을 만합니다. GeekNews
• ‘YAML 명세의 잘못은 아니지만…’ (9/11): no를 불리언으로 읽는 이른바 노르웨이 문제는 YAML 명세가 요구하는 동작이 아니며, 초기 설계자들은 스칼라를 기본적으로 문자열로 다루기를 권장했다는 추적기입니다. 2002년의 타입 정책 변경이 구현체에 반영되지 않은 채 Syck가 2003년 Ruby 표준 라이브러리에 들어가면서, 명세보다 구현체의 동작이 사용자 기대를 굳혔다는 경과가 정리돼 있습니다. CLAUDE.md 옆의 설정 파일이나 frontmatter를 다루다 값이 엉뚱하게 해석된 경험이 있다면 원인을 짚어볼 만한 글입니다. GeekNews

흥미로운 프로젝트 & 도구

• Show GN: Jjan! — Claude Code 사용량이 차오르는 맥주잔 위젯 (9/11): Claude Code 사용량을 맥 화면에 항상 띄워두는 macOS 위젯으로, 잔이 차오른 만큼이 지금까지 쓴 양이고 퍼센트와 한도 리셋까지 남은 시간, 주간 사용량 막대를 함께 보여줍니다. ~/.claude/projects 아래 JSONL을 읽어 메시지와 요청 ID로 중복을 제거한 값과, 키체인 자격증명으로 조회한 공식 사용량 API 값을 서로 대조하는 구조입니다. 사용량·토큰·비용·프로젝트 경로는 기기 밖으로 나가지 않습니다. 주간 한도에 자주 부딪히는 사용자라면 한도 리셋 시각을 눈에 띄게 띄워두는 용도로 쓸 만합니다. GeekNews
• Show GN: tapl — 작업 이력과 기억을 저장소 SQLite에 남기는 워크플로 도구 (9/11): 요청·계획·작업·발견 사항·완료 이력을 저장소 안의 SQLite에 기록해, 세션이 바뀌어도 어떤 결정을 왜 했고 어디까지 검증했는지 이어갈 수 있게 하는 도구입니다. MCP와 hook으로 에이전트에 연결되며, 설치 후에는 평소처럼 자연어로 작업을 요청하면 됩니다. 현재는 Codex 연동으로 만들어졌지만, MCP와 hook이라는 붙는 방식 자체는 Claude Code에서도 익숙한 구조라 세션 간 컨텍스트 유실이 고민인 팀이라면 설계를 참고할 만합니다. GeekNews