diff --git a/.github/workflows/claude-issue-agent.yml b/.github/workflows/claude-issue-agent.yml
index 71ab06847..0694811b8 100644
--- a/.github/workflows/claude-issue-agent.yml
+++ b/.github/workflows/claude-issue-agent.yml
@@ -26,6 +26,8 @@ jobs:
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           github_token: ${{ secrets.GITHUB_TOKEN }}
+          # surface the underlying API error when a run fails on the first turn
+          show_full_output: true
           # Issues come from external users without write access; this workflow's
           # token is scoped to labels/comments/PR only. Issue body is treated as
           # untrusted data in the prompt.