Claude Code 安装配置完整指南

Claude Code 安装配置完整指南Claude Code 是 Anthropic 官方推出的终端 AI 编程助手能完整理解你的代码库、执行文件读写、跑命令、写测试、处理 Git 操作特别适合日常重度开发场景。一、安装 Claude Code官方现在主推一键安装脚本比以前纯 npm 的方式更简单npm 依然可用。macOS / Linux / WSLcurl-fsSLhttps://claude.ai/install.sh|bashWindows PowerShellirmhttps://claude.ai/install.ps1|iex备选上述命令失败时用npm 安装需要 Node.js 22Node.js 如果你没安装需要先从官方地址下载安装 https://nodejs.org/zh-cn/downloadnpminstall-ganthropic-ai/claude-code安装完成后验证一下有版本号等输出证明安装成功claude--version二、认证配置第三方 API Key 方式因为国内访问官方服务不方便我们用第三方提供 Anthropic 兼容接口的服务来配置。以常见模型站的服务为例注册并充值在“令牌管理”或对应页面创建 API Key复制 Key 备用建议新建专用令牌0. 跳过官方登录验证非必要很多教程都要在用户主目录创建或编辑~/.claude.json文件并设置hasCompletedOnboarding: true来跳过官方登录验证实际上并不需要。只要在配置中设了ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN登录就会被跳过。当然如果你本机就是要登录配置一下也没问题。在用户主目录创建或编辑~/.claude.json文件Windows 是C:\Users\你的用户名\.claude.json添加以下内容。这个文件的参数改一次就行后续不要动就永久有效{hasCompletedOnboarding:true}这个配置能绕过 Claude Code 的浏览器登录流程直接用 API Key 工作。1. 全局配置 settings.json默认在用户主目录创建或编辑~/.claude/settings.json文件Windows 是C:\Users\你的用户名\.claude\settings.json。填入以下内容把ANTHROPIC_BASE_URL换成服务商提供的地址不需要加/v1ANTHROPIC_AUTH_TOKEN换成你从第三方拿到的 Key模型名称也配置正确{env:{ANTHROPIC_BASE_URL:https://xxxx.com,ANTHROPIC_AUTH_TOKEN:sk-xxxxxxxxxxxxxxxxxxxxxxxx,ANTHROPIC_DEFAULT_HAIKU_MODEL:claude-haiku-xxx,ANTHROPIC_DEFAULT_SONNET_MODEL:claude-sonnet-xxx,ANTHROPIC_DEFAULT_OPUS_MODEL:claude-opus-xxx,ANTHROPIC_MODEL:claude-sonnet-xxx,CLAUDE_CODE_SUBAGENT_MODEL:claude-haiku-xxx,CLAUDE_CODE_ATTRIBUTION_HEADER:0,CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS:1,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}直接启动 Claude会加载该默认的 settings.json问好一下能收到回复即可。2. 多配置切换强烈建议学会如果你有多个平台的 API Key可以通过创建多个settings.json来切换。每个平台一个文件名就行。假设我们要创建 DeepSeek 平台的流程和上面一样我们可以创建一份~/.claude/settings-deepseek.json文件内容如下{env:{ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN:sk-xxxxxxxxxxxxxxxxxxxxxxxx,ANTHROPIC_DEFAULT_HAIKU_MODEL:deepseek-v4-flash,ANTHROPIC_DEFAULT_SONNET_MODEL:deepseek-v4-pro,ANTHROPIC_DEFAULT_OPUS_MODEL:deepseek-v4-pro,ANTHROPIC_MODEL:deepseek-v4-pro,CLAUDE_CODE_SUBAGENT_MODEL:deepseek-v4-flash,CLAUDE_CODE_ATTRIBUTION_HEADER:0,CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS:1,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}启动 Claude 时就可以通过--settings来加载非默认的配置文件这里有个坑就是 claude 启动时仍会先加载默认的 settings.json然后再加载 settings-deepseek.json 覆盖默认的。如果你 settings-deepseek.json 中有些参数没配置但默认的 settings.json 中配置了就会导致一部分参数是 settings-deepseek.json 中的一部分是 settings.json 中的运行的时候会有奇怪的问题。所以建议你每一份 settings 都把参数写全了、对齐了不重不漏。claude--settings~/.claude/settings-deepseek.json