Claude Code

Claude Code 是 Anthropic 官方的 AI 编程代理 CLI。它能理解您的代码库、生成和编辑代码、执行命令，并协助完成复杂的开发任务——全部通过命令行完成。

此模板将 Claude Code 部署为 Zeabur 上的持久化开发者工作站，并提供浏览器可访问的 Web 终端（ttyd）。

开始使用

1. 部署模板并等待服务启动。首次启动会自动安装 Claude Code，请等待健康检查变为绿色后再继续。
2. 在浏览器中打开服务网址（绑定到服务的域名）。
3. 登录 — 输入 Zeabur 仪表板 Instructions 页签中的密码。
4. 复制命令（例如 claude --dangerously-skip-permissions 可获取完整权限），然后点击 Enter Terminal。
5. 认证 Claude Code — 粘贴命令，按照提示登录您的 Claude Pro/Max/Team/Enterprise 订阅账号。

使用 API 密钥（可选）

如果您偏好使用 API 密钥而非订阅认证：

1. 将 ANTHROPIC_API_KEY 设置为您的 Anthropic API 密钥，可从 console.anthropic.com 获取。
2. 可选择设置 ANTHROPIC_BASE_URL 以使用 Zeabur AI Hub（例如 https://ai.hub.zeabur.com）。

常用命令

命令	说明
claude	启动交互式 Claude Code 会话
claude -p "提示"	执行单次提示
claude login	验证 Anthropic 账号
claude --version	检查已安装版本
claude config	查看或修改配置

持久化存储

/home/node 目录挂载为持久化卷。所有存储在 /home/node 下的项目、Claude Code 配置和会话数据，在服务重启和重新部署后都会保留。

建议工作流程：

• 将代码库克隆到 /home/node/projects/
• Claude Code 配置存储在 /home/node/.claude/

环境变量

变量	必填	说明
ANTHROPIC_API_KEY	否	Anthropic API 密钥或 Zeabur AI Hub Token（仅在不使用订阅登录时需要）
ANTHROPIC_BASE_URL	否	自定义 API 端点（使用 Zeabur AI Hub 时设置）
WEB_TERMINAL_PASSWORD	自动	Web 终端登录密码（自动生成，可在仪表板查看）

建议资源配置（官方要求）

• 最低配置：1 vCPU / 4 GB RAM
• 建议配置：2 vCPU / 4 GB RAM

Claude Code 官方系统要求为 4 GB 以上内存。AI 运算在 Anthropic API 端进行，本机仅运行 Node.js CLI 和 shell 工具，CPU 需求较低。

变更记录

2026-03-31 — 首次发布

• ttyd Web 终端（密码验证）
• Claude Code 原生安装器（首次启动自动安装）
• Homebrew 及 npm 全局包持久化于卷
• 资源需求及域名绑定

链接

• Claude Code 官方文档
• Anthropic Console
• Zeabur AI Hub