Claude Code 安装指南

pride.li2026-09-18 14:25

Claude Code 安装指南

Claude Code 是 Anthropic 官方终端 AI 编程助手，支持 Windows、macOS 和 Linux。官方当前推荐无需 Node.js 的原生安装；npm 安装仍可使用，主要适合无法直连 claude.ai / downloads.claude.ai 的情况。Claude 账号登录与 DeepSeek / New API Token 是两套独立的认证方式。配置第三方 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 后，请求会发往第三方服务，不再使用 Claude 账号的官方模型额度；恢复官方服务时需要删除这些字段。

1. 安装

前置条件：

  • 操作系统：macOS 13+、Windows 10 1809+ / Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+；x64 或 ARM64，建议 4 GB+ 内存。
  • 原生安装不需要 Node.js；npm 备用方式需要 Node.js 18+（见 1.1）。Windows 建议先安装 Git for Windows，以便 Claude Code 使用 Bash 工具；未安装时 Claude Code 会自动改用 PowerShell 执行命令，多数功能可用，但部分 Bash 脚本受限。
  • 安装脚本和 WinGet 需要能访问 claude.ai / downloads.claude.ai，更新和部分功能还会访问 GitHub。国内网络直连失败时，先配置可用的代理再重试，或改用 1.1 的 npm + 国内镜像方式；不要反复重跑安装脚本。
  • 若之前用 npm 安装过 Claude Code，原生安装后 claude doctor 可能提示存在旧 npm 安装；按提示执行 npm uninstall -g @anthropic-ai/claude-code 清理，再重新打开终端。

1.1 Windows

Windows 10 1809+ 或 Windows Server 2019+，在普通 PowerShell 中执行：

复制代码 
irm https://claude.ai/install.ps1 | iex

也可使用 WinGet：

复制代码 
winget install Anthropic.ClaudeCode

备用方式：npm（无法直连 claude.ai 时使用，不需要代理）。

npm 包及其平台二进制都从 npm 镜像下载，不访问 downloads.claude.ai，国内网络通常无需代理即可安装。先确认已安装 Node.js 18+：

复制代码 
node -v

未安装时可用 winget 安装 Node.js LTS：

复制代码 
winget install OpenJS.NodeJS.LTS

使用国内镜像安装（仅本次命令临时生效）：

复制代码 
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

或先永久设置镜像再安装：

复制代码 
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

注意事项：

  • npm 分发渠道功能可能滞后于原生安装；装完同样用 claude --version 和 claude doctor 验证。
  • 不要与原生安装同时保留，否则 claude doctor 会提示存在多个安装。
  • 更新用 npm install -g @anthropic-ai/claude-code@latest，卸载用 npm uninstall -g @anthropic-ai/claude-code（见第 5 章）。

Git for Windows 未安装时，可先执行：

复制代码 
winget install --id Git.Git -e --source winget

或从 Git for Windows 下载安装；国内网络直连 GitHub 失败时可改用镜像：CNPM Binaries Mirror。装完后重新打开 PowerShell。

安装完成后关闭并重新打开终端。

1.2 macOS

macOS 13+，在终端中执行：

复制代码 
curl -fsSL https://claude.ai/install.sh | bash

安装完成后重新打开终端。原生命令默认安装到 ~/.local/bin/claude。

1.3 Linux

官方支持 Ubuntu 20.04+、Debian 10+、Alpine 3.19+，也可在 WSL 中按 Linux 方式安装：

复制代码 
curl -fsSL https://claude.ai/install.sh | bash

安装完成后重新打开终端；当前终端尚未刷新时，可执行：

复制代码 
source ~/.bashrc  # Zsh 用户改为 source ~/.zshrc

2. 验证

复制代码 
claude --version

能够输出 Claude Code 版本号，即表示安装成功。

进一步检查安装、认证和更新状态，可运行官方诊断命令：

复制代码 
claude doctor

进入会话后也可用 /doctor 自动检查环境、设置、插件和上下文用量，并在确认后应用它提出的修复方案。

3. 配置

3.1 账号登录

复制代码 
claude

首次启动会打开浏览器，按提示登录支持 Claude Code 的 Claude Pro、Max、Team、Enterprise 或 Claude Console 账号。Claude.ai 免费计划不包含 Claude Code。

/login 只用于 Claude 官方 OAuth 登录或重新认证，不能用来填写 DeepSeek/New API 的地址和密钥。

3.2 API Key（DeepSeek / New API 示例）

Claude Code 的持久化用户配置文件是：

系统 用户配置文件
Windows %USERPROFILE%\.claude\settings.json
macOS / Linux ~/.claude/settings.json

下面两个示例都修改这个文件，但一次只能启用一个方案。已有设置时，应把 env 中的字段合并进原 JSON 对象，不要直接覆盖已有的权限、插件、MCP 等配置。不要把密钥写入项目级 .claude/settings.json，因为该文件通常会随项目提交。

配置中的 ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 请求头发送，并覆盖当前会话中已保存的 Claude 账号登录。需要恢复官方账号时，应删除本节加入的全部第三方 env 字段并重新打开终端。

DeepSeek 示例：主会话使用 deepseek-v4-pro[1m]，后台和子代理使用 deepseek-v4-flash。

DeepSeek 当前原生提供 Anthropic Messages 兼容接口，基址是 https://api.deepseek.com/anthropic。按照 DeepSeek 官方 Claude Code 接入方案，将以下字段写入 settings.json：

复制代码 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的_DeepSeek_API_Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

字段作用如下：

  • ANTHROPIC_MODEL：主会话使用 deepseek-v4-pro[1m]。
  • ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL：把 Claude Code 的 Opus、Sonnet 内部路由固定到 deepseek-v4-pro[1m]。
  • ANTHROPIC_DEFAULT_HAIKU_MODEL、CLAUDE_CODE_SUBAGENT_MODEL：将后台轻量任务和子代理固定到 deepseek-v4-flash。
  • CLAUDE_CODE_EFFORT_LEVEL：按照 DeepSeek 当前推荐值启用 max 推理强度。

这里必须使用 ANTHROPIC_AUTH_TOKEN，不要改成 ANTHROPIC_API_KEY。DeepSeek 官方 Claude Code 配置使用 Bearer Token；放错变量会把密钥发送到不同的请求头，可能得到 401。

New API 示例：把所有 Claude Code 角色路由到 claude-sonnet-4-6。

此示例仅适用于 New API 控制台确实向当前令牌开放了 claude-sonnet-4-6，并且站点实现了 Anthropic Messages 兼容接口的情况。将以下字段写入 settings.json：

复制代码 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的NewAPI域名",
    "ANTHROPIC_AUTH_TOKEN": "你的_NewAPI_令牌",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

使用该示例前必须确认以下几点：

  1. ANTHROPIC_BASE_URL 填写站点根地址，不要手动追加 /v1/messages；Claude Code 会请求 https://你的NewAPI域名/v1/messages。
  2. New API 必须实现 Anthropic Messages 的 POST /v1/messages、流式输出和工具调用。只有 OpenAI 格式 /v1/chat/completions 的站点不能直接使用这份配置。
  3. 如果控制台提供的准确模型 ID 不是 claude-sonnet-4-6，必须替换上面五处模型 ID。Base URL 只决定请求发往哪里，不会自动选择或转换模型。
  4. CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 要求 Claude Code 2.1.129 或更高版本，并要求网关提供 GET /v1/models。支持时，可在 /model 中看到标有 From gateway 的模型；不支持时仍可使用上面手动填写的模型 ID，但调试日志会记录模型发现失败。

New API 官方配置工具和 Anthropic 网关文档都默认使用 ANTHROPIC_AUTH_TOKEN。只有站点管理员明确说明网关读取 x-api-key 请求头时，才改用 ANTHROPIC_API_KEY，两种密钥变量不要同时保留。

保存并验证：

  1. 确认 settings.json 是合法 JSON，保存文件并完全退出所有正在运行的 claude 进程。
  2. 重新打开终端并运行 claude，输入 /status。其中的 Anthropic base URL 应显示 DeepSeek 或 New API 地址，认证来源应显示 ANTHROPIC_AUTH_TOKEN，当前模型应与配置一致。
  3. 退出状态页面并发送一条消息，或执行 claude -p "只回复：配置成功"。能够正常返回结果，说明 Base URL、Token 和模型路由均已生效。
  4. 如果仍然调用旧模型，检查 shell 配置文件中是否残留 ANTHROPIC_MODEL、ANTHROPIC_BASE_URL 等旧变量，并重新打开终端。

settings.json 中含有明文密钥，不能提交到 Git、网盘同步目录或聊天记录。第三方网关不是 Anthropic 官方服务，使用前应核对模型真实性、计费、日志留存和数据处理规则。

4. 更新

  • 官方原生安装会自动后台更新，也可手动执行：

    claude update
    claude --version

  • WinGet 安装在退出 Claude Code 后执行：

    winget upgrade Anthropic.ClaudeCode
    claude --version

  • npm 安装执行：

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

5. 卸载

按安装方式对应卸载：

  • 原生安装（install.ps1 / install.sh）：运行 claude uninstall；若提示找不到该命令，手动删除 ~/.local/bin/claude（Windows 为 %USERPROFILE%\.local\bin\claude.exe）。
  • WinGet 安装：winget uninstall Anthropic.ClaudeCode。
  • npm 安装（旧版）：npm uninstall -g @anthropic-ai/claude-code。

卸载程序后，配置和登录数据仍保留在 ~/.claude/（Windows 为 %USERPROFILE%\.claude\）。要彻底清除（含密钥、登录凭据），手动删除该目录；删除前确认不再需要其中的配置。

相关推荐
云烟成雨TD8 小时前
LlamaIndex 系列【29】检索增强策略：路由（Routing）机制
ai·agent·rag·llamaindex
蒲公英eric9 小时前
从旧接口泄露到 OAuth 保护：DVWA API 模块完整漏洞分析教程
web安全·ai·ctf·dvwa·ai安全·api模块
fenglovemu9 小时前
2026深圳制造工厂AI转型实战指南：从试点验证到产线规模落地
ai·ai技术·ai培训
一叶飘零_sweeeet9 小时前
ZCode 把整个 Git 仓库加密上传到了阿里云 OSS：一次客户端逆向的完整复盘
ai·zcode·智普
wangjialelele9 小时前
LLM Agent 全景图：MCP、ReAct、Planner、Skill 与 ANN 检索核心原理
ai·agent·hnsw·skill·ivf·mcp
七夜zippoe9 小时前
Agent 输出质量保障：格式控制、校验机制与自动重试策略
ai·agent·自动重试·质量保障·格式控制·校验机制
gs801409 小时前
人工智能前沿技术动态与系统级演进图谱 20260918
ai
七夜zippoe9 小时前
Agent 上下文工程：Token 管理、上下文压缩与分层记忆设计
ai·agent·token·上下文压缩·分层记忆
HRaitest9 小时前
【架构拆解】从“外挂插件”到“原生基座”：2026 新一代全链路 AI 招聘系统底层技术演进
人工智能·ai·求职招聘
一个金牛座的前端9 小时前
AI 写前端，优化的是演示，不是交付
前端·ai·cursor
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点03历年考研数学一、数学二、数学三真题试卷及答案PDF04蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接05人工智能（AI）发展史：详细里程碑06微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新072026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？08ZCode 周末送额度活动开启：3 亿 Token 免费领取09数学公理体系大全:第六章 选择公理的等价形式及证明10【一等奖版】2026 国赛 A题 药材的烘干问题