Question 1

Claude Code Action이 리뷰를 실행하기 전에 "subtype: success"와 "is_error: true"로 간헐적으로 실패하는 이유는 무엇인가요?

Accepted Answer

일반적으로 이는 코드 리뷰가 완료된 후 실패한 것이 아니라 Claude 프로세스가 시작 중에 실패했음을 의미합니다. `claude-execution-output.json`을 확인하고 `result` 필드를 읽어 보세요. 보고된 사례에서는 해당 필드에 `Credit balance is too low`가 포함되어 있었습니다. Anthropic API 계정의 결제/크레딧 잔액을 확인하고 크레딧을 추가한 후 워크플로우를 다시 실행하여 문제를 해결하세요. 시작 실패는 일반적으로 리뷰 집계나 결과 없이 `is_error: true`로 표시되며, 예를 들어 `spawned: 0`과 같이 나타납니다. 이는 결과를 보고하는 완료된 리뷰와는 구분됩니다.

Question 2

Claude Code Action 태그 모드에서 files와 paths 매개변수 불일치로 발생하는 delete_files 스키마 유효성 검사 오류는 어떻게 수정하나요?

Accepted Answer

`mcp__github_file_ops__delete_files` 도구 스키마는 `paths`를 받지만, 태그 모드 프롬프트 예제에서는 잘못되게 `files`를 사용하고 있습니다. 이로 인해 `use_commit_signing: true`가 활성화된 경우 Zod 검증이 첫 번째 삭제 시도를 거부하게 됩니다.

`src/create-prompt/index.ts`에서 프롬프트 예제를 수정하세요 (827행 근처):

```diff
- mcp__github_file_ops__delete_files: {"files": ["path/to/old.js"], "message": "chore: remove deprecated file"}
+ mcp__github_file_ops__delete_files: {"paths": ["path/to/old.js"], "message": "chore: remove deprecated file"}
```

그런 다음 액션을 다시 빌드/릴리스하거나 해당 수정이 포함된 릴리스를 사용하세요. 기존 실행에서는 `paths`를 사용하여 도구 호출을 재시도하면 실패한 호출을 우회할 수 있습니다:

```json
{"paths": ["path/to/old.js"], "message": "chore: remove deprecated file"}
```

`commit_files`는 여전히 `files`를 사용한다는 점에 유의하세요. `delete_files`만 `paths`를 사용합니다. 회귀 테스트에서는 MCP 도구 스키마를 가져와(import) 프롬프트 예제의 매개변수 이름이 해당 스키마와 일치하는지 확인해야 합니다.

Question 3

Claude 풀 리퀘스트 검토 중에 claude_args를 통해 전달된 사용자 정의 Bash 도구가 무시되는 이유는 무엇인가요?

Accepted Answer

`pull_request` 이벤트의 경우, action은 `tag` 모드를 자동으로 감지하며, 이 모드에서는 `mcp__github_`로 시작하는 사용자 제공 MCP 도구만 기본 allowlist에 병합됩니다. `Bash(npx markdownlint:*)` 또는 `Bash(gh pr:*)`와 같은 사용자 정의 규칙은 파싱되지만 필터링되어 제외됩니다.

사용자 정의 Bash 도구를 사용하려면 워크플로우에서 `mode: agent`를 명시적으로 설정하세요:

```yaml
- uses: anthropics/claude-code-action@v1
  with:
    mode: agent
    claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
    prompt: |
      Run `npx markdownlint *.md` to check markdown files.
    claude_args: |
      --allowedTools "Bash(npx markdownlint:*),Read,Glob"
```

camel-case 플래그인 `--allowedTools`를 사용하세요. `--allowed-tools`는 인식되지 않을 수 있습니다. 이 동작은 claude-code-action v1.0.22에서 관찰되었습니다.

Question 4

브랜치 이름에 `#`가 포함될 때 GitHub 브랜치 링크가 깨지는 문제를 어떻게 해결하나요?

Accepted Answer

GitHub `tree` 또는 비교 URL에 삽입하기 전에 브랜치 이름의 각 경로 세그먼트를 URL 인코딩하되, `/`는 경로 구분자로 그대로 유지하세요:

```ts
const encodedBranch = branchName
  .split("/")
  .map(encodeURIComponent)
  .join("/");
```

예를 들어, `claude/fix#123`은 `claude/fix%23123`이 되며, 생성된 링크는 다음과 같습니다:

```text
https://github.com/owner/repo/tree/claude/fix%23123
```n
브랜치 URL이 생성되는 모든 곳(tracking-comment 및 branch-cleanup 코드 포함)에 이 인코딩을 적용하세요. 임시 해결 방법으로, 생성되는 브랜치 이름에 `#`를 사용하지 않거나 링크에서 `#`를 `%23`으로 수동으로 교체하세요.

Question 5

GitHub Actions에서 Claude Opus 5 또는 Sonnet 5가 1M 대신 200k 컨텍스트 윈도우로 확인되는 문제를 어떻게 해결하나요?

Accepted Answer

워크플로 구성의 모델 ID에 `[1m]` 컨텍스트 선택자를 추가하세요:

```yaml
env:
  ANTHROPIC_MODEL: claude-opus-5[1m]
  ANTHROPIC_SMALL_FAST_MODEL: claude-sonnet-5[1m]
```

`ANTHROPIC_BASE_URL` 게이트웨이로 인해 Claude Code가 네이티브 1M 컨텍스트 지원을 자동으로 감지하지 못하는 경우 이 설정이 필요합니다. 이 해결 방법은 action v1.0.185와 Claude Code 2.1.222에서 검증되었습니다: `claude-opus-5[1m]`은 `modelUsage.contextWindow`가 `1000000`으로 확인되지만, `claude-opus-5`는 `200000`으로 확인되어 조기 자동 압축이 발생합니다.

적용된 제한 값을 확인하려면 `show_full_output: true`를 활성화하고 작업 로그에서 `modelUsage` 객체를 살펴보세요:

```json
"contextWindow": 1000000
```

참고: `[1m]` 접미사를 사용하더라도 `maxOutputTokens`는 여전히 `64000`으로 표시될 수 있습니다. 이 값은 컨텍스트 윈도우 선택자와는 별도로 결정됩니다.

claude-code-action

개요

README 미리보기

FAQ (5)

同类型项目

vscode

FreeDomain

stable-diffusion-webui

paperclip