Claude Code Guide — Install, Env, Troubleshoot

Main

• 优先用原生安装器减少 Node.js 相关问题；README 仍保留 npm 作为替代路径。

• 把环境变量当稳定性旋钮：README 列出命令超时与输出长度上限等关键参数。

• 需要容器化时用 Docker 兜底，统一运行时并固定 workspace 挂载，减少“机器差异”。

Source-backed notes

• README 包含原生安装命令（install.sh/install.ps1/install.cmd），并提供 npm 替代安装路径。
• README 列出 BASH_DEFAULT_TIMEOUT_MS、BASH_MAX_TIMEOUT_MS、BASH_MAX_OUTPUT_LENGTH 等环境变量，用于控制工具执行行为。
• README 建议安装 VS Code/Cursor 的 Claude Code 扩展，并给出 Docker 兜底示例在容器里运行 claude。

FAQ

• 一定要装 Node.js 吗？：仅在走 npm 安装路径时需要；README 说明原生安装器自带运行时。
• 为什么长命令会超时？：按 README 调整相关环境变量（默认/最大超时与输出上限）。
• 能在 Docker 里跑吗？：可以。README 提供 Docker 兜底命令，挂载 workspace 后运行 claude。