Skip to content

README.zh-CN.md

Latest commit

 

History

History
242 lines (171 loc) · 7.13 KB

README.zh-CN.md

File metadata and controls

242 lines (171 loc) · 7.13 KB

📱 Claude Code 移动服务

为移动设备提供 Claude Code 访问的容器化服务

Docker GitHub Release License: MIT Happy-coder Compatible

🇺🇸 English | 🇨🇳 中文

📖 部署指南：
🏠 绿联NAS部署指南 | 🏠 Ugreen NAS Deployment Guide

🙏 致谢：
🤖 特别感谢 智谱AI GLM模型 为AI开发创新提供灵感

项目概述

Claude Code 移动服务是一个容器化解决方案，让开发者能够通过智能手机访问强大的 Claude Code AI 编程助手。通过 Happy-coder 移动界面，实现随时随地的智能编程体验。

当前版本： 基于 Claude Code v2.1.12 构建（最新稳定版本）

✨ 核心特性

特性 说明
📱 移动优先 手机端完整的 Claude Code 功能体验
🐳 容器化部署 Docker 一键部署，简单可靠
🔧 智能配置 零配置启动，自动化处理交互
💾 状态持久化 认证和项目数据重启后自动恢复
🚀 生产就绪 多架构 Docker Hub 官方镜像
🔒 安全可靠 基于令牌认证和卷隔离保护

🏗️ 系统架构

架构图

Claude Code 移动服务在你的手机和 Claude Code AI 之间创建了一个桥梁，运行在容器化环境中，自动处理所有复杂的设置和认证流程。

🚀 快速开始

系统要求

  • Docker 和 Docker Compose
  • Anthropic API 令牌
  • 安装了 Happy 应用的移动设备

安装部署

方式一：使用 Docker Hub 镜像（推荐）

# 克隆配置文件
git clone https://github.com/cfrs2005/claude-code-mobile.git
cd claude-code-mobile

# 配置 API 令牌
cp config.env.example config.env
nano config.env  # 添加你的 ANTHROPIC_AUTH_TOKEN

# 首次启动服务（用于认证配置）
docker-compose -f docker-compose.prod.yml up -d

# 完成 Happy 认证（首次启动必须）
docker exec -it claude-code-mobile_happycoder_1 happy

# 重启服务（认证现已持久化）
docker-compose -f docker-compose.prod.yml restart

方式二：源码构建

git clone https://github.com/cfrs2005/claude-code-mobile.git
cd claude-code-mobile
cp config.env.example config.env
# 编辑 config.env 添加你的令牌

# 首次构建和启动
docker-compose up --build -d

# 完成 Happy 认证（首次启动必须）
docker exec -it claude-code-mobile_happycoder_1 happy

# 重启服务（认证现已持久化）
docker-compose restart

手机连接步骤

  1. 在手机上安装 Happy 应用
  2. 连接到你服务器的 IP 地址
  3. 开始移动端智能编程！

🔧 配置说明

环境变量配置 (config.env)

# 必填项
ANTHROPIC_AUTH_TOKEN=your_anthropic_api_token_here

# 可选项
ANTHROPIC_BASE_URL=https://api.anthropic.com  
CLAUDE_CODE_AUTO_START=true

数据卷挂载

本地路径 容器路径 用途说明
./workspace/ /workspace 你的项目代码文件
./claude-config/ /root/.claude/ Claude 配置和设置
./happy-auth/ /root/.happy/ Happy 认证数据
config.env /config/config.env 环境变量配置

📚 高级用法

开发管理命令

# 查看服务运行日志
docker-compose logs -f

# 进入容器命令行调试
docker exec -it claude-code-mobile_happycoder_1 bash

# 重启服务
docker-compose restart

# 更新到最新版本
docker-compose pull && docker-compose up -d

常见问题排查

问题现象 解决方案
服务无法启动 检查 config.env 中 API 令牌是否正确
手机无法连接 验证服务器防火墙设置和容器运行状态
认证反复失败 删除 ./happy-auth/ 目录后重新启动
项目文件找不到 确认文件放在 ./workspace/ 目录中

⚠️ 重要安全提醒

Happy 守护进程管理

Happy 作为常驻守护进程运行，即使没有活跃的界面连接也会持续运行。这使得移动设备能够无缝连接，但需要正确的进程管理来保证安全性。

官方 Happy 守护进程管理：

# 检查守护进程状态
happy daemon status

# 列出活跃会话
happy daemon list

# 停止守护进程（会话保持活跃）
happy daemon stop

# 启动守护进程（如果未运行）
happy daemon start

# 清理所有 happy 进程（推荐用于完全关闭）
happy doctor clean

备用手动进程管理：

# 检查 Happy 守护进程是否在运行
ps aux | grep happy-coder

# 手动终止（如果 happy daemon 命令无效）
pkill -f "happy-coder.*daemon"

典型的 Happy 守护进程：

node --no-warnings --no-deprecation /opt/homebrew/lib/node_modules/happy-coder/dist/index.mjs daemon start-sync

安全注意事项

🔒 不使用时运行 happy daemon stop 或 happy doctor clean 以防止未授权访问
🔒 使用 happy daemon list 定期监控活跃会话 特别是在共享环境中
🔒 使用防火墙规则 限制对 Happy 服务端口的网络访问
🔒 保护 API 令牌安全 并定期轮换更新
🔒 定期检查认证日志 在 ./happy-auth/ 目录中

推荐的关闭流程：

# 完全清理（终止所有 happy 进程）
happy doctor clean

# 温和关闭（保持会话但停止守护进程）
happy daemon stop

🚢 生产环境部署

生产环境推荐使用预构建的 Docker Hub 镜像：

# 使用生产配置启动
docker-compose -f docker-compose.prod.yml up -d

# 检查服务运行状态
docker-compose ps

# 查看服务日志
docker-compose logs happycoder

🤝 参与贡献

  1. Fork 本仓库到你的账号
  2. 创建功能分支：git checkout -b feature/新功能名
  3. 提交代码更改：git commit -m '添加新功能'
  4. 推送到你的分支：git push origin feature/新功能名
  5. 提交 Pull Request 请求合并

📞 支持与反馈

📄 开源协议

本项目采用 MIT 开源协议 - 详情请查看 LICENSE 文件。

⭐ 如果这个项目对你有帮助，请给个 Star 支持！

用 ❤️ 制作 by cfrs2005