常见问题 FAQ
这里收集了学习过程中可能遇到的问题和解决方法。
安装相关
Q: npm install 很慢或一直卡住？
A: 可能是网络问题，尝试以下方法：
bash
# 使用国内镜像
npm config set registry https://registry.npmmirror.com
# 然后重新安装
npm install -g @anthropic-ai/claude-codeQ: 提示权限不足怎么办？
A: 以管理员身份运行终端：
Windows：
- 按
Win键搜索"PowerShell" - 右键选择"以管理员身份运行"
macOS： 在命令前加 sudo：
bash
sudo npm install -g @anthropic-ai/claude-codeQ: 杀毒软件报毒怎么办？
A: Claude Code是安全软件，杀毒软件可能误报。
解决方法：
- 暂时关闭杀毒软件
- 安装完成后将Claude Code添加到白名单
- 重新开启杀毒软件
使用相关
Q: Claude Code 支持哪些系统？
A:
- ✅ Windows 10/11
- ✅ macOS 11+
- ✅ Linux（主流发行版）
- ❌ 暂不支持ChromeOS、iOS、Android
Q: 必须懂编程才能用吗？
A: 完全不需要！本教程就是为零基础设计的，你只需要：
- 会用中文描述需求
- 会复制粘贴命令
- 跟着教程一步步做
Q: Claude Code 是免费的吗？
A: Claude Code本身免费，但需要：
- Anthropic账号（可以注册免费额度）
- Claude API访问（可能有费用，具体看Anthropic定价）
Q: 中文支持怎么样？
A: Claude对中文支持很好，你可以：
- 用中文描述需求
- 处理中文文件
- 生成中文注释
项目相关问题
Q: 项目1报错"找不到pandas"？
A: 安装pandas库：
bash
pip install pandas openpyxlQ: 项目2网页打不开？
A: 检查：
- Streamlit是否已安装：
pip install streamlit - 端口是否被占用：尝试
streamlit run app.py --server.port 8502 - 防火墙是否阻止
Q: 项目3部署失败？
A: 常见原因：
- GitHub仓库是私有的 → 改为Public
- requirements.txt缺失 → 创建包含依赖的文件
- 代码有bug → 本地测试通过后再部署
查看具体错误信息，参考项目3的调试指南
网络相关
Q: 国内如何访问Claude？
A: 需要科学上网：
- 准备代理工具
- 设置为系统代理模式
- 确保可以访问
anthropic.com
Q: 公司网络限制了怎么办？
A:
- 联系IT部门申请权限
- 使用手机热点
- 在家完成学习
进阶问题
Q: 如何让我的工具更稳定？
A:
- 添加错误处理（try-except）
- 添加输入验证
- 提供详细的错误提示
- 测试各种边界情况
Q: 如何优化工具性能？
A:
- 减少不必要的计算
- 使用缓存机制
- 优化数据库查询
- 异步处理耗时操作
Q: 如何分享给同事？
A:
- 项目1-2：打包代码文件夹，让同事本地运行
- 项目3：部署到云端，分享链接
- 或者把工具做成exe可执行文件（用PyInstaller）
Q: 可以做成手机App吗？
A: 可以，但需要额外学习：
- React Native / Flutter（跨平台App）
- 或用Streamlit响应式设计（网页版）
学习建议
Q: 零基础要学多久？
A:
- 快速上手：1天完成项目1
- 掌握基础：1周完成3个项目
- 熟练应用：1个月持续练习
Q: 遇到bug怎么办？
A:
- 复制错误信息，用Claude Code询问
- 查看本教程的"常见错误"部分
- 搜索错误信息找到解决方案
- 在GitHub上提issue
Q: 有更多学习资源吗？
A:
其他问题
Q: 教程会持续更新吗？
A: 是的！我们会：
- 跟进Claude Code新功能
- 添加更多实战项目
- 优化内容质量
Q: 可以转载教程内容吗？
A: 本教程采用MIT开源协议，可以：
- ✅ 自由使用
- ✅ 修改和分发
- ✅ 商业使用
- ⚠️ 需保留版权声明
Q: 如何反馈问题或建议？
A:
- 在GitHub提issue
- 发送邮件反馈
- 参与讨论区交流