자체 호스팅 환경에서 세션 사용자 정의

claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --exec-path /etc/claude/session-wrapper.sh

exec 4<&0
"$CLAUDE_RUNNER_CLAUDE_BIN" "$@" <&4 4<&- &
CHILD=$!
trap 'teardown' EXIT
wait "$CHILD"

#!/bin/bash
# 안정적인 Anthropic 사용자 ID를 기반으로 하고 인간 작성자를 요구합니다.
CREATOR_SUB=$("$CLAUDE_RUNNER_CLAUDE_BIN" self-hosted-runner decode-token \
  | jq -re '.act.sub // "" | select(startswith("user:"))') \
  || { echo "decode-token: verification failed or no human creator" >&2; exit 1; }

creds=$(your-sts-helper assume-role --subject "$CREATOR_SUB") \
  || { echo "credential exchange failed" >&2; exit 1; }
eval "$creds"

exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@"

#!/bin/bash
set -u
IFS=':'
# 체크아웃의 .git/config에 세션이 심을 수 있는 구성을 고정합니다:
# -c 재정의는 저장소 로컬 설정을 이기므로 세션 작성 fsmonitor,
# 훅 경로 및 gpg-program 구성이 훅의 권한으로 코드를 실행하는 것을 차단합니다.
# 저장소 로컬 credential.helper, core.sshCommand 및 pushurl
# 여전히 적용됩니다. 훅이 세션이 가지지 않은 자격증명을 보유하면 푸시 URL 및 도우미도 고정하세요
# (아래 스크립트의 참고 사항 참조).
g() { git -c core.fsmonitor=false -c core.hooksPath=/dev/null \
        -c commit.gpgsign=false "$@"; }
for ws in $CLAUDE_RUNNER_WORKSPACE_PATHS; do
  cd "$ws" 2>/dev/null || continue
  [ -z "$(g status --porcelain 2>/dev/null)" ] && continue
  g add -A
  g commit -q -m "runner snapshot: $CLAUDE_RUNNER_SESSION_ID ($CLAUDE_RUNNER_EXIT_REASON)" || continue
  g push -q origin "HEAD:refs/heads/rescue/$CLAUDE_RUNNER_SESSION_ID" || true
done

claude self-hosted-runner orchestrator \
  --environment-secret-file /etc/claude/environment-secret \
  --hooks-dir /etc/claude/hooks

RUN claude mcp add --scope user sidecar -- /usr/local/bin/mcp-sidecar
RUN claude mcp add --scope user --transport http internal http://mcp-gateway.svc.cluster.local:8080

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "timeout": 10,
            "command": "\"$CLAUDE_CONFIG_DIR/hooks/stop-hook-nudge.sh\""
          }
        ]
      }
    ]
  }
}

#!/bin/sh
# 자체 호스팅 러너용 Stop 훅 참조 구현입니다.
#
# 프로젝트 디렉토리에 커밋되지 않은 변경 사항 또는 푸시되지 않은 커밋이 있으면
# 턴당 한 번 Claude에 프롬프트하므로 유휴 세션이 해제될 때 작업이 손실되지 않고
# claude.ai/code의 "Create PR" 버튼이 켜집니다.
#
# 러너 수준(저장소 변경 없음): 이 파일을 러너 호스트의 ~/.claude/hooks/에 놓고
# 함께 제공되는 Stop 훅 설정 블록을 ~/.claude/settings.json에 병합합니다.
# 러너가 둘 다 모든 세션에 시드합니다.
# 저장소 수준 대안: <repo>/.claude/hooks/에 커밋하고 settings.json 명령 경로를
# $CLAUDE_PROJECT_DIR/.claude/hooks/로 변경합니다.
#
# stdin: 훅 JSON 페이로드 (https://code.claude.com/docs/en/hooks 참조)
# stdout: {"decision":"block","reason":"..."} 프롬프트하거나 중지를 허용하려면 아무것도 없음.

# 재진입 가드: 하네스는 Stop 훅을 다시 호출할 때 stop_hook_active=true를 설정합니다.
# 블록 후. 종료하므로 턴당 한 번만 프롬프트합니다. 하네스는 컴팩트 JSON을 내보냅니다
# (콜론 뒤에 공백 없음). 이 패턴이 의존하는 것입니다. 공백 허용이 필요하면 jq를 사용하세요.
in=$(cat)
case "$in" in *'"stop_hook_active":true'*) exit 0 ;; esac

d="$CLAUDE_PROJECT_DIR"

# git 저장소가 아님 → 프롬프트할 것이 없습니다.
git -C "$d" rev-parse --git-dir >/dev/null 2>&1 || exit 0

# 원격이 없음 → "원격으로 푸시"는 불가능합니다. 종료합니다.
[ -z "$(git -C "$d" remote 2>/dev/null)" ] && exit 0

# 커밋되지 않은 변경 사항 (스테이징됨, 스테이징되지 않음 또는 추적되지 않음).
# .claude/ 전체 제외 — 운영자 시드 설정 및 CLI 작성 런타임 상태
# (스케줄러 잠금, 작업 트리, 루틴 상태)가 있으며 둘 다
# "커밋되지 않은 작업"이 아니며 모델이 푸시해야 합니다.
s=$(git -C "$d" status --porcelain -- . ':(exclude).claude/' 2>/dev/null)
if [ -n "$s" ]; then
  printf '{"decision":"block","reason":"There are uncommitted changes in the repository. Please commit and push these changes to the remote branch."}'
  exit 0
fi

# 푸시되지 않은 커밋. 모든 원격 추적 ref 또는 FETCH_HEAD에서 도달할 수 없는
# HEAD의 커밋 수를 계산합니다. 이는 다음에 대해 균일하게 작동합니다:
#   - init+fetch 체크아웃 (러너 기본값: FETCH_HEAD만 존재)
#   - 복제 기반 체크아웃 (origin/* 존재)
#   - 러너 기본값: 자식이 세션의 결과 분기에서 시작합니다.
#     러너가 체크아웃 후 생성합니다.
#   - 분리된 HEAD, 사용자 정의 설정이 해당 분기 생성을 건너뛸 때
# 모든 참조 지점이 없으면 (절대 페치되지 않음) 읽기 전용 턴에서
# 거짓 양성을 피하기 위해 침묵합니다.
base=""
git -C "$d" rev-parse --verify -q FETCH_HEAD >/dev/null && base="FETCH_HEAD"
if [ -z "$base" ] && [ -z "$(git -C "$d" for-each-ref --count=1 refs/remotes/origin 2>/dev/null)" ]; then
  exit 0
fi
# shellcheck disable=SC2086  # $base는 "" 또는 "FETCH_HEAD"이며 의도적 단어 분할입니다.
unpushed=$(git -C "$d" rev-list HEAD --not $base --remotes=origin --count 2>/dev/null) || unpushed=0
if [ "$unpushed" -gt 0 ]; then
  branch=$(git -C "$d" symbolic-ref --short -q HEAD)
  if [ -n "$branch" ]; then
    # $branch는 공격자 영향을 받습니다 — git-check-ref-format(1)은 `"`를 허용합니다.
    # ref 이름에서. `\`는 금지됩니다 (규칙 10) 하지만 저렴한 방어 심화로 어쨌든 이스케이프됩니다.
    # 손으로 빌드된 페이로드에 보간하기 전에 JSON 메타문자를 이스케이프하므로
    # x","continue":false와 같은 분기는 하네스가 구문 분석하는 훅 출력 JSON에
    # 키를 주입할 수 없습니다. $unpushed는 안전합니다 — -gt 가드 위는
    # 일반 정수가 아닌 모든 것을 거부합니다.
    branch_esc=$(printf '%s' "$branch" | sed 's/\\/\\\\/g; s/"/\\"/g')
    printf '{"decision":"block","reason":"There are %s unpushed commit(s) on branch '\''%s'\''. Please push these changes to the remote repository."}' "$unpushed" "$branch_esc"
  else
    printf '{"decision":"block","reason":"There are %s unpushed commit(s) on a detached HEAD. Please create a branch and push it to the remote repository."}' "$unpushed"
  fi
  exit 0
fi

exit 0

#!/bin/bash
exec "$CLAUDE_RUNNER_CLAUDE_BIN" "$@" --permission-mode auto