附录

A. 常用命令速查

# Claude Code版本和帮助
claude --version           # 查看版本（应显示native标识）
claude --help              # 查看帮助
claude /doctor             # 系统诊断

# Claude Code操作
claude                     # 进入交互模式
claude "你的问题"          # 单次提问
claude -p "问题"           # 打印模式（脚本友好）

# 更新Claude Code
claude install             # 重新安装/更新到最新版本

# 环境变量查看
$env:ANTHROPIC_API_KEY     # PowerShell 7（推荐）
echo $ANTHROPIC_API_KEY    # macOS/Linux
echo %ANTHROPIC_API_KEY%   # Windows CMD（不推荐）

# 网络测试
ping api.anthropic.com     # 测试连通性
curl -I https://api.anthropic.com  # 测试HTTPS访问

# 配置管理
claude config list         # 查看所有配置
claude config get <key>    # 查看特定配置
claude config set <key> <value>  # 设置配置

B. 从npm迁移到原生安装

如果你之前通过npm安装过Claude Code，请按以下步骤迁移：

步骤1：检查当前安装方式

claude --version
# 如果显示 (npm) → 需要迁移
# 如果显示 (native) → 已经是原生版本

步骤2：运行迁移命令

claude install

步骤3：验证迁移成功

claude --version
# 应显示：Claude Code v2.1.x (native)

步骤4：卸载npm版本（可选）

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

迁移时会保留：

• ✅ 所有配置文件（~/.claude/）
• ✅ API Key配置
• ✅ 自定义命令和技能
• ✅ 信任目录设置

特殊场景：使用nvm的用户

如果你用nvm管理多个Node版本，可能需要手动处理：

# 1. 对每个Node版本卸载
nvm use 20
npm uninstall -g @anthropic-ai/claude-code

nvm use 22
npm uninstall -g @anthropic-ai/claude-code

# 2. 然后运行原生安装
claude install

# 3. 清理nvm shims
rm ~/.asdf/shims/claude  # 如果你用asdf

C. 推荐学习资源

Claude Code官方文档：

• 英文：https://docs.anthropic.com/en/docs/claude-code
• 中文：https://code.claude.com/docs/en/

Anthropic API文档：

• https://docs.anthropic.com/

终端使用教程：

• Windows Terminal：https://learn.microsoft.com/zh-cn/windows/terminal/
• macOS终端：https://support.apple.com/zh-cn/guide/terminal/

社区支持：

• Claude Discord：https://discord.gg/anthropic
• GitHub Discussions：https://github.com/anthropics/claude-code/discussions

---

课程制作：老金 最后更新：2026年6月18日（已对照 Claude Code v2.1.181 release 增补安装、后台任务、插件、权限与安全说明；安装路径仍以「原生 + npm」双轨为准） 版本：V3.4（v2.1.181 release 校准补丁） 许可：本课程采用 MIT License；转载、复制或二次分发时必须保留版权声明与许可声明