본문 바로가기

Claude Code 2.1.311 출시

Claude Code 2.1.311에서 self-hosted-runner에 --hold-idle-file과 --max-hold-min 옵션이 추가되었습니다. 호스트가 남겨 둔 프로세스를 보고하는 동안 유휴 세션을 유지할 수 있습니다. 또한 Explanatory 출력 스타일에서 설명을 요청할 때 보이는 팁이 추가되었습니다.

글

Claude 공식 릴리스 노트의 새 항목을 AI가 분석·정리한 글입니다. 정확한 내용은 하단 원문에서 확인해 주세요.

🤖 AI 분석 (Claude)

Claude Code 2.1.311에서 self-hosted-runner에 --hold-idle-file과 --max-hold-min 옵션이 추가되었습니다. 호스트가 남겨 둔 프로세스를 보고하는 동안 유휴 세션을 유지할 수 있습니다. 또한 Explanatory 출력 스타일에서 설명을 요청할 때 보이는 팁이 추가되었습니다.

이번 릴리스는 여러 버그를 수정했습니다. CLAUDE.md에 매우 긴 목록 항목이 있을 때의 시작 시 멈춤, MCP 서버 응답 대기 중 중단 지연, 200K 토큰을 넘는 요청에서의 세션 중단, Write·Edit의 지연과 0 lines changed 보고, 서브에이전트의 MCP 도구 사용 불가, 자동 컴팩션 후 오래된 MEMORY.md·CLAUDE.md 내용 사용 등이 포함됩니다. 원문 목록이 중간에서 끊겨 있어 나머지 항목은 확인할 수 없습니다.

왜 중요한가

이번 릴리스는 새 기능보다 버그 수정이 많아, 긴 파일이나 긴 대화를 다룰 때 멈춤과 중단 지연이 줄어듭니다. 특히 대화가 200K 토큰을 넘어도 세션이 중단되지 않고 이어질 수 있게 되었습니다.

이전과 다른 점

이전에는 200K 토큰을 넘는 요청에서 'Usage credits required for 1M context' 메시지와 함께 세션이 멈췄지만, 이제는 대화를 압축하고 계속 진행합니다. 또한 Write와 Edit가 수천 줄을 바꿀 때 최대 5초 멈추고 0 lines changed로 보고하던 동작이 수정되었습니다.

실제로 써보려면

self-hosted-runner 명령에 --hold-idle-file과 --max-hold-min 옵션을 지정해 사용합니다. Explanatory 출력 스타일을 선택하면 설명을 요청할 때 팁이 표시됩니다.

⚠️ AI가 원문을 바탕으로 생성한 분석입니다. 사실 확인은 아래 원문에서 해 주세요.

핵심 정리 Claude Code 2.1.311 출시 1 self-hosted-runner에 --hold-idle-file, --max-hold-min 옵션 추가 2 Explanatory 출력 스타일에 설명 요청 시 보이는 팁 추가 3 200K 토큰 초과 시 세션 중단 대신 대화를 압축하고 계속 진행 4 SubagentStop 훅이 서브에이전트당 분당 약 2회 실행되던 문제 수정

변경 내용 (원문)

  • Added --hold-idle-file and --max-hold-min to self-hosted-runner, to keep an idle session while your host reports processes it left running
  • Added a tip for the Explanatory output style, shown when you ask Claude for explanations
  • Fixed long freezes at startup and after reading or editing files when a CLAUDE.md file holds a very long list item
  • Fixed interrupting Claude not taking effect until a timeout while an MCP server had not answered a resource read or a skill was still downloading
  • Fixed standard-context sessions stopping with "Usage credits required for 1M context" when a request ran over 200K tokens; Claude Code now compacts the conversation and continues
  • Fixed Write and Edit stalling for up to 5 seconds after they ran, and reporting 0 lines changed, when changing thousands of lines in a file
  • Fixed subagents being unable to use MCP tools from servers that finish connecting after the subagent starts
  • Fixed Claude seeing stale MEMORY.md and CLAUDE.md content right after automatic compaction when those files were edited earlier in the session
  • Fixed claude -p and SDK sessions saving transcript messages out of order or keeping messages that were taken back
  • Fixed SubagentStop hooks running about twice a minute for each running subagent instead of once when it finishes
  • Fixed the @ file picker ignoring .ignore/.rgignore negation rules that re-include git-ignored files
  • Fixed a subagent's isolated worktree being removed while a background subage

출처: Claude Code 변경로그 (원문 보기)

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요