12.3 版本兼容问题
系统要求
| 项目 | 要求 |
|---|
| 操作系统 | macOS 10.15+、Linux（Ubuntu 18.04+、Debian 10+）、Windows 10+（WSL2 或原生） |
| Node.js | 建议 18+，最低支持 16+ |
| 网络 | 需要访问 api.anthropic.com（国内需代理） |
| 磁盘空间 | 约 200MB 用于安装 |
Windows 注意事项
- 推荐使用 WSL2：在 Windows Subsystem for Linux 中运行体验最佳
- 原生 Windows：支持，但部分功能可能受限
- 旧版安装路径废弃：v2.x 后不再支持
C:\ProgramData\ClaudeCode\，改为 C:\Program Files\ClaudeCode\
macOS 注意事项
- 如果 macOS 阻止运行，依次到「系统偏好设置 → 安全性与隐私 → 通用」允许
- 苹果芯片（M1/M2/M3）原生支持，无需 Rosetta 转译
Linux 注意事项
- 需要安装
libssl、libcurl、libx11 等系统库
- Ubuntu/Debian:
sudo apt install libssl-dev libcurl4-openssl-dev libx11-dev
- 凭据存储在
~/.claude/.credentials.json（权限 0600）
Node.js 版本兼容性
- Node 20+：完全支持，推荐使用
- Node 18：支持，但建议更新
- Node 16：可能遇到兼容性问题，建议升级
- Node 14 及以下：不支持
npm 安装版本
# 全局安装
npm install -g @anthropic-ai/claude-code
# 查看版本
claude --version
# 更新
npm update -g @anthropic-ai/claude-code
Homebrew 版本差异
| 安装方式 | 更新延迟 | 适用场景 |
|---|
brew install claude-code | 约 1 周滞后 | 追求稳定 |
brew install claude-code@latest | 与官方同步 | 需要最新功能 |
模型兼容性问题
- Haiku：所有 Claude Code 版本均支持
- Sonnet：所有版本支持
- Opus：所有版本支持
- extended thinking（扩展思考）：仅 Sonnet 4.7+ 和 Opus 4.7+ 支持，旧模型会报错
thinking.type.enabled not supported
配置文件兼容性
旧版 ~/.claude/settings.json 在新版中仍然兼容，但某些新选项可能被忽略。建议定期检查并迁移到新格式。