[Hacker News 요약] Claude Code, CLAUDE.md 없을 시 AGENTS.md 우선 로드
44
설명
Claude Code는 프로젝트별 지침 파일인 CLAUDE.md가 없을 경우, AGENTS.md 파일을 우선적으로 읽어들이도록 업데이트되었습니다.
이 변경 사항은 2.1.277 버전 릴리스 노트에 포함되었으며, 프로젝트 설정 및 구성 방식을 간소화합니다.
Bedrock, Vertex, Foundry 환경에서는 아직 이 기능이 지원되지 않으며, 향후 지원될 예정입니다.
### 배경 설명
Claude Code는 개발자가 AI와 협업하여 코드를 작성하고, 디버깅하며, 문서화하는 데 도움을 주는 도구입니다. 개발자들은 종종 프로젝트의 특정 요구사항이나 설정에 대한 지침을 코드 저장소 내에 파일 형태로 관리하곤 합니다. 전통적으로 Claude Code는 이러한 지침을 CLAUDE.md 파일에서 읽어왔습니다. 그러나 프로젝트의 성격에 따라서는 CLAUDE.md 대신 AGENTS.md와 같이 다른 이름의 파일에 핵심적인 지침이나 에이전트 관련 설정을 저장하는 것이 더 적합할 수 있습니다. 이러한 유연성을 제공함으로써, 개발자들은 자신들의 워크플로우에 맞춰 Claude Code의 동작을 더욱 세밀하게 제어할 수 있게 됩니다. 이번 업데이트는 이러한 맥락에서, CLAUDE.md 파일이 존재하지 않을 때 AGENTS.md 파일을 자동으로 인식하고 활용하도록 하여, 프로젝트 설정의 편의성을 높이는 데 기여합니다.
### AGENTS.md 우선 로드 기능
Claude Code 버전 2.1.277부터는 프로젝트 루트 디렉토리에 CLAUDE.md 파일이 없을 경우, AGENTS.md 파일을 프로젝트 지침으로 우선 인식하고 로드합니다. 이 설정은 /config 메뉴의 ‘Project instructions’ 섹션에서 변경할 수 있습니다. AGENTS.md 파일은 에이전트의 동작 방식, 역할, 또는 특정 작업 지침 등을 정의하는 데 사용될 수 있습니다. 이 기능은 개발자들이 프로젝트의 특성에 맞게 Claude Code의 행동을 맞춤 설정할 수 있도록 하여, 보다 유연하고 효율적인 개발 환경을 제공합니다. 예를 들어, 특정 에이전트의 동작 방식을 정의하는 데 AGENTS.md를 활용하고, CLAUDE.md는 별도의 일반적인 지침을 담는 식으로 역할을 분담할 수 있습니다.
### Claude 앱 게이트웨이 프록시 설정
이번 업데이트에는 Claude 앱 게이트웨이가 프록시를 사용하는 환경에서 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 설정을 지원하는 내용도 포함되었습니다. 이 설정은 게이트웨이의 유일한 외부 연결이 프록시를 통하는 경우, 프록시에게 로컬에서 호스트 이름을 해석하는 대신 직접 호스트 이름을 전달하도록 합니다. 또한, Claude 앱 게이트웨이 업스트림에 optional headers: map을 추가하여 프록시 앞에 정적 헤더를 보낼 수 있게 되었습니다. 이러한 설정은 네트워크 환경이 복잡한 기업 환경에서 Claude Code의 연결성과 보안을 강화하는 데 기여합니다.
### 기타 버그 수정 및 개선 사항
2.1.277 릴리스에는 AGENTS.md 우선 로드 및 게이트웨이 프록시 설정 외에도 다양한 버그 수정 및 개선 사항이 포함되었습니다. 예를 들어, 내부 오류 발생 시 Agent SDK 세션이 멈추는 문제를 해결하고, 이전 버전의 Claude Code 빌드가 동일한 머신에서 실행될 때 예기치 않게 로그아웃되는 문제를 수정했습니다. 또한, 업데이트 확인 오류, Grep 및 Glob 도구의 매치 없음 보고, Write 도구의 권한 거부 처리 등 다양한 기능적 안정성 개선이 이루어졌습니다. 이러한 지속적인 개선은 Claude Code의 전반적인 사용자 경험과 안정성을 향상시키는 데 목적이 있습니다.
### 가치와 인사이트
이번 Claude Code 업데이트는 개발자 워크플로우의 유연성을 크게 향상시킵니다. CLAUDE.md 파일의 부재 시 AGENTS.md 파일을 자동으로 인식하는 기능은 프로젝트별 설정 방식을 간소화하고, 개발자들이 자신들의 선호하는 구조에 맞춰 Claude Code를 활용할 수 있도록 합니다. 이는 특히 복잡한 프로젝트나 여러 에이전트를 활용하는 환경에서 유용할 것입니다. 또한, Claude 앱 게이트웨이의 프록시 관련 설정 개선은 기업 환경에서의 도입 및 운영을 더욱 용이하게 만들 것으로 기대됩니다. 이러한 변화는 개발 생산성 향상과 AI 기반 개발 도구의 접근성 확장에 기여할 것입니다.
### 향후 전망
AGENTS.md 파일의 우선 로드 기능은 향후 Claude Code가 더 다양한 프로젝트 설정 파일을 인식하고 활용할 수 있는 기반을 마련할 수 있습니다. 개발자 커뮤니티의 피드백을 바탕으로, 특정 프로젝트 유형이나 프레임워크에 특화된 설정 파일을 자동으로 인식하는 기능이 추가될 가능성도 있습니다. 또한, Claude 앱 게이트웨이의 네트워크 설정 관련 개선은 클라우드 기반 개발 환경에서의 Claude Code 활용도를 높일 것입니다. 향후에는 이러한 설정들이 더욱 세밀하게 조정 가능해지고, 다양한 클라우드 및 네트워크 환경과의 통합이 강화될 것으로 전망됩니다. 지속적인 버그 수정과 기능 개선을 통해 Claude Code는 개발자들에게 더욱 강력하고 안정적인 AI 협업 도구로 자리매김할 것입니다.
📝 원문 및 참고
- Source: Hacker News
- 토론(HN): [news.ycombinator.com](https://news.ycombinator.com/item?id=49760187)
- 원문: [링크 열기](https://code.claude.com/docs/en/changelog)
---
출처: Hacker News · [원문 링크](https://code.claude.com/docs/en/changelog)
이 글에 대한 한 줄 의견
신고 · 불법·유해·아동 안전(CSAE) 관련 콘텐츠
댓글 0
아직 댓글이 없습니다. 로그인하면 바로 의견을 남길 수 있습니다.