快速上手：ClaudeCode安装全攻略

以下是从零开始安装 Claude Code 的详细操作步骤涵盖环境准备、安装过程与验证方法。请根据你的操作系统选择对应的分支操作。(PS: 官方文档接入 Claude Code | DeepSeek API Docs)一、安装 Node.js 18 或更高版本Claude Code 基于 Node.js 运行需要Node.js 18建议使用最新的 LTS 版本。1. 检查是否已安装 Node.js打开终端或命令提示符输入node --version如果显示v18.x.x或更高版本则已满足要求可跳过安装步骤。如果显示command not found或版本过低请继续安装。2. 安装 Node.jsWindows / macOS 访问 Node.js 官网下载LTS 版本的安装包运行安装程序一路默认选项即可。Linux 使用包管理器安装例如 Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs其他发行版请参考 NodeSource 指南。安装完成后重新打开终端再次运行node --version确认版本。二、Windows 用户安装 Git for WindowsmacOS / Linux 用户可跳过这一步因为系统自带或可安装 Git但一般 Claude Code 不强制要求除非使用某些 Git 集成功能。为了确保兼容性推荐所有用户都安装 Git。访问 Git for Windows 下载页。下载适合你系统32/64位的安装程序如Git-2.45.2-64-bit.exe。运行安装程序保持默认选项直到完成特别是要确保Git Bash和Git from the command line被选中。安装完成后重启终端或重启电脑输入git --version验证是否成功。三、使用 npm 全局安装 Claude Code打开终端Windows 用户推荐使用Git Bash或PowerShell普通 CMD 也可。执行以下命令npm install -g anthropic-ai/claude-code可能遇到的问题及解决权限错误EACCES 在 Linux/macOS 上可以加sudo执行sudo npm install -g anthropic-ai/claude-code或者修复 npm 全局目录权限。网络慢/超时 可以切换为淘宝镜像npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.comWindows 提示 “不能运行脚本” 以管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后重新运行安装命令。安装过程会显示进度条完成后提示added xxx packages in xxs。四、验证安装是否成功在终端中执行claude --version如果正常显示版本号例如0.1.0则安装成功。 若提示claude: command not found请检查是否成功执行了npm install -g重新运行一次看是否有报错。npm 全局安装的目录是否在系统的PATH中。查看全局目录npm config get prefix将该目录下的bin文件夹Windows 为同级目录添加到系统环境变量。五、下一步使用 Claude Code安装完成后输入claude即可启动交互式命令行工具。首次使用可能需要登录或配置 API 密钥根据官方指南操作。总结步骤一览复制用安装 Node.js 18 →node --versionWindows 用户安装 Git for Windows →git --versionnpm install -g anthropic-ai/claude-codeclaude --version如有任何错误信息请根据提示进行排错或提供具体报错内容。六、配置环境变量一Linux / macOS 用户1. 临时设置仅当前终端会话有效打开终端逐行执行以下命令将你的 DeepSeek API Key替换为真实 Keyexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key export ANTHROPIC_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVELmax验证输入echo $ANTHROPIC_AUTH_TOKEN应显示你的 API Key部分遮盖是正常的。2. 永久生效推荐将上述 export 语句添加到你的 shell 配置文件中取决于你使用的 shellBash~/.bashrc或~/.bash_profileZsh~/.zshrcFish~/.config/fish/config.fish语法略有不同示例Bash/Zshecho export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的真实Key export ANTHROPIC_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash export CLAUDE_CODE_EFFORT_LEVELmax ~/.bashrc然后执行source ~/.bashrc使其立即生效。二Windows 用户方式一PowerShell临时设置仅当前窗口有效打开PowerShell建议使用 Windows Terminal 或 PowerShell 7执行$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key $env:ANTHROPIC_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash $env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash $env:CLAUDE_CODE_EFFORT_LEVELmax验证输入$env:ANTHROPIC_AUTH_TOKEN应显示你的 Key。方式二永久设置通过系统环境变量按Win R输入sysdm.cpl并回车。切换到高级选项卡 → 点击环境变量。在用户变量或系统变量区域点击新建依次添加以下变量变量名变量值ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key如sk-xxxxANTHROPIC_MODELdeepseek-v4-pro[1m]ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashCLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashCLAUDE_CODE_EFFORT_LEVELmax点击确定保存然后重启终端或重启电脑使设置生效。 你也可以使用命令行设置永久环境变量PowerShell 管理员[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://api.deepseek.com/anthropic,User)其余变量同理但操作较繁琐建议直接用图形界面。三验证环境变量是否生效Linux/macOSecho $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN | cut -c1-10 # 只显示前10位避免泄露Windows (PowerShell)echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN.Substring(0,10)四启动 Claude Code完成上述配置后在同一个终端中若设置了永久变量则任意新终端直接输入claudeClaude Code 会读取这些环境变量将请求发送到 DeepSeek 的 Anthropic 兼容接口并使用你配置的模型注意deepseek-v4-pro[1m]和deepseek-v4-flash需确保在 DeepSeek 平台确实存在对应模型名称如名称有差异请根据官方文档调整。常见问题claude: command not found说明第一步安装未成功请回到安装步骤重新执行npm install -g anthropic-ai/claude-code。API 调用返回 401检查ANTHROPIC_AUTH_TOKEN是否设置正确且未过期。模型不存在错误登录 DeepSeek 平台查看可用的模型名称修正环境变量中的模型名如可能是deepseek-chat或deepseek-reasoner。Windows 提示“无法加载 PowerShell 配置文件”忽略不影响环境变量设置只需确保在执行claude之前运行过$env:...命令。如果需要将环境变量设置写成脚本例如每次运行前自动加载也可以创建一个set-env.ps1文件每次先执行它再运行claude。