AI 팁 리포트

[Docs 댓글 요청 문구]
이 AGENTS.md는 Claude Code·Codex가 매 세션 읽는 규칙입니다.
아래 기준으로 댓글 부탁드립니다.
1. '프로젝트 고유 규칙'에 빠진 팀 규칙이 있는가 (예: 프리팹 네이밍, 금지 API)
2. '결정 표'에서 실제 팀 선택과 다른 줄이 있는가 (예: 비동기 처리 UniTask/Awaitable)
3. 지워도 실수하지 않을 줄이 있는가 → 삭제 제안
확정된 내용은 저장소의 AGENTS.md 원본에 반영합니다.

Ben's Bites

## [중] AGENTS.md를 Google Docs로 팀 검토
- 무엇: Google Docs가 이제 **Markdown 파일을 변환 없이** 엽니다. AGENTS.md 같은 지침 파일을 팀이 Docs에서 함께 편집하고 댓글을 달 수 있습니다.
- 왜: (추론) 지침 파일을 저장소 안에서만 고치면 기획·아트 등 비개발 팀원이 **규칙 검토**에 참여하기 어렵습니다.
- 어떻게:
  1. AGENTS.md(또는 CLAUDE.md)를 Google Drive에 올린다
  2. Google Docs로 열어 단락별로 **댓글**을 받는다
  3. 확정된 수정은 저장소의 원본 파일에 반영한다
- 결과: (추론) 지침 규칙을 팀이 함께 검토해 **빠진 함정·낡은 규칙**을 더 일찍 찾습니다. 기능은 앞으로 2주에 걸쳐 순차 적용됩니다.

```
[Docs 댓글 요청 문구]
이 AGENTS.md는 Claude Code·Codex가 매 세션 읽는 규칙입니다.
아래 기준으로 댓글 부탁드립니다.
1. '프로젝트 고유 규칙'에 빠진 팀 규칙이 있는가 (예: 프리팹 네이밍, 금지 API)
2. '결정 표'에서 실제 팀 선택과 다른 줄이 있는가 (예: 비동기 처리 UniTask/Awaitable)
3. 지워도 실수하지 않을 줄이 있는가 → 삭제 제안
확정된 내용은 저장소의 AGENTS.md 원본에 반영합니다.
```

출처: https://www.bensbites.com/p/thoughts-from-san-francisco

# 팀 README / docs 설치 안내
claude plugin install <플러그인 이름> --marketplace <마켓플레이스 source>

GitHub 릴리스 anthropics/claude-code

## [중] 플러그인 설치를 한 줄로
- 무엇: `claude plugin install`에 **--marketplace <source>** 옵션이 추가되어, 마켓플레이스 등록과 플러그인 설치를 한 번에 합니다.
- 왜: (추론) 지금은 `claude plugin marketplace add` 후 다시 install을 해야 해서 **팀원 설치 안내**가 두 단계로 나뉩니다.
- 어떻게:
  1. Claude Code를 v2.1.292 이상으로 업데이트한다
  2. `claude plugin install <플러그인> **--marketplace <source>**`를 실행한다
  3. 마켓플레이스가 없으면 추가되고, `marketplace add`와 같은 정책 검사를 거친다
- 결과: (추론) 팀 공용 플러그인의 설치 안내를 **명령 한 줄**로 줄일 수 있습니다.

```
# 팀 README / docs 설치 안내
claude plugin install <플러그인 이름> --marketplace <마켓플레이스 source>
```

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.292

# PowerShell (값은 예시, 밀리초)
$env:CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS = "5000"
claude

GitHub 릴리스 anthropics/claude-code

## [하] 529 과부하 재시도 간격 늘리기
- 무엇: **CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS** 환경 변수로 과부하(529) 요청을 재시도할 때의 기본 대기 시간을 늘릴 수 있습니다.
- 왜: (추론) 서버 과부하 때 재시도 간격이 짧으면 **연속 실패**로 긴 작업이 중간에 멈추기 쉽습니다.
- 어떻게:
  1. Claude Code를 v2.1.292 이상으로 업데이트한다
  2. 터미널에서 **환경 변수**를 밀리초 단위로 설정한 뒤 claude를 실행한다
- 결과: (추론) 혼잡 시간대에 오래 돌리는 세션이 **재시도 실패로 끊기는 일**이 줄어듭니다.

```
# PowerShell (값은 예시, 밀리초)
$env:CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS = "5000"
claude
```

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.292