시작하기

순서는 넷이에요. agent-bridge 의 서비스 API 를 켜고, autofix 를 올리고, 시험 목록 하나로 끝까지 확인한 뒤, 스캐너를 연결해요.

먼저 있어야 하는 것

직접 올린 agent-bridge 서버 1.320 이상과, 거기에 연결된 맥 한 대. agent-bridge 시작하기를 보세요.
그 맥에 Claude Code, 그리고 push 할 수 있게 로그인된 gh CLI 와 git.
autofix 컨테이너를 올릴 Docker 서버(Dokploy 같은 도구도 좋아요).

1. 토큰 세 개 만들기

서로 다른 곳에서 쓰는 비밀값이 셋 필요해요. 길고 무작위인 값으로 만들어 비밀 저장소에 넣어 두세요.

openssl rand -hex 32   # BRIDGE_SERVICE_TOKEN: autofix → agent-bridge
openssl rand -hex 32   # AUTOFIX_TOKEN: 스캐너 → autofix
openssl rand -hex 16   # VIEW_PASSWORD: 기록 화면 비밀번호

BRIDGE_SERVICE_TOKEN 은 32자 이상이어야 해요. 짧으면 agent-bridge 서버가 뜨지 않아요.

2. agent-bridge 서비스 API 켜기

agent-bridge 서버의 환경 변수에 두 값을 넣고 다시 배포해요.

이름	값
`BRIDGE_SERVICE_TOKEN`	1단계에서 만든 값
`BRIDGE_SERVICE_UID`	세션을 열 사람의 사용자 id (예: `gh12345`)

두 값이 다 있어야 켜져요. 이 토큰으로는 그 사람의 맥에 세션을 여는 것과 토큰으로 연 세션의 상태를 읽는 것만 할 수 있어요. 사람이 직접 연 세션은 읽을 수 없어요.

3. autofix 올리기

저장소 루트의 Dockerfile 로 이미지를 만들어요. 빌드 단계에서 gofmt·vet·test 를 통과해야 이미지가 만들어져요.

docker build -t autofix .
docker run -d --name autofix -p 8080:8080 \
  -v autofix-data:/data \
  -e BRIDGE_URL=https://bridge.example.com \
  -e BRIDGE_HOST="내 맥 이름" \
  -e BRIDGE_WORKDIR="~/src" \
  -e BRIDGE_SERVICE_TOKEN=... \
  -e AUTOFIX_TOKEN=... \
  -e VIEW_USER=me -e VIEW_PASSWORD=... \
  autofix

BRIDGE_HOST 는 agent-bridge 에 보이는 맥 이름(대소문자 무시)이나 id 예요.
BRIDGE_WORKDIR 은 그 맥에서 레포들이 있는 폴더예요. 세션이 여기서 열리고, 없는 레포는 여기에 clone 해요.
/data 에 기록 파일이 쌓이니 꼭 볼륨으로 두세요.

필수 값이 비어 있으면 컨테이너가 시작하지 않고 로그에 빠진 이름을 적어요. 전체 목록은 환경 변수, 운영 팁은 서버 올리기를 보세요.

4. 시험 목록 하나 맡기기

이미 고쳐진 패키지 하나로 시험하면 코드는 바뀌지 않고 흐름만 확인할 수 있어요.

cat > findings.json <<'EOF'
{
  "source": "시험",
  "findings": [
    { "repo": "owner/name", "file": "package-lock.json", "package": "undici",
      "version": "8.11.0", "fixed": "8.12.2", "id": "GHSA-xxxx-xxxx-xxxx", "severity": "MEDIUM" }
  ]
}
EOF
curl -X POST https://autofix.example.com/api/trigger \
  -H "Authorization: Bearer $AUTOFIX_TOKEN" \
  -H 'Content-Type: application/json' -d @findings.json
# 202 {"ok":true,"id":"20261025-0130-a1b2c3","status":"working"}

그다음 이렇게 확인해요.

agent-bridge 화면에 🤖 autofix 20261025-… 세션이 보이는지.
autofix 화면(https://autofix.example.com, Basic 인증)에 그 실행이 대응 중으로 보이는지.
세션이 답을 마치고 2분쯤 지나 상태가 완료로 바뀌고, 결과에 세션의 마지막 답변이 들어오는지.

5. 스캐너 연결하기

시험이 끝나면 매일 도는 스캐너가 같은 형식으로 POST 하게 해요. 남은 취약점이 있을 때만 보내면 돼요. 예시는 스캐너 연결하기를 보세요.

마지막으로 내 레포에 맞는 규칙을 규칙 쓰기를 보고 정해 두면 준비가 끝나요.

시작하기 ​

1. 토큰 세 개 만들기 ​

2. agent-bridge 서비스 API 켜기 ​

3. autofix 올리기 ​