Skip to content

Releases: cfrs2005/claude-code-mobile

v1.0.5 - Latest Dependencies Update

20 Jan 01:29

Choose a tag to compare

🎉 What's New

This release rebuilds the Docker image with the latest stable versions of all dependencies.

📦 Dependency Updates

  • Claude Code: Updated to v2.1.12 (latest stable release)
  • Happy-coder: Updated to latest version
  • All npm dependencies refreshed to current stable versions

📝 Documentation

  • Added explicit version information in README
  • Users can now see which Claude Code version is included

🐳 Docker Images

# Pull latest version
docker pull cfrs2005/claude-code-mobile:v1.0.5
docker pull cfrs2005/claude-code-mobile:latest

📥 How to Update

For existing users:

docker-compose pull
docker-compose up -d

For new users:

git clone https://github.com/cfrs2005/claude-code-mobile.git
cd claude-code-mobile
cp config.env.example config.env
# Edit config.env with your API token
docker-compose -f docker-compose.prod.yml up -d

🔗 Links

Release v1.0.4: Fix Happy startup crash

13 Sep 12:08

Choose a tag to compare

🐛 Bug Fixes

Happy Startup Crash Fixed

  • Removed problematic --dangerously-skip-permissions parameter that was causing Happy to crash on startup
  • Eliminated IS_SANDBOX environment variable logic that was conditionally adding the problematic parameter
  • Ensured stable startup behavior for all deployment environments

📦 Docker Images

The following Docker images have been updated and pushed to Docker Hub:

  • cfrs2005/claude-code-mobile:v1.0.4
  • cfrs2005/claude-code-mobile:latest

🔄 Migration Notes

If you were using the IS_SANDBOX environment variable:

  • This variable is no longer used or required
  • Remove it from your config.env file if present
  • The service will now start consistently without special sandbox handling

🚀 Usage

# For new deployments
docker-compose -f docker-compose.prod.yml up

# For existing deployments
docker-compose down
docker-compose pull
docker-compose up

🤖 Generated with Claude Code

Release v1.0.3: Enhanced Docker Configuration and Security Documentation

08 Sep 11:32

Choose a tag to compare

🚀 Release v1.0.3: Enhanced Docker Configuration and Security Documentation

✨ New Features

  • Sandbox Mode Support: Added IS_SANDBOX=1 environment variable for enhanced security
  • Improved Claude Code Installation: Switched to npm-based installation for better reliability
  • Enhanced Security Documentation: Added comprehensive Happy daemon process management guide

🔧 Configuration Changes

  • Working Directory: Updated to /workspace for better project organization
  • Conditional Arguments: Smart handling of --dangerously-skip-permissions flag based on environment
  • Environment Variables: Enhanced config.env.example with sandbox mode configuration

📚 Documentation Updates

  • Security Section: Added detailed Happy daemon management with official commands
  • Process Control: Included happy daemon stop, happy doctor clean instructions
  • Bilingual Support: Updated both English and Chinese documentation
  • Security Best Practices: Comprehensive security considerations for production use

🐳 Docker Improvements

  • Reliability: More stable Claude Code installation process
  • Performance: Optimized container startup and configuration
  • Security: Enhanced permission handling in sandbox environments

📦 Available Images

  • cfrs2005/claude-code-mobile:v1.0.3
  • cfrs2005/claude-code-mobile:latest

🛠️ Technical Changes

  • Switch from curl-based to npm-based Claude Code installation
  • Improved entrypoint.sh with conditional argument processing
  • Enhanced configuration template with security options
  • Updated documentation with official Happy daemon commands

🤖 Generated with Claude Code

Full Changelog: v1.0.2...v1.0.3

Release v1.0.2: Complete Ugreen NAS Deployment Documentation

03 Sep 16:58

Choose a tag to compare

🎯 What's New in v1.0.2

📖 Complete Ugreen NAS Support

  • 🇨🇳 Chinese Deployment Guide: Step-by-step manual for Ugreen NAS users (docs/绿联NAS部署手册.md)
  • 🇺🇸 English Deployment Guide: Complete English version for international users (docs/ugreen-nas-deployment-guide.md)
  • 📸 Visual Installation Guide: 11 detailed screenshots showing every configuration step
  • 🔧 Volume Configuration: Detailed storage mapping and container setup instructions

🛠️ Enhanced Documentation

  • Professional step-by-step deployment process (8 clear steps)
  • Comprehensive troubleshooting section with common issues and solutions
  • Advanced container management and maintenance procedures
  • Security best practices and access control recommendations
  • Mobile usage optimization tips

📱 Improved User Experience

  • Clear visual guides for Docker container configuration
  • Detailed authentication and API setup instructions
  • Mobile app connection and usage guidelines
  • Resource monitoring and backup recommendations

🚀 Getting Started

For Ugreen NAS users:

  • Follow the detailed guides in docs/ directory
  • Use the visual screenshots for step-by-step configuration
  • Both Chinese and English versions available

For general Docker deployment:

  • Continue using existing docker-compose.prod.yml
  • All deployment methods remain compatible

📦 Container Image

Docker Hub: cfrs2005/claude-code-mobile:latest

  • Multi-architecture support (amd64, arm64)
  • Auto-configuration with persistent authentication
  • Production-ready for NAS and server deployment

Full Changelog: v1.0.1...v1.0.2

Claude Code Mobile Service v1.0.1

03 Sep 14:25

Choose a tag to compare

🚀 Claude Code Mobile Service v1.0.1

📝 更新内容 / What's New

文档完善 / Documentation Enhancements

  • ✨ 分离中英文文档 (README.md + README.zh-CN.md)
  • 🎨 添加专业 SVG 架构图
  • 📋 增强安装说明,明确两步认证流程
  • 🔧 完善生产环境部署指南

项目结构优化 / Project Structure

  • 📁 专业开源项目结构和徽章
  • 🔒 完善 .gitignore 保护敏感数据
  • 📖 记录完整发布流程到 CLAUDE.md

🔧 快速开始 / Quick Start

中文用户

git clone https://github.com/cfrs2005/claude-code-mobile.git
cd claude-code-mobile
cp config.env.example config.env
# 编辑 config.env 添加 API 令牌
docker-compose -f docker-compose.prod.yml up -d
docker exec -it claude-code-mobile_happycoder_1 happy  # 首次认证
docker-compose restart  # 重启生效

English Users

git clone https://github.com/cfrs2005/claude-code-mobile.git
cd claude-code-mobile
cp config.env.example config.env
# Edit config.env with your API token
docker-compose -f docker-compose.prod.yml up -d
docker exec -it claude-code-mobile_happycoder_1 happy  # First-time auth
docker-compose restart  # Restart to activate

📦 Docker Hub

  • cfrs2005/claude-code-mobile:v1.0.1
  • cfrs2005/claude-code-mobile:latest

查看完整文档 / Full Documentation: README.md | 中文文档

Claude Code Mobile Service v1.0.0

03 Sep 14:14

Choose a tag to compare

🚀 Claude Code Mobile Service v1.0.0

这是 Claude Code Mobile Service 的首次发布 - 一个容器化解决方案,让你可以在手机上使用 Claude Code。

✨ 主要特性

  • 📱 移动端访问: 通过 Happy-coder 应用在手机上使用 Claude Code
  • 🐳 容器化部署: 使用 Docker 和 Docker Compose 轻松部署
  • 🔧 自动设置: 自动处理交互式初始化
  • 💾 数据持久化: 认证和设置在容器重启后保持
  • 🚀 快速开始: 一条命令完成部署

🔧 快速开始

  1. 克隆仓库并复制配置:
git clone https://github.com/cfrs2005/claude-code-mobile
cd claude-code-mobile
cp config.env.example config.env
  1. config.env 中添加你的 Anthropic API token

  2. 启动服务:

docker-compose up --build
  1. 使用 Happy 手机应用连接!

📦 Docker Hub 镜像

预构建镜像可用:

  • cfrs2005/claude-code-mobile:latest
  • cfrs2005/claude-code-mobile:v1.0.0

生产环境使用:

docker-compose -f docker-compose.prod.yml up

📖 完整文档

查看 README.md 获取完整的设置和使用说明。