「程序安装」使用 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

🚨 待解决问题

网络连接问题

可能的解决方案:

  1. 检查网络连接:

    bash 复制代码
    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. 环境变量:

    bash 复制代码
    export TERM=xterm-256color

📚 参考资源

🎯 总结

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


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

相关推荐
不老刘2 小时前
macOS/Linux ClaudeCode 安装指南及 Claude Sonnet 4.5 介绍
linux·macos·ai编程·claude·vibecoding
wuhanwhite4 小时前
Claude Sonnet 4.5:一次面向落地的常规升级(性能、安全、开发者工具)
ai·claude·agentic coding
小溪彼岸4 小时前
使用Claude Code Router轻松切换各种高性价比模型
aigc·claude
youcans_4 小时前
【Trae】Trae 插件实战手册(1)PyCharm 安装 Trae
人工智能·python·pycharm·ai编程·trae
AI大模型API6 小时前
Claude 视觉能力拆解:跨模态融合 + 动态推理,为什么它能搞定科研 / 办公的复杂图像问题?
claude
用户4099322502127 小时前
PostgreSQL里的PL/pgSQL到底是啥?能让SQL从“说目标”变“讲步骤”?
后端·ai编程·trae
小溪彼岸8 小时前
Claude Code CLI平台与中转站接入汇总及避坑
aigc·claude
小溪彼岸9 小时前
不习惯终端黑窗口?Claude Code Chat可视化插件猜你会喜欢
aigc·claude
Tassel_YUE1 天前
在国内使用claude code,实操可行(随手记)
ai·ai编程·claude
用户4099322502121 天前
PostgreSQL视图不存数据?那它怎么简化查询还能递归生成序列和控制权限?
后端·ai编程·trae