Claude Code 安装与配置指南第三方 API 接入适用平台Windows / Linux / macOS前置环境Node.js v18 及以上版本目录1. 环境准备2. 安装 Claude Code3. 配置第三方 API4. 绕过登录验证5. 验证安装6. 常见问题1. 环境准备安装 Node.jsClaude Code 基于 Node.js 运行需要v18 或更高版本。前往 Node.js 官方网站下载 LTS 版本当前为 v22.x安装完成后打开终端验证node--version# 应输出类似 v20.x.x 或 v18.x.xnpm--version# 应输出类似 10.x.x也可通过 nvmNode Version Manager等版本管理工具安装便于后续切换 Node.js 版本。Windows 额外要求在 Windows 上建议安装 Git for Windows以便获得完整的 Bash 工具支持。安装时选择默认选项即可安装完成后右键桌面或文件夹即可看到 “Open Git Bash here”。2. 安装 Claude Code提供四种安装方式选择其中一种即可。方式一npm 全局安装推荐跨平台通用npminstall-ganthropic-ai/claude-code注意不要使用sudo否则可能导致权限问题。如果遇到权限错误请以管理员身份运行终端。安装后验证claude--version如果正确输出版本号说明安装成功。如果提示claude: command not found需将~/.local/bin加入 PATHLinux / macOSexportPATH$HOME/.local/bin:$PATHWindows将%USERPROFILE%\.local\bin添加到系统环境变量 Path 中。3. 配置第三方 APIClaude Code 默认使用 Anthropic 官方 API但支持通过环境变量配置兼容 Anthropic 协议的第三方端点从而实现使用其他模型提供商的服务。本文以 DeepSeek 为例说明配置方法。DeepSeek 提供了与 Anthropic Messages API 兼容的端点可直接替换使用。其他提供兼容端点的服务商配置方式类似。3.1 获取 API Key在模型提供商的开发者平台申请 API Key。以 DeepSeek 为例在 DeepSeek Platform 的 API Keys 页面创建 Key格式通常为sk-开头。3.2 创建配置文件找到 Claude Code 的配置目录平台配置文件路径WindowsC:\Users\%USERNAME%\.claude\settings.jsonLinux / macOS~/.claude/settings.json在该文件中写入以下配置请将你的API-Key替换为实际 Key{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:你的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}}3.3 环境变量说明变量名说明ANTHROPIC_BASE_URL第三方 Anthropic 兼容端点地址ANTHROPIC_AUTH_TOKEN第三方服务的 API KeyANTHROPIC_MODEL默认使用的对话模型ANTHROPIC_DEFAULT_OPUS_MODELOpus 级别模型处理复杂任务ANTHROPIC_DEFAULT_SONNET_MODELSonnet 级别模型均衡型ANTHROPIC_DEFAULT_HAIKU_MODELHaiku 级别模型轻量快速CLAUDE_CODE_SUBAGENT_MODEL子代理使用的模型CLAUDE_CODE_EFFORT_LEVEL推理努力程度可选值max/high/medium/low3.4 模型选择不同模型在上下文长度和适用场景上有所区别模型上下文窗口适用场景deepseek-v4-pro[1m]1M tokens复杂任务、大型项目开发deepseek-v4-flash标准子代理执行、简单问答等轻量场景可根据实际需求选择合适的模型组合。对于日常使用主模型选择pro版本、子代理选择flash版本是常见的配置方案。4. 绕过登录验证使用第三方 API 不需要 Anthropic 账号可以通过以下方式跳过首次启动时的登录引导Linux / macOS编辑~/.claude.json添加{hasCompletedOnboarding:true}Windows编辑C:\Users\%USERNAME%\.claude.json添加同上配置。注意如果.claude.json不存在手动创建即可。5. 验证安装安装和配置完成后运行以下命令验证# 检查版本claude--version# 运行诊断claude doctor# 启动交互模式claude如果一切正常Claude Code 将使用配置的第三方 API 启动交互式编程助手。6. 常见问题Q: API 请求返回 401 错误检查 API Key 是否正确填写确认 Key 在对应平台上处于有效状态。Q: npm 安装速度慢可通过设置 npm 镜像源解决npmconfigsetregistry https://registry.npmmirror.com安装完成后再恢复默认npmconfigsetregistry https://registry.npmjs.org参考链接资源链接DeepSeek API 文档https://api-docs.deepseek.com/DeepSeek Claude Code 集成指南https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code/