详细讲解了在 Windows 和 macOS 系统上安装 Claude Code 命令行工具的具体步骤，包括环境依赖配置、第三方 API Key 设置以及常见问题排查。macOS 用户通过 curl 命令一键安装并配置环境变量；Windows 用户需先安装 Git Bash，配置 PATH 环境变量后使用 setx 设置密钥。文中提供了验证安装成功的方法及故障排除建议，帮助开发者快速搭建本地 AI 编程助手环境。
Claude Code 是 Claude 的命令行工具，让你在终端里直接用 Claude 写代码、读项目、做重构。
适合：
在终端里执行：
curl -fsSL https://claude.ai/install.sh | bash
✅ 验证是否成功：
claude --version
看到版本号 = 安装成功。
如果你用的是第三方中转（而不是官方 API），需要设置两个环境变量：
# 第一步：设置中转地址
export ANTHROPIC_BASE_URL="http://你的中转地址/api"
# 第二步：设置 API Key
export ANTHROPIC_AUTH_TOKEN="你的API Key"
💡 建议： 写进 ~/.zshrc 或 ~/.bashrc，避免每次重启终端都要重新配置。
操作方法：
# 编辑配置文件
nano ~/.zshrc
# 在文件末尾加入上面两行 export 命令
# 保存后执行
source ~/.zshrc
✅ 验证是否生效：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
能看到你设置的值 = 配置成功。
claude --help
如果你的中转有日志，可以查看是否有请求记录。
因为：
⚠️ 非常关键
这一步决定后面能不能成功，必须认真看！
下载地址：
https://git-scm.com/downloads/win
安装时注意：
选择 'Use Git from the command line and also from 3rd-party software'
这个选项决定 Git Bash 会不会被系统识别。
✅ 验证是否成功：
打开 cmd（命令提示符），运行：
bash --version
期望输出：
GNU bash, version 4.4.23(1)-release
看到版本号 = 安装成功。
如果提示 'bash' 不是内部或外部命令：
在 cmd（建议用管理员模式）里执行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
⚠️ 看到这个提示是正常的：
Native installation exists but C:\Users\xxx\.local\bin is not in your PATH
这不是错误，而是在提示你：下一步需要配置 PATH。
⚠️ 必须做这一步
否则系统找不到 claude 命令！
Claude 的可执行文件默认在：
C:\Users\你的用户名\.local\bin
💡 不知道用户名？ 打开 cmd 运行 echo %USERNAME%
配置步骤：
C:\Users\你的用户名\.local\bin（替换成你的实际用户名）⚠️ 配置完必须重启 cmd！
✅ 验证是否成功：
claude --version
看到版本号 = 配置成功。
如果还是提示找不到命令：
⚠️ 重要区别
Windows 不支持 export 命令，要用 setx！
在 cmd 里执行：
setx ANTHROPIC_BASE_URL "http://你的中转地址/api"
setx ANTHROPIC_AUTH_TOKEN "你的API Key"
⚠️ 设置完必须重启 cmd！（否则不生效）
✅ 验证是否生效：
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
能看到你设置的值 = 配置成功。
claude --help
如果你的中转有日志，可以查看是否有请求记录。
'bash' 不是内部或外部命令原因： Git Bash 没装，或者安装时没选对选项。
解决：
原因： Windows 的环境变量需要重启终端才生效。
解决：
macOS 验证：
echo $ANTHROPIC_BASE_URL
Windows 验证：
echo %ANTHROPIC_BASE_URL%
能看到你的中转地址 = 配置成功。
如果你的中转有日志，执行 claude --help 后可以查看是否有请求记录。
claude --version 提示找不到命令macOS：
Windows：
export）.zshrc 永久生效setx，不是 export）
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online