常见问题 FAQ

Claude Code 调用的是 Anthropic 公司的 API，服务器位于美国。由于网络环境限制，中国大陆用户需要通过代理工具才能稳定访问。 这是使用境外 AI 服务的共同需求，与 Claude Code 本身无关。

请按以下步骤排查：

1. 确认代理工具已启动并正常运行
2. 在代理工具中开启「系统代理」或「全局模式」
3. 在 PowerShell 中运行 curl https://api.anthropic.com 测试连通性
4. 如系统代理无效，尝试手动设置：set HTTPS_PROXY=http://127.0.0.1:你的代理端口
5. 重新运行安装程序

是的，Claude Code 每次对话都需要连接 Anthropic API，因此每次使用时都需要保持代理工具处于开启状态。 建议将代理工具设置为开机自启，这样无需每次手动开启。

这是因为安装程序尚未通过微软的代码签名认证，属于正常现象。解决方法：

1. 点击弹窗中的「更多信息」
2. 点击「仍要运行」按钮

本程序代码完全开源，你可以在 GitHub 上查看和审计所有代码，确认安全性。

这是 PATH 环境变量未更新的问题。解决方法：

1. 重启终端： 完全关闭 PowerShell/CMD 窗口，重新打开
2. 重启电脑： 如果重启终端无效，重启电脑后再试
3. 手动验证： 运行 npm list -g @anthropic-ai/claude-code，如果有输出说明安装成功，只是 PATH 问题

Claude Code 需要 Node.js 18 或更高版本。安装程序会自动检测版本，如果版本过低会提示你更新。 你也可以手动从 nodejs.org 下载最新 LTS 版本安装后，再运行 Claude Code 安装程序。

在 PowerShell 中运行以下命令即可完全卸载：

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

Node.js 本身不会被删除，如需一并卸载，去「控制面板 → 程序和功能」中找到 Node.js 卸载即可。

Claude Code 软件本身免费，但使用需要 Anthropic 账号，并消耗 API 用量。

计费方式： 按 Token 用量计费，新用户通常有一定免费额度。实际费用取决于使用量， 轻度使用每月大约几美元，重度使用可能更多。

详细定价请参考 Anthropic 官方定价页面。

如果浏览器未自动打开，终端会显示一个登录链接。手动复制该链接到浏览器地址栏打开， 完成授权后终端会自动检测并完成登录。

注册账号不需要手机号和信用卡，使用 Google 或 Apple 账号即可完成注册。 如果你想使用付费 API 功能，才需要绑定支付方式（支持信用卡）。 新用户通常有免费试用额度，可以先体验再决定是否充值。

运行安装目录中的 update.bat 脚本即可自动更新。或者手动在终端运行：

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

建议定期更新以获得最新功能和安全修复。

安装程序通过 Git 进行版本管理。运行 update.bat 会自动从 GitHub 拉取最新版本的安装脚本， 然后重新安装最新版 Claude Code。你也可以关注发布页面获取更新通知。