1、必要的条件
2、安装 Claude Code
2.1 安装方式说明
Claude Code 官方提供原生安装器和 npm 等安装方式。
由于目前被各种封锁的原因,在国内使用官方原生安装器,大概率会失败,Claude Code 对大陆地区的 ip 以及代理严防死,即使科学上网也未必能成功。
虽然 npm 也可以进行安装,不过目前官方已不推荐通过 npm 管理 Claude Code,但由于没有其它方式,所以 npm 更换国内源后安装 Claude Code 仍是目前比较便捷的选择。
2.2 方式一:原生安装器(可选)
官网地址:https://claude.com/
原生安装器命令(原生安装器安装命令和支持系统可能变化,使用前请以 Claude Code 官方 setup 文档为准):
curl -fsSL https://claude.ai/install.sh | bash
2.3 方式二:npm 安装
npm get registry #查看镜像源
npm config set registry https://registry.npmmirror.com #更换阿里镜像
npm install -g @anthropic-ai/claude-code
Windows 提醒:Claude Code 对 Windows 的支持方式会随版本变化。若官方文档提示通过 WSL 使用,请在 WSL 的 Linux 终端里执行安装和环境变量配置;如果当前版本支持原生 Windows,再按官方 Windows 说明操作。
2.4 验证安装:
claude --version
预期输出:

3、配置文件和参数说明
安装好 Claude Code 后,需要配置 API 密钥或登录方式才能使用。
3.1 配置文件路径说明
3.2 三种配置方式对比
| 配置方式 | 持久性 | 作用范围 | 推荐场景 |
|---|---|---|---|
| 临时环境变量 | 关闭终端即失效 | 当前终端窗口 | 快速测试、临时切换 |
| 永久环境变量 | 永久生效 | 所有终端和项目 | 日常一台电脑固定使用 |
配置文件 settings.json |
永久生效 | 全局或特定项目 | 多项目/多模型切换、团队共享 |
3.3 核心配置参数速查表
| 参数(环境变量) | 作用 | 何时使用 |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic 官方 API Key | 直接使用官方服务时 |
| ANTHROPIC_AUTH_TOKEN | 第三方平台的 API Key | 使用中转/第三方模型时 |
| ANTHROPIC_BASE_URL | API 端点地址(覆盖默认地址) | 使用中转/第三方服务时 |
| ANTHROPIC_MODEL | 默认使用的模型名称或别名 | 持久指定默认模型 |
| ANTHROPIC_DEFAULT_OPUS_MODEL | opus 槽位映射的具体模型 | 自定义三级槽位映射 |
| ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 槽位映射的具体模型 | 自定义三级槽位映射 |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 槽位映射的具体模型 | 自定义三级槽位映射 |
| API_TIMEOUT_MS | API 请求超时时间(毫秒) | 网络慢或模型推理耗时长时 |
| CLAUDE_CODE_SUBAGENT_MODEL | 为子Agent指定经济高效的模型 | 大量低成本子任务 (扫描、搜索、简单分析) |
| CLAUDE_CODE_EFFORT_LEVEL | 控制全局推理深度(low~max) | 复杂设计/调试时用 max 常规任务用 high 或 medium |
提示:参数关系说明:`ANTHROPIC_API_KEY` 用于官方直连,`ANTHROPIC_AUTH_TOKEN` 用于第三方服务。两者不要同时设置,否则会冲突。`ANTHROPIC_BASE_URL` 只在使用非官方端点时需要设置。
4、 配置 API 密钥或登录方式
4.1 使用 Anthropic 官方 API(推荐海外用户)
这是最直接的配置方式,适合能稳定访问 Anthropic 服务、具备合规支付方式的用户。国内用户可能会遇到注册、支付、访问稳定性等问题,建议按自己的网络和合规条件谨慎选择。
⑴ 设置环境变量:需要将 API Key 设置为系统环境变量,这样 Claude Code 启动时就能自动读取。
① Windows 用户(PowerShell)
方法一:临时设置(仅当前终端窗口有效,关闭后失效)
$env:ANTHROPIC_API_KEY = "sk-ant-api03-你的实际API-Key"
方法二:永久设置(推荐,一次设置永久生效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-api03-你的实际API-Key", "User")
注意:永久设置后需要重新打开终端才能生效。
② macOS / Linux 用户
编辑 shell 配置文件(根据使用的 shell 选择),如果用 zsh(macOS 默认):
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >~/.zshrc
如果用 bash:
$ echo 'export ANTHROPIC_API_KEY="sk-ant-api03-你的实际API-Key"' >~/.bashrc
使配置立即生效:
$ source ~/.zshrc 或 source ~/.bashrc
4.2 使用第三方API中转服务(国内用户)
如果在国内无法直接访问 Anthropic 的服务,这个方案大概是最佳选择。
注意:很多个人搭建的中转平台,溢价严重,甚至有作假的情况,请仔细甄别。而且避免封号的情况也无法保证,这里不做推荐。
⑴ 主流中转服务对比
| 服务商 | 价格倍率 | 支持模型 | 注册门槛 | 特点 |
|---|---|---|---|---|
| OpenRouter | 1.0-1.1x | Claude全系列 + GPT + 开源 | 低 | 模型最全,国际化 |
| API2D | 1.2-1.5x | Claude + GPT | 低 | 中文界面,支持支付宝 |
| OhMyGPT | 1.1-1.3x | Claude + GPT + 多种 | 低 | 价格较优 |
| CloseAI | 1.2-1.5x | Claude + GPT | 低 | 国内老牌服务 |
⑵ 设置环境变量:Claude Code 通过 `ANTHROPIC_BASE_URL` 环境变量来指定API地址。
① Windows 用户(PowerShell)
方法一:临时设置(当前窗口有效)
$env:ANTHROPIC_BASE_URL = "https://openrouter.ai/api/v1"
$env:ANTHROPIC_API_KEY = "sk-or-v1-你的中转服务Key"
方法二:永久设置(推荐)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://openrouter.ai/api/v1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-or-v1-你的中转服务Key", "User")
② macOS / Linux 用户
编辑 shell 配置文件
vim ~/.zshrc #或你喜欢的编辑器
在文件末尾添加以下两行
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-你的中转服务Key"
保存后使配置生效
$ source ~/.zshrc
4.3 接入其他模型(DeepSeek/千问/GLM)
Claude Code 不仅可以使用 Claude 模型,还可以通过配置接入其他AI模型。这对国内用户特别有价值 —— 你可以使用国内直连的模型服务,不需要任何代理。
⑴ 接入第三方模型有两种方式
| 方式 | 原理 | 优点 | 适用场景 |
|---|---|---|---|
| Anthropic 兼容接口(推荐) | 模型厂商提供 Anthropic Messages API 格式的接口,三个槽位自动映射 | 配置简单,无需逐个指定模型名 | 智谱 GLM 等已提供兼容接口的厂商 |
| 直接指定模型 | 通过 --model 或环境变量指定具体模型名称 |
灵活,适用任何 OpenAI 兼容接口 | DeepSeek、通义千问、Ollama 等 |
⑵ 接入 DeepSeek 的完整步骤
DeepSeek 是国内极具性价比的 AI 模型,代码能力强。官方为 Claude Code 专门提供了 Anthropic 兼容端点,不需要走 OpenAI 兼容接口。
① 官方文档:https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code。下面的配置与模型名与该文档一致,后续以官方文档为准。
Step 1:在 https://platform.deepseek.com/ 注册并获取 API Key。
Step 2:设置环境变量(注意 Base URL 是 `/anthropic` 端点,不是 `/v1`)
② 方法一:临时设置(仅当前终端窗口生效)
a. Windows 用户(PowerShell)
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
b. macOS / Linux 用户
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
③ 方法二:使用配置文件(推荐,不需重启终端):
打开/创建配置文件 ~/.claude/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"
}
}
⑶ 接入智谱AI步骤
智谱的官方文档地址:https://docs.bigmodel.cn/cn/guide/develop/claude
文档内部给出了手动配置的方式:
# 编辑或新增 `settings.json` 文件
# macOS & Linux 为 `~/.claude/settings.json`
# Windows 为`用户目录/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `YOUR_API_KEY` 为您上一步获取到的 API Key
# 新增 `hasCompletedOnboarding` 参数
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"API_TIMEOUT_MS": "3000000"
}
}
5、启动 Claude Code
进入项目目录,输入 claude code,启动 Claude Code

