{"id":43082451,"url":"https://github.com/jyje/claude-docker","last_synced_at":"2026-07-03T09:01:23.996Z","repository":{"id":335608250,"uuid":"1146024397","full_name":"jyje/claude-docker","owner":"jyje","description":"🧑🏼‍🔧 Claude Code Docker Image, community-powered, lightweight","archived":false,"fork":false,"pushed_at":"2026-07-01T20:05:56.000Z","size":208,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-01T22:04:43.006Z","etag":null,"topics":["agentic-workflow","ai","claude-code","docker","docker-image","workflow"],"latest_commit_sha":null,"homepage":"https://ghcr.io/jyje/claude-docker","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jyje.png","metadata":{"files":{"readme":"readme-ko.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-30T14:23:05.000Z","updated_at":"2026-07-01T20:01:07.000Z","dependencies_parsed_at":"2026-07-01T22:02:05.352Z","dependency_job_id":null,"html_url":"https://github.com/jyje/claude-docker","commit_stats":null,"previous_names":["jyje/claude-docker"],"tags_count":148,"template":false,"template_full_name":null,"purl":"pkg:github/jyje/claude-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jyje%2Fclaude-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jyje%2Fclaude-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jyje%2Fclaude-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jyje%2Fclaude-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jyje","download_url":"https://codeload.github.com/jyje/claude-docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jyje%2Fclaude-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35079379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-workflow","ai","claude-code","docker","docker-image","workflow"],"created_at":"2026-01-31T15:02:21.881Z","updated_at":"2026-07-03T09:01:23.967Z","avatar_url":"https://github.com/jyje.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n  # jyje/claude-docker\n  \n  \u003c!-- center logo --\u003e\n  \u003cimg width=\"150\" src=\"https://raw.githubusercontent.com/lobehub/lobe-icons/refs/heads/master/packages/static-png/light/claude-color.png\" alt=\"Claude\" title=\"Claude\"/\u003e\n  \n  Claude Code: 커뮤니티 도커 이미지\n\n  [![release](https://github.com/jyje/claude-docker/actions/workflows/ci-main.yaml/badge.svg?branch=main)](https://github.com/jyje/claude-docker/actions/workflows/ci-main.yaml)\n  [![test](https://github.com/jyje/claude-docker/actions/workflows/ci-develop.yaml/badge.svg?branch=develop)](https://github.com/jyje/claude-docker/actions/workflows/ci-develop.yaml)\n  [![cron](https://github.com/jyje/claude-docker/actions/workflows/cron-fetch-npm.yaml/badge.svg)](https://github.com/jyje/claude-docker/actions/workflows/cron-fetch-npm.yaml)\n  [![GitHub Repo stars](https://img.shields.io/github/stars/jyje/claude-docker)](https://github.com/jyje/claude-docker)\n\n  [English](readme.md) / [한국어](readme-ko.md)\n\n\u003c/div\u003e\n\n⭐ **이 프로젝트가 유용하셨다면 GitHub Star(⭐)를 부탁드립니다!**\n\n🤖 이 레포지토리는 커뮤니티가 제공하는 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 도커 이미지입니다. Node.js 24 기반으로 빌드되었습니다. 지원 아키텍처: `linux/amd64`, `linux/arm64`.\n\n\u003e [!IMPORTANT]\n\u003e 이 레포지토리는 Anthropic과 제휴 관계가 없습니다. Claude Code 사용자를 위한 도커 이미지를 제공하는 커뮤니티 프로젝트입니다. 공식 정보는 [docs.anthropic.com](https://docs.anthropic.com/en/docs/claude-code)을 참조하세요.\n\n\u003e [!NOTE]\n\u003e **Anthropic 공식 Dockerfile 기반**  \n\u003e 이 도커 이미지는 [Anthropic 공식 Claude Code devcontainer Dockerfile](https://github.com/anthropics/claude-code/blob/main/.devcontainer/Dockerfile)을 기반으로 하며, Node.js 24, 자동화된 CI/CD 파이프라인, 멀티 아키텍처 지원 등 커뮤니티 사용을 위한 개선사항이 추가되었습니다.\n\n## 📚 문서\n\n**시작하기**\n- [한국어 시작 가이드](docs/getting-started-ko.md) - 빠른 시작, 환경 설정, 기본 사용법, 인증, 빠른 테스트\n\n**고급 가이드**\n- [고급 가이드](docs/advanced-guide-ko.md) - Argo Workflows, Kubernetes Jobs/CronJobs, CI/CD 통합\n\n## 환경 변수\n\n| 변수 | 필수 | 설명 |\n|------|------|------|\n| `ANTHROPIC_API_KEY` | 예 | Anthropic API 키. [console.anthropic.com](https://console.anthropic.com/)에서 발급 |\n| `ANTHROPIC_BASE_URL` | 아니오 | 커스텀 API 엔드포인트 URL. 로컬 모델(예: Docker Model Runner) 또는 커스텀 엔드포인트 사용 시 |\n\n\u003e [!TIP]\n\u003e Docker, 쿠버네티스, API 키 인증을 포함한 자세한 사용 예제는 **[시작 가이드](docs/getting-started-ko.md)**를 참조하세요.\n\n## 사전 설치된 유틸리티\n\n이 이미지는 다음 유틸리티가 사전 설치되어 있습니다:\n\n```\n- @anthropic-ai/claude-code (최신 또는 지정된 버전)\n- node 24\n- npm\n\n- git + git-delta (diff 뷰어)\n- zsh + powerline10k 테마\n- fzf (퍼지 파인더)\n- gh (GitHub CLI)\n- jq, curl, wget\n- nano, vim\n- iptables, ipset, iproute2 (네트워크 샌드박스용)\n```\n\n## MCP (Model Context Protocol) 연결\n\nClaude Code는 [MCP](https://modelcontextprotocol.io/)를 통해 GitHub, 데이터베이스, API 등 외부 도구와 데이터 소스에 연결할 수 있습니다.\n\n### 컨테이너 내부에서 MCP 서버 추가\n\n```bash\n# 컨테이너 시작\ndocker run --rm -it \\\n  -e ANTHROPIC_API_KEY \\\n  -v $(pwd):/workspace \\\n  -v claude-mcp-config:/home/node/.claude \\\n  ghcr.io/jyje/claude-docker\n\n# 컨테이너 내부: MCP 서버 추가\nclaude mcp add --transport http github https://api.githubcopilot.com/mcp/\nclaude mcp add --transport http sentry https://mcp.sentry.dev/mcp\nclaude mcp add --transport stdio postgres -- npx -y @bytebase/dbhub --dsn \"postgresql://user:pass@host:5432/db\"\n\n# 설정된 서버 목록 확인\nclaude mcp list\n\n# 서버 상태 확인\n/mcp\n```\n\n### .mcp.json 설정 파일 사용\n\n팀 공유용 MCP 설정을 위해 프로젝트 루트에 `.mcp.json`을 생성하세요:\n\n```json\n{\n  \"mcpServers\": {\n    \"github\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.githubcopilot.com/mcp/\"\n    },\n    \"postgres\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bytebase/dbhub\", \"--dsn\", \"${DATABASE_URL}\"],\n      \"env\": {\n        \"DATABASE_URL\": \"${DATABASE_URL}\"\n      }\n    },\n    \"filesystem\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/workspace\"]\n    }\n  }\n}\n```\n\n마운트하여 실행:\n\n```bash\ndocker run --rm -it \\\n  -e ANTHROPIC_API_KEY \\\n  -e DATABASE_URL=\"postgresql://user:pass@host:5432/db\" \\\n  -v $(pwd):/workspace \\\n  -v $(pwd)/.mcp.json:/home/node/.mcp.json:ro \\\n  ghcr.io/jyje/claude-docker\n```\n\n### 인기 MCP 서버\n\n| 서버 | 명령어 |\n|------|--------|\n| GitHub | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/` |\n| Sentry | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` |\n| PostgreSQL | `claude mcp add --transport stdio postgres -- npx -y @bytebase/dbhub --dsn \"postgresql://...\"` |\n| Filesystem | `claude mcp add --transport stdio fs -- npx -y @modelcontextprotocol/server-filesystem /workspace` |\n\n더 많은 MCP 서버는 [GitHub의 MCP Servers](https://github.com/modelcontextprotocol/servers)를 참조하세요.\n\n## DevContainer 지원\n\n이 레포지토리는 VS Code Dev Containers를 위한 `.devcontainer` 구성을 포함합니다:\n\n1. [Dev Containers 확장](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) 설치\n2. 이 레포지토리 클론\n3. 호스트에 `ANTHROPIC_API_KEY` 환경 변수 설정\n4. VS Code에서 열고 \"Reopen in Container\" 클릭\n\ndevcontainer는 자동으로:\n- 네트워크 샌드박스 (방화벽) 설정\n- powerline10k와 함께 zsh 구성\n- `/workspace`에 워크스페이스 마운트\n- 명령 기록 및 Claude 설정 유지\n\n## CI 파이프라인\n\n이 레포지토리는 자동화된 CI 파이프라인을 통해 두 가지 주요 배포 전략으로 Claude Code 도커 이미지를 빌드하고 관리합니다:\n\n### `main` 브랜치 (프로덕션 릴리즈)\n- **자동 실행**: `main` 브랜치에 커밋되면 릴리즈 이미지가 자동으로 빌드 및 배포됩니다.\n- **태그 전략**: 표준 버전 태그(예: `v2.0.0`)를 생성합니다. 구 버전 패치가 현재 배포된 최신 버전을 덮어쓰는 것을 방지하기 위해, 현재 빌드 대상이 절대적인 최신 버전일 때만 `latest` 및 `major`/`minor` 태그를 적용합니다.\n- **릴리즈 노트**: 상세한 변경 사항(Changelog)과 함께 GitHub Release를 자동으로 생성합니다.\n\n### `develop` 브랜치 (개발용 빌드)\n- **자동 실행**: `develop` 브랜치에 커밋되면 테스트용 이미지가 자동으로 빌드 및 배포됩니다.\n- **태그 전략**: 해시 충돌을 완전히 제거하기 위해 `-dev:[20자리 SHA]` 및 `-dev:latest` 태그를 사용합니다.\n- **스토리지 관리**: 스토리지 공간 최적화를 위해 GHCR에 가장 최근의 개발 이미지 20개만 유지하는 자동 가비지 컬렉션(GC)을 구현했습니다.\n\n### 공통 기능\n- **멀티 아키텍처 지원**: `linux/amd64`와 `linux/arm64` 아키텍처 모두를 지원합니다.\n- **자동 업데이트**: 크론 작업이 6시간마다 새 Claude Code 버전을 확인하고 Pull Request를 자동 생성합니다.\n- **파이프라인 건너뛰기**: 커밋 메시지에 `--no-ci` 플래그를 포함하면 해당 커밋에 대해 CI 파이프라인 실행을 건너뛸 수 있습니다.\n\n## 기여하기\n\n프로젝트에 기여하는 방법은 [기여 가이드라인](contributing.md)을 참조하세요.\n\n## 라이선스\n\n이 프로젝트는 MIT 라이선스로 배포됩니다. 자세한 내용은 [license.md](license.md)를 참조하세요.\n\nClaude Code는 [Anthropic](https://www.anthropic.com/)의 제품입니다. 이 프로젝트는 Anthropic과 제휴 관계가 없습니다.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjyje%2Fclaude-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjyje%2Fclaude-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjyje%2Fclaude-docker/lists"}