halfjuice/claude-code

Claude Code Docker 镜像

镜像概述

Claude Code Docker是一个基于Alpine的轻量级Docker镜像，用于运行Claude Code——Anthropic推出的智能命令行工具。该镜像设计简洁，体积小于200MB，启动快速，适合在各种环境中便捷部署和使用Claude Code。

• Docker镜像地址：https://hub.docker.com/r/halfjuice/claude-code
• 项目源码地址：https://github.com/halfjuice/claude-code-docker

核心功能与特性

• 轻量级设计：基于Alpine Linux构建，镜像体积小于200MB，资源占用低
• 快速启动：优化的镜像结构确保工具快速启动和运行
• 命令行交互：支持Claude Code的完整命令行交互功能
• 环境隔离：通过Docker容器提供独立运行环境，避免系统依赖冲突
• 项目挂载支持：可挂载本地项目目录，方便Claude Code处理本地文件

使用场景

• Windows环境下运行Claude Code（解决原生依赖问题）
• 需要快速部署Claude Code的开发环境
• 多环境一致性部署（确保不同系统上的运行效果一致）
• 临时或隔离的代码分析、辅助编程场景

使用方法

基本运行

通过以下命令启动Claude Code容器，需替换your-api-key为实际的Anthropic API密钥：

bash
docker run -it \
  -e ANTHROPIC_API_KEY="your-api-key" \
  docker.xuanyuan.run/halfjuice/claude-code:latest

挂载项目目录

如需让Claude Code访问本地项目文件，可挂载当前目录到容器内的工作空间：

bash
docker run -it \
  -e ANTHROPIC_API_KEY="your-api-key" \
  -v $(pwd):/home/claude-user/workspace \
  docker.xuanyuan.run/halfjuice/claude-code:latest

注意事项

• Claude Code目前处于研究预览阶段，功能可能会有变化，请参考https://docs.anthropic.com获取最新信息
• 可通过扩展Dockerfile添加额外工具以满足特定需求
• 生产环境使用时，建议根据实际需求添加特定的语言运行时和开发工具
• 确保API密钥的安全管理，避免在非安全环境中暴露密钥