安装安全边界

本次文档改版参考的是信息组织方式：把高频工具放到最前面，把一键配置放到教程第一屏。具体文案、命令、配色和 Base URL 均为 TimeSniper 自有版本。

安全边界

• 不复制第三方站点页面内容、代码结构和视觉资源。
• 不把 API Key 放进可被 shell 历史记录保存的一行命令。
• 一键命令只拉取 docs.timesniper.club/install/ 下的 TimeSniper 自有脚本。
• Windows 脚本用 PowerShell 的 irm 拉取脚本；irm 是 Invoke-RestMethod 的内置别名。
• 一键脚本默认不使用 sudo。
• 缺失 Node.js 时，Windows 通过 winget 提示安装 Node.js LTS；macOS / Linux 通过 nvm 提示安装 Node.js LTS。
• 不安装 GitHub CLI。GitHub OAuth 是站点登录功能，本地 CLI 配置不依赖它。
• 不删除用户已有配置，涉及覆盖的页面会先备份旧文件。

推荐做法

想先审查脚本时，可以先复制源码链接打开查看。

Claude Code macOS / Linux 脚本源码

Link

https://docs.timesniper.club/install/claude-code.sh

Claude Code Windows 脚本源码

Link

https://docs.timesniper.club/install/claude-code.ps1

运行建议

• 优先安装官方发布的 CLI 包，例如 @anthropic-ai/claude-code、@openai/codex、@google/gemini-cli、openclaw。
• TimeSniper 自己的一键配置器使用已审查的固定版本。
• 对高级配置提供可见的本地命令，让用户能先读后运行。
• 文档示例统一使用占位符 sk-你的Key，避免误提交真实密钥。

已核对的信息

截至 2026-05-14：

包	当前核对版本	用途
timesniper-api	1.0.0	TimeSniper Claude Code 一键配置
@anthropic-ai/claude-code	2.1.140	Claude Code 官方 CLI
@openai/codex	0.130.0	Codex 官方 CLI
@google/gemini-cli	0.42.0	Gemini CLI 官方包
openclaw	2026.5.7	OpenClaw 官方包
Hermes	配置型入口	写入 ~/.hermes/config.yaml，不自动安装未知客户端

版本会变化，发版前建议重新运行 npm view <package> version。

Node.js 自动处理

入口	最低 Node.js	自动处理
Claude Code	v18+	Windows 用 winget，macOS / Linux 用 nvm
Codex	v18+	Windows 用 winget，macOS / Linux 用 nvm
Gemini CLI	v20+	Windows 用 winget，macOS / Linux 用 nvm
OpenClaw 自动配置	v22.14+	Windows 用 winget，macOS / Linux 用 nvm
Hermes	v18+	Windows 用 winget，macOS / Linux 用 nvm