Claude Code Fast

Claude Code 的隐私增强版本，完全禁用遥测和数据收集功能。

🔒 隐私保护

这个包提供了多层自动隐私保护机制：

• 环境变量保护: 自动禁用遥测、错误报告和非必要流量
• DNS 层域名拦截: 在系统层面自动拦截遥测域名
• DoH 加密查询: 使用 DNS over HTTPS 防止 DNS 劫持和监听
• 客户端证书注入: 自动注入证书确保与 API 端点的安全通信

所有保护机制自动启用，无需手动配置。

🚀 性能优化

• 智能 IP 优选: 自动测试并选择最优 CDN 节点
• 智能缓存: 缓存优选 IP，加快启动速度
• 自动降级: 网络问题时自动回退到默认配置

📦 安装

全局安装（推荐）

npm install -g @codefast.cc/claude-code

安装后，可以使用 claude-fast 命令。

💡 与原生版本共存：此包不会覆盖原有的 claude 命令，两者可以同时使用！

本地安装

npm install @codefast.cc/claude-code

🚀 使用

安装完成后，直接使用 claude-fast 命令：

claude-fast

可用命令：

• claude-fast - 启动 Claude Code（隐私增强版）
• claude-fast init - 重新配置 API 连接信息
• claude-fast update - 检查并更新到最新版本
• claude-fast help - 查看命令说明与使用示例

命令对比：

• claude-fast - 隐私增强版（本包提供，禁用遥测）
• claude - 原生官方版（如已安装 @anthropic-ai/claude-code）

版本更新

检查并更新到最新版本：

claude-fast update

程序会自动检查更新：

• 自动检查：启动时同步检查版本（24小时内只检查一次）
• 智能缓存：检查结果保存在 ~/.claude-fast/update_required.json
• 强制更新：检测到新版本时自动更新，更新成功后提示重新运行
• 容错机制：更新失败时显示警告但允许继续使用旧版本
• 跳过检查：设置环境变量 CLAUDE_FAST_SKIP_VERSION_CHECK=1 可完全跳过版本检查
• 双包管理：同时检查 @codefast.cc/claude-code 和 @anthropic-ai/claude-code
• 如果无法获取当前或最新版本（例如网络超时），程序会继续启动，确保不因检测失败被阻塞

首次运行

首次运行时，程序会进行 API 配置：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔧 首次运行配置向导
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Claude Code Fast 需要配置 Anthropic API 连接信息。

🔑 请输入 Access Key：
   格式：子域名@token
   示例：subdomain@sk-ant-xxxxx

   说明：
   • 子域名部分会自动转换为 subdomain.codefast.cc
   • 支持多级子域名，如：a.b.c@token
   • 子域名只能包含字母、数字和连字符

Access Key: crs-us-01-xxxxx@cr_63d07c5a1xxx1ab576437axx

✅ 解析结果：
   BASE_URL: https://crs-us-01-xxxxx.codefast.cc/api
   AUTH_TOKEN: cr_63d07c5a1ef60ef...

✅ 配置已保存到：~/.claude-fast/config.json

说明：

• Access Key 格式：子域名@token 或 完整URL@token
• 子域名格式会自动扩展为：https://{子域名}.codefast.cc/api
• 完整 URL 格式用于自定义 API 端点
• 配置会保存到 ~/.claude-fast/config.json
• 文件权限设置为 600（仅当前用户可读写）

配置完成后，所有隐私保护和性能优化功能将自动启用。

✨ 功能特性

✅ 保留的功能

• 完整的 Claude Code 功能
• 本地代码分析和编辑
• Git 集成
• 所有 AI 辅助功能
• 版本检查和自动更新（24小时同步检查）
• 检测到新版本自动强制更新
• API 配置管理（支持自定义端点）

❌ 禁用的功能

• 遥测数据收集
• 错误自动报告到 Sentry
• 使用统计发送到 Statsig
• /bug 命令（手动错误报告）

🗑️ 卸载

完整卸载

# 卸载 npm 包
npm uninstall -g @codefast.cc/claude-code

使用官方版本

本包与官方版本可以共存，无需卸载：

# 使用隐私版
claude-fast

# 使用官方版（如已安装）
claude

如果还未安装官方版，可以同时安装：

npm install -g @anthropic-ai/claude-code

❓ 常见问题

Q: 这会影响 Claude Code 的核心功能吗？

A: 不会。所有 AI 功能、代码分析、编辑功能完全保留。只是禁用了遥测和错误报告。

Q: 可以和官方版本共存吗？

A: 可以！ 本包使用 claude-fast 命令，不会覆盖官方的 claude 命令。你可以同时安装和使用两个版本。

Q: 启动速度会受影响吗？

A: 首次启动或缓存过期时需要 2-3 秒进行 IP 优选，之后会使用缓存，启动速度非常快。

Q: 自动更新失败怎么办？

A: 程序会显示警告但允许继续使用当前版本。你可以稍后手动运行 claude-fast update 重试更新。

Q: 如何修改配置？

A: 运行 claude-fast init 重新配置，或直接编辑 ~/.claude-fast/config.json 文件。