구독 로그인 정보를 활용해 Docker에서 Claude Code 실행하기 — 프로젝트 마운트 및 컨테이너 내 명령 유지

Claude Code를 내 컴퓨터에 직접 까는 대신 Docker 컨테이너 안에서 돌리고 있는데, 워크플로우 안 바꾸면서도 깔끔하게 격리해서 쓰고 싶은 사람들을 위해 설정 공유함.

핵심은 이거임: 미리 빌드된 이미지 하나 땡겨오고, 내 레포지토리랑 기존 ~/.claude 로그인 정보 마운트한 다음 셸 별칭(alias) 하나만 추가하면 끝. Claude Code는 컨테이너 안에서 돌아가고, 프로젝트는 바인드 마운트되니까 수정 사항은 내 로컬 디스크에 바로 반영됨.

Docker가 외부 방어막 역할을 해줌. 컨테이너 안에서는 --dangerously-skip-permissions 옵션을 써서 Claude가 빌드, 테스트, npm 같은 거 돌릴 때마다 권한 물어보느라 멈추는 일 없게 했음. 어차피 커밋하기 전에 diff 확인은 직접 하니까 "AI가 알아서 다 하겠지" 하고 맹신하는 거랑은 다름.

퀵 스타트

• Docker 설치

• 호스트 컴퓨터에서 Claude Code에 한 번 로그인해두기 (그래야 ~/.claude 폴더가 생김)

• ~/.zshrc나 ~/.bashrc에 이거 추가:

alias claude='claude-code' ```

- 설정 적용하고 아무 프로젝트 폴더에서나 실행:
bash source ~/.zshrc cd ~/my-app && claude-code

처음 실행할 때 이미지를 받아옴. 따로 레포지토리 클론할 필요 없음.

claude-code 이미지 구성

- Claude Code CLI (공식 설치 스크립트)

- full 태그에는 Node, Python, Go, Rust 포함

- full 태그에는 Playwright + Chromium 포함 (브라우저/테스트 워크플로우용)

- 멀티 아키텍처 지원: amd64 + arm64
다 필요 없으면 더 가벼운 버전도 있음: claude-node , claude-python , claude-go , claude-rust .

추가 옵션

Git/SSH (호스트에서 읽기 전용으로 가져오기):

bash -v "$HOME/.gitconfig:/root/.gitconfig:ro" \ -v "$HOME/.ssh:/root/.ssh:ro"

구독 로그인 대신 API 키 사용:

```bash -e ANTHROPIC_API_KEY

또는
-e CLAUDE_CODE_OAUTH_TOKEN ```

macOS에서 Docker Desktop 쓰는데 파일 동기화가 좀 느린 것 같으면 볼륨 마운트 뒤에 :cached 붙여보셈.

이게 되는 거 / 안 되는 거

- 되는 거: Claude Code가 쓰는 셸 명령어들을 내 호스트 OS랑 분리함, 기존 Claude Pro/Max 구독 인증 정보(~/.claude) 그대로 재사용 가능

- 안 되는 거: 프로젝트 숨기기 — 레포지토리는 설계상 마운트되고 쓰기 권한도 열려 있음

- 안 되는 거: 코드 리뷰 대체하기 — 푸시하기 전에 얘가 뭘 바꿨는지 직접 읽어봐야 함
링크

GitHub: [https://github.com/sayem314/ai-agents](https://github.com/sayem314/ai-agents)

Docker Hub: [https://hub.docker.com/r/sayem314/ai-agents](https://hub.docker.com/r/sayem314/ai-agents)

Claude Code 전용 문서: [https://github.com/sayem314/ai-agents/blob/main/docs/claude-code.md](https://github.com/sayem314/ai-agents/blob/main/docs/claude-code.md)
같은 레포에 Codex나 OpenCode 쓰는 사람들을 위한 Docker 래퍼도 있으니 참고하셈.