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

Claude Code 安装问题解决指南 🚀

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

📋 系统环境

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

❌ 遇到的问题

1. npm 权限错误 (EACCES)

问题描述:

bash 复制代码

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

错误信息:

lua 复制代码

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 服务

错误信息:

css 复制代码

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

3. Raw Mode 错误

问题描述:

vbnet 复制代码

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

原因分析:

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

✅ 解决方案

1. 解决 npm 权限问题

步骤 1: 创建用户级 npm 目录

bash 复制代码

mkdir -p ~/.npm-global

步骤 2: 配置 npm 前缀

bash 复制代码

npm config set prefix '~/.npm-global'

步骤 3: 更新 PATH 环境变量

bash 复制代码

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

步骤 4: 安装 Claude Code

bash 复制代码

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

2. 验证安装

检查版本

bash 复制代码

claude --version
# 输出: 1.0.86 (Claude Code)

运行诊断

bash 复制代码

claude doctor

预期输出:

sql 复制代码

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 方法仍有问题，可以尝试官方的原生安装器：

bash 复制代码

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

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

🚨 待解决问题

网络连接问题

可能的解决方案:

检查网络连接:
bash 复制代码
```
curl -I https://api.anthropic.com
```
检查地区支持:
- 访问 Anthropic 支持的国家列表
- 确认您的地区是否支持 Claude Code
代理设置: 如果使用代理，确保 Claude Code 可以通过代理访问 Anthropic 服务
防火墙设置 : 检查防火墙是否阻止了对 api.anthropic.com 的访问

Raw Mode 错误

可能的解决方案:

尝试不同终端:
- iTerm2
- 原生 Terminal.app
- VS Code 集成终端
检查终端设置: 确保终端支持交互模式和原始输入
环境变量:
bash 复制代码
```
export TERM=xterm-256color
```

📚 参考资源

🎯 总结

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

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