「程序安装」使用 TRAE 安装 Claude Code的解决方法🧣

围巾哥萧尘
4,134 阅读2分钟

截屏2025-08-21 22.11.42.png

Claude Code 安装问题解决指南 🚀

本文档记录了在 macOS 系统上安装 Claude Code 过程中遇到的问题及其解决方案。

📋 系统环境

  • 操作系统: macOS
  • Shell: zsh
  • Node.js: 已安装
  • npm: 已安装

❌ 遇到的问题

1. npm 权限错误 (EACCES)

问题描述:

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

错误信息:

npm error code EACCES
npm error syscall mkdir
npm error path /usr/local/lib/node_modules/@anthropic-ai
npm error errno -13
npm error Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@anthropic-ai'

原因分析:

  • npm 尝试在系统级目录 /usr/local/lib/node_modules/ 安装全局包
  • 当前用户没有写入权限
  • 不建议使用 sudo 安装 npm 包（安全风险）

2. 网络连接问题

问题描述: 启动 Claude Code 时无法连接到 Anthropic 服务

错误信息:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

3. Raw Mode 错误

问题描述:

ERROR Raw mode is not supported on the current process.stdin, which Ink uses as input stream by default.

原因分析:

  • Ink 框架需要支持原始模式的终端输入流
  • 当前终端环境可能不支持交互模式

✅ 解决方案

1. 解决 npm 权限问题

步骤 1: 创建用户级 npm 目录
mkdir -p ~/.npm-global
步骤 2: 配置 npm 前缀
npm config set prefix '~/.npm-global'
步骤 3: 更新 PATH 环境变量
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
步骤 4: 安装 Claude Code
npm install -g @anthropic-ai/claude-code

2. 验证安装

检查版本
claude --version
# 输出: 1.0.86 (Claude Code)
运行诊断
claude doctor

预期输出:

Diagnostics
└ Currently running: unknown (1.0.86)
└ Path: /usr/local/bin/node
└ Invoked: /Users/xiaochen/.npm-global/bin/claude
└ Config install method: unknown
└ Auto-updates enabled: true
└ Search: OK (vendor)

🔧 替代安装方法

原生安装器（推荐）

如果 npm 方法仍有问题，可以尝试官方的原生安装器：

# 安装稳定版本
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版本
curl -fsSL https://claude.ai/install.sh | bash -s latest

🚨 待解决问题

网络连接问题

可能的解决方案:

  1. 检查网络连接:

    curl -I https://api.anthropic.com

  2. 检查地区支持:

  3. 代理设置: 如果使用代理，确保 Claude Code 可以通过代理访问 Anthropic 服务

  4. 防火墙设置: 检查防火墙是否阻止了对 api.anthropic.com 的访问

Raw Mode 错误

可能的解决方案:

  1. 尝试不同终端:

    • iTerm2
    • 原生 Terminal.app
    • VS Code 集成终端

  2. 检查终端设置: 确保终端支持交互模式和原始输入

  3. 环境变量:

    export TERM=xterm-256color

📚 参考资源

🎯 总结

Claude Code 已成功安装并可以运行基本命令，但仍需解决网络连接问题才能正常使用 AI 功能。主要的权限问题已通过配置用户级 npm 目录得到解决。

最后更新: 2025年8月21日
状态: 安装完成，网络连接待解决 🔄

avatar
文章
阅读
粉丝