RepoThread Logo
RepoThread
价格

快速上手

相关源文件

本页面内容基于以下源文件生成：

Claude Code Copy 是一个基于 Bun 运行时的命令行工具，提供 AI 辅助编程能力。该项目采用模块化架构设计，支持多种运行模式包括交互式会话、后台任务、远程控制和 MCP（Model Context Protocol）服务。

环境要求

运行时依赖

组件要求说明
Bun需要确认具体版本项目使用 bun:bundle 特性（src/entrypoints/cli.tsx:1）
Node.js 兼容支持通过 NODE_OPTIONS 环境变量配置堆内存（src/entrypoints/cli.tsx:9-14）

环境变量配置

项目支持以下关键环境变量：

变量名用途证据位置
CLAUDE_CODE_REMOTE启用远程模式，设置 8GB 堆内存限制src/entrypoints/cli.tsx:9-14
CLAUDE_CODE_ABLATION_BASELINE启用消融基线模式src/entrypoints/cli.tsx:21-26
COREPACK_ENABLE_AUTO_PIN禁用 corepack 自动固定src/entrypoints/cli.tsx:5

可选功能模块

以下功能通过 feature flag 控制，可能需要特定配置：

安装步骤

推荐安装方式

需要确认：以下安装命令基于常见 Bun 项目结构推断，具体安装方式需查阅 package.json 或项目文档。

bash
1# 方式一：通过 npm 安装（推荐）
2npm install -g @anthropic/claude-code
3
4# 方式二：从源码构建
5git clone https://github.com/yukin371/Claude-code-copy.git
6cd Claude-code-copy
7bun install
8bun run build

安装验证

安装完成后，可通过以下命令验证：

bash
1# 查看版本信息
2claude --version
3# 或
4claude -v

预期输出：版本号后跟 (Claude Code) 标识（src/entrypoints/cli.tsx:40）

最短可运行路径

基础启动命令

bash
1# 启动交互式会话
2claude
3
4# 指定模型运行
5claude --model claude-3-opus-20240229
6
7# 非交互模式（管道输入）
8echo "解释这个函数的作用" | claude

快速路径优化

CLI 入口针对常用命令实现了零模块加载优化：

特殊模式启动

bash
1# Chrome MCP 服务模式
2claude --claude-in-chrome-mcp
3
4# Chrome Native Host 模式
5claude --chrome-native-host
6
7# Computer Use MCP 服务（需要 feature flag）
8claude --computer-use-mcp
9
10# 守护进程工作进程（内部使用）
11claude --daemon-worker=<kind>

运行验证

版本检查验证

bash
1claude --version

预期输出格式：

x.y.z (Claude Code)

其中 x.y.z 为构建时内联的版本号（src/entrypoints/cli.tsx:40）

系统提示导出验证

bash
1claude --dump-system-prompt --model claude-3-opus-20240229

此命令输出指定模型的完整系统提示，用于提示词敏感性评估（src/entrypoints/cli.tsx:50-71）

后台会话管理验证

bash
1# 列出所有后台会话
2claude ps
3
4# 查看特定会话日志
5claude logs <session-id>
6
7# 附加到会话
8claude attach <session-id>
9
10# 终止会话
11claude kill <session-id>

会话管理命令通过 ~/.claude/sessions/ 注册表进行状态追踪（src/entrypoints/cli.tsx:182-209）

远程控制模式验证

bash
1# 启动桥接模式
2claude remote-control
3# 或使用别名
4claude rc
5claude bridge

前置条件：

  1. 必须完成 OAuth 认证（src/entrypoints/cli.tsx:137-141）
  2. 组织策略必须允许远程控制（src/entrypoints/cli.tsx:152-159）

常见问题与排错

问题 1：版本命令无响应或报错

症状：执行 claude --version 后无输出或报模块加载错误

排查步骤：

  1. 确认 Bun 运行时已正确安装
  2. 检查 MACRO.VERSION 是否在构建时正确内联（src/entrypoints/cli.tsx:40）
  3. 验证入口文件路径是否正确

解决方案：重新构建项目，确保构建流程正确处理版本宏替换。

问题 2：远程控制模式认证失败

症状：执行 claude remote-control 时提示 BRIDGE_LOGIN_ERROR

原因：OAuth 令牌未正确配置或已过期（src/entrypoints/cli.tsx:139-141）

解决方案：

bash
1# 重新登录认证
2claude login
3
4# 验证令牌状态
5claude auth status

需要确认：具体登录命令需查阅 src/commands/login/login.tsx 实现。

问题 3：容器环境内存不足

症状：在容器环境中运行时出现内存溢出错误

原因：容器默认堆内存限制不足

解决方案：设置环境变量启用远程模式优化：

bash
1export CLAUDE_CODE_REMOTE=true

此配置会自动设置 --max-old-space-size=8192（src/entrypoints/cli.tsx:9-14）

问题 4：代理或 mTLS 配置问题

症状：网络请求失败，提示连接超时或证书错误

排查路径：

  1. 检查 settings.json 中的 NODE_EXTRA_CA_CERTS 配置（src/entrypoints/init.ts:76-79）
  2. 验证全局代理配置（src/entrypoints/init.ts:143-151）
  3. 确认 mTLS 证书路径正确（src/entrypoints/init.ts:134-141）

问题 5：后台会话无法附加

症状：claude attach <session-id> 执行失败

可能原因：

  1. 会话 ID 不存在
  2. 会话已终止
  3. 会话注册表损坏

解决方案：

bash
1# 先列出所有会话确认 ID
2claude ps
3
4# 检查会话目录
5ls ~/.claude/sessions/

问题 6：策略限制导致功能禁用

症状：提示 "Remote Control is disabled by your organization's policy"

原因：组织策略禁止远程控制功能（src/entrypoints/cli.tsx:157-159）

解决方案：联系组织管理员调整策略配置，或使用非远程控制模式。

启动流程详解

CLI 入口与初始化序列

正在加载图表渲染器...

初始化阶段详解

系统初始化通过 init() 函数完成，采用 memoize 包装确保单次执行（src/entrypoints/init.ts:57）。初始化流程包含以下关键步骤：

  1. 配置系统启用：调用 enableConfigs() 激活配置管理（src/entrypoints/init.ts:65）

  2. 安全环境变量应用：在信任对话框确认前仅应用安全环境变量（src/entrypoints/init.ts:74）

  3. CA 证书配置：在首次 TLS 握手前应用 NODE_EXTRA_CA_CERTS（src/entrypoints/init.ts:76-79）

  4. 优雅关闭设置：注册进程退出清理钩子（src/entrypoints/init.ts:87）

  5. 网络配置：

下一步建议

完成基础安装和验证后，建议按以下路径深入学习：

  1. 交互式使用：查阅"使用指南"章节了解提示词技巧和多轮对话最佳实践

  2. 后台任务管理：学习 --bg / --background 标志的使用场景和会话持久化机制

  3. MCP 集成：探索 Chrome 集成和 Computer Use 功能的配置方法

  4. 远程控制：了解桥接模式的安全模型和网络配置要求

  5. 高级配置：