메뉴
HN
Hacker News 3일 전

Claude 5 모델을 위한 새로운 컨텍스트 엔지니어링 규칙

IMP
9/10
핵심 요약

최신 Claude 5 세대 모델은 지능이 향상됨에 따라 과도한 규칙이나 제약 없이도 스스로 판단하여 최적의 결과를 도출할 수 있게 되었습니다. 이에 따라 Anthropic은 Claude Code의 시스템 프롬프트를 80% 이상 대폭 축소하고, AI 에이전트를 억누르던 제약을 풀어주는 새로운 컨텍스트 엔지니어링 모범 사례를 소개합니다. 이는 개발자가 직접 AI 에이전트를 구축하거나 활용할 때 불필요한 명령을 줄이고 모델의 고유한 능력을 극대화하는 데 중요한 지침이 됩니다.

번역된 본문

원문 제목: The new rules of context engineering for Claude 5 generation models 소스: hackernews

본문: Claude 5 세대 모델을 위한 새로운 컨텍스트 엔지니어링 규칙 우리는 더 발전한 모델을 위해 Claude Code의 시스템 프롬프트를 80% 이상 제거했습니다. 우리가 얻은 교훈을 여러분의 Claude Code 사용 경험과 자체 에이전트 구축에 적용하는 방법을 소개합니다.

카테고리: Claude Code, 에이전트 제품: Claude Code, Claude Enterprise, Claude Platform 날짜: 2026년 7월 24일 읽는 데 걸리는 시간: 5분 공유: 링크 복사 https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models

이전 글에서 최신 세대 Claude 5 모델에 가장 잘 프롬프트하는 방법과, 여러분이 만들고자 하는 것을 발견하기 위해 반복적으로 작업하는 방법에 대해 설명한 적이 있습니다. 하지만 Claude에게 메시지를 보낼 때, 프롬프트는 모델이 받는 컨텍스트(Context)의 일부일 뿐입니다. 대부분의 컨텍스트는 시스템 프롬프트, 스킬(Skills), CLAUDE.md 파일, 메모리 및 기타 소스에서 조합됩니다. 우리는 이를 '컨텍스트 엔지니어링'이라고 부르며, 이는 Claude Code를 사용하거나 자체 에이전트를 구축할 때 생성되는 결과에 큰 영향을 미칩니다. 프롬프트와 달리 컨텍스트는 일반적으로 여러 요청에 걸쳐 사용되므로, 지나치게 구체적일 수는 없습니다. 특히 사용자의 프롬프트가 무엇일지 알 수 없을 때, Claude를 위한 이러한 범용적인 프롬프트와 가이드라인을 어떻게 구축해야 할까요? Claude 자체의 역량이 발전함에 따라 이것은 생각보다 상당히 어려울 수 있습니다.

최근 우리는 최신 세대 Claude 모델을 프롬프트하는 방식에서 큰 변화를 감지했습니다. 우리는 Claude Opus 5 및 Claude Fable 5와 같은 모델을 위해 Claude Code의 시스템 프롬프트를 80% 이상 제거했음에도 불구하고, 코딩 평가에서 측정할 수 있는 성능 저하가 전혀 발생하지 않았습니다. 여기서 우리가 이 새로운 클래스의 모델들을 프롬프트하며 배운 점과, 이를 여러분의 컨텍스트 엔지니어링을 업데이트하는 데 어떻게 활용할 수 있는지 공유합니다. 우리는 이러한 모범 사례들을 claude doctor;에 넣었습니다. Claude Code에서 /doctor 명령어를 사용하여 스킬과 CLAUDE.md 파일의 크기를 적절하게 조정해 보세요.

Claude의 제약 풀기 (Unhobbling Claude) 전반적으로 우리는 시스템 프롬프트, CLAUDE.md 파일, 스킬 등을 통해 Claude Code에 과도한 제약을 가하고 있었음을 발견했습니다. 예를 들어, 내부적으로 Claude Code를 사용하는 기록을 읽어보면, 단일 요청에 "적절하게 문서화를 남겨라"라는 메시지와 "절대 주석을 추가하지 마라"라는 메시지가 시스템 프롬프트, 스킬, 사용자 요청 간에 충돌하며 섞여 있는 것을 볼 수 있었습니다. 일반적으로 Claude는 사용자의 의도를 해석하여 올바른 답을 찾아갈 수 있지만, 무엇을 해야 할지 결정하기 전에 이러한 중복되고 충돌하는 메시지들에 대해 더 깊게 고민해야만 했습니다. 최악의 시나리오를 피하기 위해 이러한 제약들이 한때는 필요했지만, 이제는 많은 부분을 삭제하고 주변 컨텍스트와 모델 자체의 판단을 사용하도록 내버려 두어도 무방하다는 사실을 알게 되었습니다.

또한, 이제 Claude Code에는 훨씬 더 많은 도구가 있습니다. 과거에는 Claude가 메모리, 정보, 가이드라인의 소스로 CLAUDE.md 파일에 의존했습니다. 하지만 이제는 메모리, 아티팩트(Artifacts), 스킬(Skills)이 있어서 Claude는 세션 간에 컨텍스트를 로드하고 공유하는 새로운 방법을 만들어낼 수 있습니다.

(항목을 찾을 수 없음) 이전 0 / 5 다음 Claude Code 받기: curl -fsSL https://claude.ai/install.sh | bash (클립보드에 명령 복사) 또는 irm https://claude.ai/install.ps1 | iex (클립보드에 명령 복사) 문서를 읽어보세요. Claude Code를 사용해보세요. 개발자 문서. 전자책(eBook).

과거와 현재 과거에는 컨텍스트 엔지니어링의 모범 사례로 여겨지던 몇 가지가 이제는 미신이 되었습니다. 다음을 포함하여:

과거: Claude에게 규칙을 부여하기 현재: Claude가 스스로 판단하게 두기 처음 Claude Code를 출시했을 때, 우리는 Claude가 파일 삭제와 같은 최악의 시나리오를 피하도록 확실히 해야 했습니다. 이는 항상 옳지는 않을 수 있는 매우 강력한 가이드라인을 제공해야 함을 의미했습니다. 예를 들어, 과거 시스템 프롬프트에는 다음과 같이 명시되어 있었습니다.

  • 코드 작성 시: 기본적으로 주석을 작성하지 마십시오. 여러 단락의 docstring이나 여러 줄의 주석 블록을 절대 작성하지 마십시오. 최대 한 줄의 짧은 주석만 허용됩니다.
  • 사용자가 요청하지 않는 한 계획, 의사결정 또는 분석 문서를 만들지 마십시오. 중간 파일을 만드는 대신 대화 컨텍스트를 기반으로 작업하십시오.

하지만 특정 프롬프트의 경우, 이러한 가이드라인은 틀린 것이 됩니다. 문서화의 경우를 보면,

원문 보기
원문 보기 (영어)
The new rules of context engineering for Claude 5 generation models We removed over 80% of Claude Code's system prompt for more advanced models. How to apply the lessons we learned to your own context engineering in Claude Code and with your own agents. Category Claude Code Agents Product Claude Code Claude Enterprise Claude Platform Date July 24, 2026 Reading time 5 min Share Copy link https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models I’ve written previously about how to best prompt the newest generation of Claude 5 models and work with them iteratively to discover what you want to build. But when you send a message to Claude, the prompt is only a small part of the context it gets. Much of your context is assembled from your system prompt, Skills, CLAUDE.md files, memory, and other sources. We call this context engineering , and it makes a big impact on the results you generate when using Claude Code or in building your own agents. Unlike a prompt, context is used generally across many requests, so it cannot be as specific. How do you build these general prompts and guidance for Claude, especially when you don’t know what a user’s prompt might be? This can be surprisingly difficult as Claude’s own capabilities evolve. Most recently, we noticed a large jump in the way we prompt the newest generation of Claude models. We removed over 80% of Claude Code’s system prompt for models like Claude Opus 5 and Claude Fable 5 with no measurable loss on our coding evaluations. Here’s what we’ve learned about prompting this new class of models, and how you can utilize it to update your context engineering. We’ve put these best practices in `claude doctor;` use the command /doctor in Claude Code to rightsize your skills, and CLAUDE.md files. Unhobbling Claude Overall, we found that we were overconstraining Claude Code, both through our system prompt and in our CLAUDE.md files and skills. For example, when we read transcripts of our own internal usage of Claude Code, we see several conflicting messages in a single request like “leave documentation as appropriate,” or “DO NOT add comments” as our system prompt, skills, and user requests clash with each other. Generally, Claude can interpret the user’s intent to get to the right answer, but Claude must think more carefully about these overlapping and conflicting messages before deciding what to do. And while these constraints were once needed to avoid worst case scenarios, we have since found we can delete many of them and let the model use surrounding context and judgement instead. Additionally, Claude Code now has many more tools. Claude used to rely on CLAUDE.md as a source of memory, information, and guidance. Now we have memory, artifacts, and skills, which Claude can use to create new ways of loading and sharing context across sessions. No items found. Prev Prev 0 / 5 Next Next Get Claude Code curl -fsSL https://claude.ai/install.sh | bash Copy command to clipboard irm https://claude.ai/install.ps1 | iex Copy command to clipboard Or read the documentation Try Claude Code Try Claude Code Try Claude Code Developer docs Developer docs Developer docs eBook Then and now There were a number of previous context engineering best practices that had become myths. Including:. Then: Give Claude rules Now: Let Claude use judgement When we first rolled out Claude Code, we needed to be sure that Claude avoided worst case scenarios, such as deleting files. This meant we would give particularly strong guidance that might not always be true, For example, in the system prompt we used to say: In code: default to writing no comments. Never write multi-paragraph docstrings or multi-line comment blocks — one short line max. Don't create planning, decision, or analysis documents unless the user asks for them — work from conversation context, not intermediate files. But for a certain subset of prompts, this guidance would be wrong. In the case of documentation, the user may have their own preferences, or specific parts of very complex code might need multi-line comment blocks. Still, without these guardrails for older models, the comments Claude wrote would be incorrect in many cases and we had to accept this tradeoff. But newer models have better judgement and can handle these decisions well without explicit rules. In the new system prompt we say: Write code that reads like the surrounding code: match its comment density, naming, and idiom. Then: Give Claude examples Now: Design interfaces The number one rule for tool usage was to give Claude examples on how to use them. With our newest models, we’ve found that giving examples actually constrains them to a certain exploration space. Instead of using examples, think more about the design of your tools, scripts and files- what parameters does Claude have and how can they be more expressive? For example, in the Todo tool example, just listing status as an enumeration between pending, in_progress, and completed, hints to Claude about how to use it. The instruction on keeping one item in_progress helps define our requested behavior. Then: Put it all upfront Now: Use progressive disclosure Because Claude Code was focused on coding, our system prompt included detailed information on how to do code review and verification. These were not always needed, but when they were, it was crucial information. Since then, Claude Code has gotten very competent at using progressive disclosure- loading the right context at the right times. For example, we moved verification and code review into their own skills that Claude Code could selectively call. But progressive disclosure is not just for skills, we also use it for tools. Some of our tools are ‘deferred loading,’ which means the agent must search for their full definitions using ToolSearch before using them. This allows us to have more tools (such as our Task tools) that don’t take up context until they’re needed. The same can be applied to your own CLAUDE.md and Skill.md files. A common myth is that you want to make these a central repository for every known practice that you might run into, because Claude would not find it otherwise. Instead, consider having a tree of files that can be loaded at the right time . Then: Repeat yourself Now: Simple tool descriptions Earlier Claude models could sometimes need repeated instructions or be more likely to listen to instructions at the end of their context window than at the start. This meant our system prompt would sometimes have references to tools in the main system prompt as well as instructions in the tool description. We found we could delete these repeat examples and put instructions on how to use tools in the tool descriptions rather than the system prompt. Then: Memory in CLAUDE.md files Now: Auto-memory We used to encourage users to save things to Claude’s memory, by using the # hotkey to write to their CLAUDE.md automatically. Instead, Claude now automatically saves memories that are relevant to the work and to you. Then: Simple specs Now: Rich references In plan mode, Claude Code has heavily relied on markdown files with plans. Storing these files as plans helped Claude refer to them when needed. Another similar best practice was to store specs in the codebase for Claude to refer to while working across longer projects. But we’ve found that Claude can handle increasingly more complicated references. Instead of simple markdown files, Claude can reference HTML artifacts created by our new artifacts feature. You may also give Claude references in the form of code. A spec may also be a detailed test suite, or a function in a different codebase that Claude might port. Rubrics are another form of references. Rubrics allow Claude to try and verify your taste in a particular field (e.g. what does a good API design look like) by using dynamic workflows and spinning up verifier agents with those rubrics. Applying this to your context Pulling this all to