Claude Code 安装配置完整指南

Claude Code 安装配置完整指南

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，能完整理解你的代码库、执行文件读写、跑命令、写测试、处理 Git 操作，特别适合日常重度开发场景。

---

一、安装 Claude Code

官方现在主推一键安装脚本，比以前纯 npm 的方式更简单（npm 依然可用）。

macOS / Linux / WSL：

curl-fsSLhttps://claude.ai/install.sh|bash

Windows PowerShell：

irmhttps://claude.ai/install.ps1|iex

备选（上述命令失败时用）：npm 安装（需要 Node.js 22+）：

Node.js 如果你没安装，需要先从官方地址下载安装 https://nodejs.org/zh-cn/download

npminstall-g@anthropic-ai/claude-code

安装完成后验证一下，有版本号等输出，证明安装成功：

claude--version

---

二、认证配置（第三方 API Key 方式）

因为国内访问官方服务不方便，我们用第三方提供 Anthropic 兼容接口的服务来配置。

以常见模型站的服务为例：

1. 注册并充值
2. 在“令牌管理”或对应页面创建 API Key
3. 复制 Key 备用（建议新建专用令牌）

0. 跳过官方登录验证（非必要）

很多教程都要在用户主目录创建或编辑~/.claude.json文件并设置"hasCompletedOnboarding": true来跳过官方登录验证，实际上并不需要。只要在配置中设了ANTHROPIC_BASE_URL+ANTHROPIC_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换成服务商提供的地址，不需要加/v1；ANTHROPIC_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

---