1. 环境准备与工具选型
在开始安装Claude Code和OpenAI Codex之前,我们需要先了解这两个工具的技术背景和依赖环境。Claude Code是Anthropic公司开发的AI编程助手,而OpenAI Codex则是OpenAI推出的同类产品。两者都基于Node.js环境运行,因此我们需要确保系统具备以下基础条件:
1.1 系统要求检查
对于Linux/macOS系统,建议满足以下最低配置:
- 操作系统:macOS 10.15+ 或主流Linux发行版(Ubuntu 20.04+/CentOS 7+)
- 内存:至少4GB RAM(8GB以上更佳)
- 存储空间:至少2GB可用空间
- Node.js版本:v16.x或更高版本
检查系统Node.js版本的方法:
bash复制node -v
如果未安装或版本过低,可以通过以下命令安装最新LTS版本:
bash复制# 使用nvm安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts
# 或者直接安装
# macOS使用brew
brew install node
# Linux使用系统包管理器
# Ubuntu/Debian
sudo apt update && sudo apt install -y nodejs npm
1.2 网络环境配置
由于需要从官方源和GitHub下载资源,建议:
- 确保网络能正常访问npm官方仓库(registry.npmjs.org)
- 对于国内用户,可以配置淘宝镜像加速:
bash复制npm config set registry https://registry.npmmirror.com
重要提示:安装过程中如遇网络问题,可尝试以下解决方案:
- 检查代理设置(如有)
- 临时关闭防火墙测试连接
- 使用
ping registry.npmjs.org测试网络连通性
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Claude Code安装详解
2.1 通过脚本自动化安装
原始教程提供的安装脚本是一个便捷的选择,但我们需要深入理解其工作原理。该脚本主要完成以下操作:
- 环境检查(Node.js版本、npm权限等)
- 清理旧版本(如果存在)
- 从官方源安装最新版Claude Code
- 创建必要的配置目录结构
执行安装命令:
bash复制curl -fsSL https://gitee.com/CoderRouter/scripts/raw/master/install_claude.sh | sed 's/\r$//' | sh
安全提示:执行远程脚本前,建议先检查脚本内容:
bash复制curl -fsSL https://gitee.com/CoderRouter/scripts/raw/master/install_claude.sh | less
2.2 手动安装流程
如果对自动化脚本不放心,可以按照以下步骤手动安装:
- 全局安装Claude Code包:
bash复制npm install -g @anthropic-ai/claude-code
- 验证安装是否成功:
bash复制which claude
claude -v
- 创建配置目录:
bash复制mkdir -p ~/.claude
2.3 权限问题处理
在Linux系统下,可能会遇到EACCES权限错误。解决方案有:
方案一:使用node版本管理器(推荐)
bash复制# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# 重新加载shell配置
source ~/.bashrc # 或 ~/.zshrc
# 安装Node.js并设置默认版本
nvm install --lts
nvm use --lts
方案二:修改npm默认目录权限
bash复制# 创建全局安装目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 更新PATH环境变量
echo 'export PATH=~/.npm-global/bin:$PATH'
