@znmin/claude-remote-cli 0.1.0 → 0.1.1

package/README.md

@@ -25,10 +25,10 @@ npm install -g git+https://github.com/znmin/claude-remote-cli.git
 也可以从已下载的分发包安装：
 
 ```bash
-npm install -g ./znmin-claude-remote-cli-0.1.0.tgz
+npm install -g ./znmin-claude-remote-cli-0.1.1.tgz
 ```
 
-若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.1.0.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
+若系统 npm 全局目录不可写，可使用 `npm install -g --prefix "$HOME/.local" ./znmin-claude-remote-cli-0.1.1.tgz`，并确保 `~/.local/bin` 在 PATH 中；卸载时也使用相同的 `--prefix`。
 
 npm 中不带作用域的 `claude-remote-cli` 属于其他项目。本项目使用独立的 `@znmin/claude-remote-cli` 作用域包名；请安装完整包名，或使用上述 GitHub 地址及本项目分发的 `.tgz` 文件。
 
@@ -38,7 +38,14 @@ npm 中不带作用域的 `claude-remote-cli` 属于其他项目。本项目使
 
 ## 开始使用
 
-服务器需要 Linux/macOS、可用的 SSH/SCP、Bash，以及**已经安装并完成认证的 Claude Code**。
+服务器需要 Linux/macOS、可用的 SSH/SCP 和 Bash。启动时会检查 Claude Code：
+
+- 已安装：直接使用已有程序。
+- 默认 `claude` 命令不存在：通过服务器上的 `curl` 或 `wget` 下载并执行 [Anthropic 官方原生安装器](https://github.com/anthropics/claude-code#get-started)，无需服务器安装 Node.js，也不会使用 `sudo`。
+- 安装完成：检查命令已可用，再开始目录同步并启动 Claude。首次启动时按 Claude 的提示完成账号认证；不会复制本机账号凭据。
+- 下载失败、安装失败或缺少 `curl`/`wget`：停止启动并报告原因，不建立新的项目同步会话。自动安装最多等待 10 分钟，可修复网络/权限后重试。
+
+安装过程只在默认命令缺失时触发，不会自动重装或升级已有 Claude Code。
 
 ```bash
 # 配置你的服务器，不会立即连接或上传文件
@@ -60,7 +67,7 @@ claude --continue
 
 未配置服务器时，也可以直接运行 `claude`，按终端提示输入服务器地址和端口。请勿把密码或私钥填入配置；登录使用 OpenSSH 原有认证流程和主机身份验证。
 
-若远程 Claude 不在登录环境的 PATH 或 `~/.local/bin` 中：
+若需要使用特定的 Claude 可执行文件，可指定绝对路径；自定义路径不存在时会提示修正配置，不会自动改用其他程序：
 
 ```bash
 claude-remote configure my-server --claude /absolute/path/to/claude
@@ -127,7 +134,7 @@ npm test
 CLAUDE_REMOTE_INTEGRATION=1 npm test
 
 npm pack
-npm install -g ./znmin-claude-remote-cli-0.1.0.tgz
+npm install -g ./znmin-claude-remote-cli-0.1.1.tgz
 
 # 确定包名、版本和使用条款后，使用有发布权限的 npm 账号发布
 npm login
@@ -136,6 +143,6 @@ npm publish --access public
 
 GitHub 仓库名为 `claude-remote-cli`，npm 包名为 `@znmin/claude-remote-cli`，命令名为 `claude` 和 `claude-remote`。发布账号必须拥有 npm 用户作用域 `@znmin`，或拥有同名 npm 组织的发布权限；GitHub 身份不会自动授予 npm 权限。当前 `license` 为 `UNLICENSED`，尚未指定开源许可证。
 
-测试覆盖全局安装、命令入口、项目隔离、参数引用、冲突阻断、下载校验和本地真实双向同步。由于尚未提供服务器，真实 SSH 认证、远程 Claude 交互、Linux 和其他 CPU 架构尚未实测。
+测试覆盖全局安装、命令入口、项目隔离、参数引用、冲突阻断、下载校验、本地真实双向同步，以及使用隔离环境模拟的远程自动安装、下载失败和安装失败。由于尚未提供服务器，真实 SSH 认证、服务器上的官方安装与 Claude 交互、Linux 和其他 CPU 架构尚未实测。
 
 参考：[npm 命令入口配置](https://docs.npmjs.com/cli/configuring-npm/package-json#bin)、[Mutagen 同步机制](https://mutagen.io/documentation/synchronization/)、[Mutagen SSH 支持](https://mutagen.io/documentation/transports/ssh/)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@znmin/claude-remote-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run Claude Code on your SSH server with safe bidirectional project synchronization",
   "type": "module",
   "license": "UNLICENSED",

package/src/cli.js

@@ -4,7 +4,7 @@ import { Client, DEFAULTS } from './client.js';
 import { cachedBinary, ensureMutagen, VERSION } from './installer.js';
 import { exists, readJSON, which } from './system.js';
 
-const HELP = `@znmin/claude-remote-cli 0.1.0（非 Anthropic 官方客户端）
+const HELP = `@znmin/claude-remote-cli 0.1.1（非 Anthropic 官方客户端）
 
 安装后使用：
   claude                           首次引导设置服务器，之后启动远程 Claude Code
@@ -18,7 +18,8 @@ const HELP = `@znmin/claude-remote-cli 0.1.0（非 Anthropic 官方客户端）
   claude-remote run [Claude 参数]   启动远程 Claude
 
 configure 可选：--root 远程根目录、--ignore 忽略规则（可重复）。
-服务器需要已安装并认证的 Claude Code；此工具不提供服务器或 Claude 账号。
+服务器缺少默认 Claude Code 时会自动安装；首次启动需完成认证。
+此工具不提供服务器或 Claude 账号。
 退出 Claude 后会继续后台同步；停止请运行 claude-remote stop。
 `;
 
@@ -47,14 +48,14 @@ export async function main(asClaude, args = process.argv.slice(2), client = new
     const saved = await readJSON(client.configFile, {});
     if (!saved.host && !client.env.CLAUDE_REMOTE_HOST) {
       if (args.includes('--help') || args.includes('-h')) { console.log(HELP); return 0; }
-      if (args.includes('--version')) { console.log('@znmin/claude-remote-cli 0.1.0'); return 0; }
+      if (args.includes('--version')) { console.log('@znmin/claude-remote-cli 0.1.1'); return 0; }
       if (process.stdin.isTTY) await configure(client, []);
     }
     return client.launch(await client.settings(), args);
   }
   const [action, ...rest] = args;
   if (!action || ['--help', '-h', 'help'].includes(action)) { console.log(HELP); return 0; }
-  if (['--version', '-v'].includes(action)) { console.log('0.1.0'); return 0; }
+  if (['--version', '-v'].includes(action)) { console.log('0.1.1'); return 0; }
   if (action === 'configure') { await configure(client, rest); return 0; }
   if (action === 'run') return client.launch(await client.settings(), rest[0] === '--' ? rest.slice(1) : rest);
   if (action === 'stop') {

package/src/client.js

@@ -4,6 +4,7 @@ import os from 'node:os';
 import { createHash, randomUUID } from 'node:crypto';
 import { execute, exists, quote, readJSON, shellJoin, which, withLock, writeJSON } from './system.js';
 import { ensureMutagen } from './installer.js';
+import { ensureRemoteClaude, remoteEnvironment as prefix } from './remote-claude.js';
 
 export const DEFAULTS = {
   root: '.local/share/claude-remote/projects', claude: 'claude',
@@ -28,7 +29,6 @@ export function validate(config) {
 }
 
 export const remotePath = file => file.startsWith('/') ? quote(file) : '"$HOME"/' + quote(file);
-const prefix = 'export PATH="$HOME/.local/bin:$PATH"; ';
 
 export function sshArgs(config, script, { interactive = false, tty = false } = {}) {
   const args = ['-o', 'ConnectTimeout=15', '-o', 'ServerAliveInterval=15', '-o', 'ServerAliveCountMax=3'];
@@ -136,9 +136,9 @@ export class Client {
     assertSynchronized((await this.sessions()).find(session => session.name === name));
   }
 
-  async remote(config, script, interactive = false) {
+  async remote(config, script, interactive = false, { timeout = 180000 } = {}) {
     return this.execute('ssh', sshArgs(config, script, { interactive, tty: interactive && this.tty }),
-      { env: this.env, timeout: interactive ? 0 : 180000, check: !interactive });
+      { env: this.env, timeout: interactive ? 0 : timeout, check: !interactive });
   }
 
   async launch(config, extra) {
@@ -162,9 +162,8 @@ export class Client {
         if (inside(relative) || inside(reverse))
           throw new Error(`目录与正在同步的项目重叠：${other}\n先运行：claude-remote stop --name ${session.name}`);
       }
-      await this.remote(config, prefix + `command -v ${quote(config.claude)} >/dev/null || ` +
-        "{ echo '服务器找不到 Claude Code，请先安装并登录，或配置 --claude 绝对路径。' >&2; exit 127; }; " +
-        'mkdir -p -- ' + remotePath(item.remote));
+      await this.remote(config, ensureRemoteClaude(config.claude) +
+        'mkdir -p -- ' + remotePath(item.remote), false, { timeout: 600000 });
       if (existing.some(session => session.name === item.name)) {
         await this.sync(['resume', item.name], { timeout: 60000, capture: !this.tty });
       } else {

package/src/remote-claude.js

@@ -0,0 +1,39 @@
+import { quote } from './system.js';
+
+export const remoteEnvironment = 'export PATH="$HOME/.local/bin:$PATH"; ';
+
+export function ensureRemoteClaude(command) {
+  const missing = command === 'claude' ? `
+  echo '服务器未安装 Claude Code，正在执行官方安装流程……' >&2
+  (
+    set -e
+    installer=$(mktemp "\${TMPDIR:-/tmp}/claude-remote-install.XXXXXXXX")
+    trap 'rm -f -- "$installer"' EXIT
+    if command -v curl >/dev/null 2>&1; then
+      curl -fSL --connect-timeout 20 --max-time 120 --retry 2 \\
+        --output "$installer" https://claude.ai/install.sh
+    elif command -v wget >/dev/null 2>&1; then
+      wget --timeout=120 --tries=3 --output-document="$installer" https://claude.ai/install.sh
+    else
+      echo '自动安装需要服务器提供 curl 或 wget，请先安装其中一个工具。' >&2
+      exit 127
+    fi
+    if ! bash "$installer" >&2; then
+      echo 'Claude Code 官方安装失败，请检查上述输出、网络连接和目录权限后重试。' >&2
+      exit 1
+    fi
+  )
+  hash -r
+  if ! command -v claude >/dev/null 2>&1; then
+    echo '安装器已退出，但仍找不到 Claude Code。请检查 ~/.local/bin/claude 或通过 --claude 指定绝对路径。' >&2
+    exit 127
+  fi
+  echo 'Claude Code 已安装，首次启动时请按提示完成账号认证。' >&2
+` : `
+  echo ${quote('找不到配置的 Claude 程序：' + command + '。请修正 --claude 路径，或配置 --claude claude 使用自动安装。')} >&2
+  exit 127
+`;
+  // A failed download/installer must stop before any project directory is created or synced.
+  return 'set -e\n' + remoteEnvironment + '\n' +
+    `if ! command -v ${quote(command)} >/dev/null 2>&1; then\n${missing}fi\n`;
+}