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 の tag モードで `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` を使用します。`paths` を使用するのは `delete_files` のみです。回帰テストでは、MCP ツールスキーマをインポートし、プロンプト例内のパラメータ名が対応するスキーマと一致することを検証する必要があります。

Question 3

claude_args 経由で渡されたカスタム Bash ツールが、Claude のプルリクエストレビュー中に無視されるのはなぜですか？

Accepted Answer

`pull_request` イベントでは、このアクションが `tag` モードを自動検出します。このモードでは、`mcp__github_` で始まるユーザー指定の MCP ツールのみがデフォルトの許可リストにマージされます。`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"
```

キャメルケースのフラグ `--allowedTools` を使用してください。`--allowed-tools` は認識されない場合があります。この動作は claude-code-action v1.0.22 で確認されました。

Question 4

ブランチ名に `#` が含まれている場合に GitHub のブランチリンクが壊れる問題を修正するにはどうすればよいですか?

Accepted Answer

GitHubの`tree`またはcompare 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
```

tracking-commentやbranch-cleanupのコードを含め、ブランチURLが作成されるすべての箇所にこのエンコーディングを適用してください。一時的な回避策として、生成するブランチ名で`#`の使用を避けるか、リンク内の`#`を手動で`%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` に解決され、早期の auto-compaction が発生します。

解決された上限を確認するには、`show_full_output: true` を有効にして、ジョブログ内の `modelUsage` オブジェクトを確認してください：

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

注意：`[1m]` サフィックスを付けても、`maxOutputTokens` は引き続き `64000` と報告される場合があります。この値はコンテキストウィンドウセレクターとは別に解決されます。

claude-code-action

概要

README プレビュー

FAQ (5)

同类型项目

vscode

FreeDomain

stable-diffusion-webui

paperclip