메뉴
HN
Hacker News • 7일 전

Claude Code, CLAUDE.md 없으면 AGENTS.md 읽도록 지원

IMP
6/10
핵심 요약

Claude Code 2.1.277 업데이트에서 프로젝트에 CLAUDE.md가 없을 경우 AGENTS.md를 대신 읽는 기능이 추가되었습니다. 이는 Anthropic이 Agent 표준화 흐름에 맞춰 상호운용성을 높인 변화로, 다른 코딩 에이전트와 프로젝트 설정을 공유할 수 있게 됩니다. 이 외에도 게이트웨이 프록시 개선과 다수의 안정성 버그 수정이 포함되었습니다.

번역된 본문

이 페이지는 GitHub의 CHANGELOG.md에서 생성되었습니다. 설치된 버전은 claude --version으로 확인하세요.

2.1.277 (2026년 9월 18일)

  • AGENTS.md 지원 추가: CLAUDE.md가 없는 프로젝트에서는 Claude Code가 대신 AGENTS.md를 읽습니다. /config의 "Project instructions"에서 변경할 수 있습니다 (아직 Bedrock, Vertex, Foundry에서는 지원되지 않음)
  • 유일한 이그레스(egress)가 포워드 프록시인 Claude 앱 게이트웨이를 위해 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 추가: 모든 아웃바운드 요청이 로컬에서 호스트명을 해석하는 대신 프록시에 호스트명을 전달합니다
  • Claude 앱 게이트웨이 업스트림에 선택적 headers: 맵 추가, 프로바이더 앞단에 운영하는 프록시에 정적 헤더를 전송할 수 있습니다
  • /tasks 같은 패널이 열려 있는 동안 백그라운드 작업이 완료되면 업데이트가 대기 중임을 알리는 문구 추가
  • 내부 오류 후 claude -p 및 Agent SDK 세션이 결과 없이 멈출 수 있던 문제 수정: 이제 오류를 보고하고 종료 코드 1로 종료합니다
  • 이전 어시스턴트 턴에 다른 콘텐츠와 함께 빈 텍스트 블록이 있을 때(--resume 이후 포함) 모든 요청이 "text content blocks must be non-empty" 오류로 실패하던 문제 수정
  • 구버전 Claude Code 빌드(예: IDE 확장에 포함된 CLI)가 최신 버전과 같은 머신에서 실행될 때 예기치 않게 로그아웃되던 문제 수정
  • ~/.claude.json에 잘못된 customApiKeyResponses 값이 있을 때 ANTHROPIC_API_KEY 사용자의 대화형 시작이 멈추거나 오류를 표시하던 문제 수정
  • 프록시가 잘못된 버전을 반환할 때 30분마다 업데이트 확인이 오류 나던 문제, 최소/최대 버전이 설정된 경우 claude update가 멈추던 문제 수정: 잘못된 minimumVersion은 이제 무시됩니다
  • winget 또는 apk로 관리되는 설치에서 버전 조회 실패 시 claude update가 "최신 상태"로 잘못 보고하던 문제 수정
  • 세션이나 다른 프로그램이 사용 중인 플러그인 버전을 재설치할 때 claude plugin install이 실패하고 설치된 복사본을 손상시키던 문제 수정: 변경되지 않은 복사본은 이제 그대로 둡니다
  • 프로세스, 메모리, 파일 핸들이 부족해 검색을 시작할 수 없을 때 Grep과 Glob이 일치 항목 없음을 보고하던 문제 수정: 이제 해당 사실을 알리는 오류를 반환합니다
  • 대상 경로가 기존 디렉터리일 때 Write 도구가 권한 거부로 조용히 턴을 종료하던 문제 수정: 이제 명확한 오류를 보고합니다
  • Edit 도구가 이스케이프된 백슬래시 뒤의 uXXXX 텍스트를 \uXXXX 이스케이프로 잘못 해석해, 비 ASCII 문자 편집 시 이스케이프된 백슬래시 시퀀스를 대신 재작성하던 문제 수정
  • 비 ASCII 텍스트를 포함한 매우 큰 편집이 파일과 일치하지 않을 때 Edit 도구가 "String not found in file" 대신 "Invalid regular expression: regular expression too large"를 보고하던 문제 수정
  • 도구 호출의 파일 경로에 이스케이프 시퀀스로 작성된 \u0000이 포함될 때 "Path contains null bytes"로 턴이 조기 종료되던 문제 수정: 이스케이프된 제어 문자는 이제 리터럴 텍스트로 유지됩니다
  • 플러그인의 LSP 서버가 종료되거나 표준 입력을 닫을 때 백그라운드 세션(claude --bg)이 종료되던 문제 수정
  • ~/.claude.json에 잘못된 claudeAiMcpEverConnected 값이 있을 때 /mcp 또는 /plugin manage를 열면 발생하던 크래시("Type error") 수정
  • ~/.claude.json에 잘못된 테마 값이 있을 때 시작 시 크래시 수정
  • 히스토리에서 불러온 프롬프트나 외부 에디터에서 로드한 텍스트처럼 터미널 색상 코드를 포함한 텍스트가 프롬프트에 있을 때 발생하던 크래시("unrecoverable interface error") 수정
  • 저장된 히스토리에 일반 문자열로 저장된 어시스턴트 메시지가 있는 세션을 재개할 때 발생하던 크래시 수정
  • 느리거나 부하가 큰 머신에서 첫 스피너가 나타날 때 세션이 "Claude Code exited after an unrecoverable interface error"로 종료되던 문제 수정
  • 내부 렌더링 오류 후 세션 남은 기간 동안 화면이 업데이트되지 않을 수 있던 드문 경우 수정
  • Windows에서 Claude가 응답한 직후 "Out of memory" 등의 오류로 턴이 중단되어 해당 응답의 도구 호출이 실행되지 않던 드문 경우 수정
  • /clear 후 재개된 세션(restart, --continue, --resume)에서 SessionStart 훅이 출력을 인쇄할 때 첫 메시지의 일부가 누락되던 문제 수정
원문 보기
원문 보기 (영어)
This page is generated from the CHANGELOG.md on GitHub . Run claude --version to check your installed version. ​ 2.1.277 September 18, 2026 Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under “Project instructions” in /config (not yet on Bedrock, Vertex or Foundry) Added CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 for Claude apps gateways whose only egress is a forward proxy: every outbound request hands the proxy the hostname instead of resolving it locally Added an optional headers: map on Claude apps gateway upstreams, to send static headers to a proxy you run in front of a provider Added a line saying a background task’s update is waiting when it finishes while a panel such as /tasks is open Fixed claude -p and Agent SDK sessions that could hang with no result after an internal error; they now report the error and exit with code 1 Fixed conversations failing every request with “text content blocks must be non-empty” when an earlier assistant turn held an empty text block beside other content, including after --resume Fixed being unexpectedly logged out when an older Claude Code build (for example an IDE extension’s bundled CLI) runs on the same machine as the current one Fixed interactive start-up hanging or showing an error for ANTHROPIC_API_KEY users when ~/.claude.json holds a malformed customApiKeyResponses value Fixed update checks erroring every 30 minutes, and claude update hanging when a minimum or maximum version is set, if a proxy returns an invalid version; a malformed minimumVersion is now ignored Fixed claude update on winget- or apk-managed installs reporting “up to date” when the version lookup failed Fixed claude plugin install sometimes failing and breaking the installed copy when reinstalling a plugin version that a session or another program was using; an unchanged copy is now left alone Fixed Grep and Glob reporting no matches when the search could not start because the system was out of processes, memory or file handles; they now return an error saying so Fixed the Write tool silently ending the turn as a declined permission when the target path is an existing directory; it now reports a clear error Fixed the Edit tool treating an escaped backslash followed by uXXXX text as a \uXXXX escape, which could make an edit of a non-ASCII character rewrite an escaped backslash sequence instead Fixed the Edit tool reporting “Invalid regular expression: regular expression too large” instead of “String not found in file” when a very large edit containing non-ASCII text did not match the file Fixed a turn ending early with “Path contains null bytes” when a tool call’s file path contained \u0000 written as an escape sequence; escaped control characters now stay as literal text Fixed background sessions ( claude --bg ) exiting when a plugin’s LSP server exited or closed its stdin Fixed a crash (“Type error”) when opening /mcp or /plugin manage with a malformed claudeAiMcpEverConnected value in ~/.claude.json Fixed a crash at launch when ~/.claude.json holds a malformed theme value Fixed a crash (“unrecoverable interface error”) when the prompt held text containing terminal color codes, for example a prompt recalled from history or text loaded from the external editor Fixed a crash when resuming a session whose saved history holds an assistant message stored as a plain string Fixed sessions on slow or heavily loaded machines sometimes exiting with “Claude Code exited after an unrecoverable interface error” when the first spinner appeared Fixed a rare case where the screen could stop updating for the rest of the session after an internal rendering error Fixed a rare case on Windows where a turn could stop with an error such as “Out of memory” right after Claude replied, so that reply’s tool calls never ran Fixed sessions continued after /clear (restart, --continue , --resume ) missing part of their first message when a SessionStart hook printed output, causing a full prompt-cache miss Fixed messages from other agents (such as a subagent’s SendMessage) that arrived mid-turn showing up below the “Ran N shell commands” row instead of where they arrived Fixed the “copied” notice not appearing after drag-selecting text in the fullscreen /resume picker and other panels that cover the prompt area Fixed $TMPDIR expanding empty in Bash commands that run outside the sandbox while sandboxing is enabled Fixed WebFetch and WebSearch in Cowork cloud sessions not telling Claude why a request was refused, such as a used-up fetch budget or an admin policy Fixed the Claude apps gateway’s telemetry relay ignoring a collector hostname or domain listed in NO_PROXY when a proxy is set Fixed one malformed strictKnownMarketplaces or blockedMarketplaces entry silently disabling the whole enterprise marketplace policy Fixed failed auto-updates leaving large staged downloads behind in ~/.cache/claude/staging Fixed /plugin not stripping terminal control characters from messages on the Installed tab, such as the error of a failed plugin update Fixed /plugin → Installed and /skills crashing when a skill or legacy command is named like a built-in Object property such as constructor or toString Fixed /plugin closing with no message when every install in a multi-select failed Fixed uninstalled plugins reappearing as “failed to load” rows in /plugin Installed, and Remove not clearing such a row Fixed plugins from the official marketplace being recorded without their commit in installed_plugins.json , and installed_plugins.json keeping the old commit after updating a pinned-commit plugin Fixed plugin reload previews keeping every previewed copy of a plugin archive unpacked until exit, and overwriting the cached --plugin-url archive a reload falls back to when its download fails Fixed Remote Control session bookkeeping failing when ~/.claude.json holds a malformed placeholder record Fixed the error after a revoked claude.ai login blaming an expired Anthropic profile; it now leads with /login Fixed typed or pasted text occasionally coming out scrambled in the claude agents dispatch input during key repeat or very fast input Fixed a crash (“unrecoverable interface error”) when resuming a session whose saved transcript contains a stop hook summary without a well-formed hook list Fixed Enter on a selected agent panel row doing nothing when keybindings.json rebinds Enter in the Chat context, for example to chat:queueSubmit Fixed PDF page reads on Windows failing when the working folder’s path is long (about 120 characters or more) Fixed a headless resume ( claude -p --resume , the SDK, a VS Code extension window reload) starting the session’s cost and usage totals at zero; headless sessions now save their totals at exit Fixed project skills from the main repository not loading in --worktree sessions when .claude/skills is untracked Fixed a sandbox.excludedCommands glob exempting an entire compound Bash command from the sandbox when only one part matched; every part must now match Fixed resumed subagents and teammates re-rendering the MCP tool definitions they had loaded, which broke prompt caching for that agent Fixed rate-limited artifact publishes telling Claude to stop retrying; Claude is now told nothing was published and when to send the same publish again Fixed attachments recorded earlier in a conversation being re-rendered after a resume or relaunch, which dropped extended thinking and missed the prompt cache Fixed Console sign-in showing only “Request failed with status code 400” when the server refuses to create an API key; it now shows the server’s message Fixed messages typed while Claude is still working sometimes being ignored by the model Improved session start-up for SDK and headless ( -p ) use: the first turn no longer waits on the per-directory CLAUDE.md lookup Improved the Claude apps gateway’s loopback error messages to name CLAUDE_GATEWAY_ALLOW_LOOPBACK Improved /plugin Installed: an MCP server listed apa