Claude Code 安装与 DeepSeek 第三方 API 配置教程

Claude Code 发布有一段时间了，在日常开发中的提效非常明显，尤其在阅读复杂项目、重构、写单测这些场景下，比 Chat 类产品更直接。

但官方的 Claude API 付费门槛和网络限制确实卡掉了一部分人。国内开发者如果手头已经有 DeepSeek 的额度，完全可以把 Claude Code 接到 DeepSeek 上用。这篇把整个过程梳理一遍：Mac 装 Claude Code → VSCode 里跑起来 → 绑定 DeepSeek API。

一、什么是 Claude Code

Claude Code 和 Cursor / Copilot 这类 IDE 增强工具不一样——它不是一个“补全插件”，而是一个运行在终端里的Agent 式编程助手。

核心差异：

直接操作文件系统：能读、写、编辑项目文件，不用你手动粘贴代码上下文
能跑命令：在你的授权下执行 bash 命令，装依赖、跑测试、查 git 状态
上下文长：天然适合理解大型项目，直接扫目录结构、大量源码
任务导向：你说“修这个 bug”，它会自己定位文件、分析原因、改完跑测试验证

Claude Code 有两种运行方式：

终端 CLI：在 Mac 终端里直接敲 claude 进入交互
VSCode 插件：在 IDE 侧边栏用，体验更接近编辑器内工具

二、Mac 终端安装 Claude Code

2.1 通过 npm 安装（推荐）

确保本机有 Node.js 18+，然后全局安装：

1	npm install -g @anthropic-ai/claude-code

安装完成后验证：

1	claude --version

2.2 首次启动

直接在终端敲：

claude

首次进入会引导你完成登录认证（OAuth 跳转到浏览器）。登录一次后，凭证会持久化到本地，后续直接敲 claude 进交互。

2.3 常用启动参数

claude                    # 进入交互模式
claude "修一下这个bug"     # 单次任务模式，执行完退出
claude -p "解释这个函数"   # 只输出结果，不进入交互
claude --model haiku      # 指定模型
claude config             # 打开配置界面

三、VSCode 中配置 Claude Code

3.1 安装插件

在 VSCode 插件市场搜索 「Claude Code」（发布者为 Anthropic），直接安装即可。

3.2 打开 Claude Code 面板

安装完成后，有几种方式唤起：

快捷键：Cmd + Shift + P → 输入 Claude Code: Open
侧边栏图标：VSCode 左侧活动栏会出现 Claude Code 图标，点击即可

3.3 VSCode 内置终端方式

如果你更喜欢终端体验，也可以直接在 VSCode 内置终端中敲 claude —— 效果和 Mac 终端完全一样，好处是不用切窗口。

1 2	# 在 VSCode 终端中 claude

两种方式选哪个取决于习惯：

VSCode 插件：方便 IDE 内对照代码，选中文件直接丢给 Claude
终端 CLI：更灵活，不依赖 IDE，可以在任意项目目录里用

四、配置 DeepSeek 第三方 API

Claude Code 默认走 Anthropic 官方 API。如果想走 DeepSeek，需要把 API 入口指向 DeepSeek 兼容端点。

4.1 获取 DeepSeek API Key

打开 DeepSeek 开放平台，登录后在 「API Keys」 页面创建一个 Key，拷贝备用。

4.2 方案一：VSCode 插件内配置（推荐 VSCode 用户）

如果你用的是 VSCode 里的 Claude Code 插件，可以直接在 VSCode 的 settings.json 中配置环境变量，无需改动系统终端配置。

打开 VSCode 设置（Cmd + ,），搜索 claudeCode.environmentVariables，或在 settings.json 中直接编辑：

"claudeCode.environmentVariables": [
    {
        "name": "ANTHROPIC_BASE_URL",
        "value": "https://api.deepseek.com/anthropic"
    },
    {
        "name": "ANTHROPIC_API_KEY",
        "value": "sk-155b1f78516bxxxxx"
    },
    {
        "name": "ANTHROPIC_MODEL",
        "value": "deepseek-v4-pro[1m]"
    },
    {
        "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
        "value": "deepseek-v4-pro[1m]"
    },
    {
        "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
        "value": "deepseek-v4-pro[1m]"
    },
    {
        "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
        "value": "deepseek-v4-flash"
    },
    {
        "name": "CLAUDE_CODE_SUBAGENT_MODEL",
        "value": "deepseek-v4-flash"
    },
    {
        "name": "CLAUDE_CODE_EFFORT_LEVEL",
        "value": "max"
    }
]

关键变量说明：

变量	作用
`ANTHROPIC_BASE_URL`	指向 DeepSeek 的 Anthropic 兼容端点
`ANTHROPIC_API_KEY`	DeepSeek 开放平台的 API Key
`ANTHROPIC_MODEL`	默认使用的模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	替代 Opus 角色（最强模型），一般指向 DeepSeek 最强推理模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	替代 Sonnet 角色（均衡模型）
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	替代 Haiku 角色（轻量模型），用 flash 低成本做简单任务
`CLAUDE_CODE_SUBAGENT_MODEL`	SubAgent 使用的模型，建议用 flash 省钱
`CLAUDE_CODE_EFFORT_LEVEL`	推理深度，`max` 即最强

4.3 方案二：终端环境变量配置

如果你用的是终端 CLI 版 Claude Code，在 ~/.zshrc 中添加：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_API_KEY=sk-155b1f78516bxxxxx
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

然后 source ~/.zshrc 使其生效。

验证配置：

1 2	echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODEL

4.4 方案三：`.claude/settings.json` 配置文件

Claude Code 还支持通过配置文件设置环境变量，适合项目级精细化控制。

全局配置（对所有项目生效），编辑 ~/.claude/settings.json：

{
  "theme": "dark",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_API_KEY": "sk-155b1f78516bxxxxx",
    "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"
  }
}

项目级配置（只对当前项目生效）：在项目根目录创建 .claude/settings.json，内容同上。

优先级：VSCode 插件配置 ≈ 项目级 .claude/settings.json > 全局 ~/.claude/settings.json > 终端环境变量。

注意：ANTHROPIC_BASE_URL 需要指向 DeepSeek 的 Anthropic 兼容端点。如果 DeepSeek 官方未提供该端点，可以走下方 4.5 搭一层 LiteLLM 本地代理做格式转换。

4.5 方案四：LiteLLM 本地代理（万能方案）

如果 DeepSeek 的 Anthropic 兼容端点不满足需求，或者想同时接入多家 API，可以用 LiteLLM 搭一层本地代理。

安装 LiteLLM：

1	pip install litellm

启动代理：

1	litellm --model deepseek/deepseek-chat --port 4000

配置 Claude Code 指向本地代理：

1 2	export ANTHROPIC_BASE_URL=http://localhost:4000 export ANTHROPIC_API_KEY=sk-your-deepseek-key

LiteLLM 会把 Anthropic 格式的请求翻译成 DeepSeek 格式，把 DeepSeek 的回复翻译回 Anthropic 格式。这意味着你可以在 Claude Code 里用 DeepSeek 的模型，同时保留 Claude Code 全部功能。

4.6 配置后验证

配置完成后，启动 Claude Code：

claude

如果看到 Claude Code 正常进入交互界面且能对话，说明 DeepSeek API 已接通。

也可以显式检查模型信息：

1 2	claude --version claude config

五、常见问题

Q1：DeepSeek 模型在 Claude Code 里好用吗？

可用，但有差距。Claude Code 的一些高级功能（如 tool use 的复杂编排、长上下文理解）在 DeepSeek 模型上的表现和官方 Claude 模型会有差异。日常代码阅读、简单重构、写注释这类场景足够，复杂任务建议还是在官方 API 上跑。

Q2：ANTHROPIC_BASE_URL 配了不生效？

确认三点：

echo $ANTHROPIC_BASE_URL 确实输出了你填的地址
如果同时配了多处，优先级为：VSCode 插件配置 ≈ 项目级 .claude/settings.json > 全局 ~/.claude/settings.json > 终端环境变量。高层级会覆盖低层级
重新打开一个终端窗口或重启 VSCode，确保新配置已加载

Q3：VSCode 插件和终端 CLI 能同时用吗？

可以。它们共享同一套全局凭证。你在终端配好的 DeepSeek API，VSCode 插件的 Claude Code 也会直接用。

Q4：能否在多个第三方 API 之间切换？

可以。切换时修改 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 指到不同的 API 提供商即可。或者用 LiteLLM 代理同时接入多家 API，在 LiteLLM 层面做路由。

Q5：配置了第三方 API，启动 claude 后仍然弹出登录页面？

这说明配置文件没有被正确加载，Claude Code 读取不到你设的第三方 API 凭据，回退到了官方 OAuth 登录流程。

排查步骤：

检查配置文件路径是否正确：全局配置在 ~/.claude/settings.json，确认文件确实存在且 JSON 格式有效
检查 JSON 语法：多了逗号、少了括号都会导致解析失败，可以用 cat ~/.claude/settings.json | python -m json.tool 快速校验
VSCode 用户检查插件配置：确认 claudeCode.environmentVariables 数组已正确写入 VSCode 的 settings.json

终极解决方案——清空 Claude Code 的本地状态，从头配置：

1	rm -rf ~/.claude ~/.claude.json

这会清除 Claude Code 的历史登录态、缓存和旧配置。然后重新配置 ~/.claude/settings.json，再次启动 claude 就不会弹登录了。

六、总结

Mac 装 Claude Code：npm install -g @anthropic-ai/claude-code，一键完成
VSCode 集成：插件市场搜 Claude Code 装上，配置 claudeCode.environmentVariables 填入 DeepSeek 凭据
接 DeepSeek：四种方式任选一——VSCode 插件配置 / 终端环境变量 / .claude/settings.json / LiteLLM 代理
模型映射：核心模型指到 deepseek-v4-pro[1m]，SubAgent 指到 deepseek-v4-flash，主辅搭配兼顾效果和成本

这套配下来，你在 VSCode 或终端敲 claude 就能进入 Agent 编程模式，背后跑的是 DeepSeek，不依赖 Anthropic 官方账单。

Claude Code 安装与 DeepSeek 第三方 API 配置教程

Claude Code 安装与 DeepSeek 第三方 API 配置教程

一、什么是 Claude Code

二、Mac 终端安装 Claude Code

2.1 通过 npm 安装（推荐）

2.2 首次启动

2.3 常用启动参数

三、VSCode 中配置 Claude Code

3.1 安装插件

3.2 打开 Claude Code 面板

3.3 VSCode 内置终端方式

四、配置 DeepSeek 第三方 API

4.1 获取 DeepSeek API Key

4.2 方案一：VSCode 插件内配置（推荐 VSCode 用户）

4.3 方案二：终端环境变量配置

4.4 方案三：.claude/settings.json 配置文件

4.5 方案四：LiteLLM 本地代理（万能方案）

4.6 配置后验证

五、常见问题

Q1：DeepSeek 模型在 Claude Code 里好用吗？

Q2：ANTHROPIC_BASE_URL 配了不生效？

Q3：VSCode 插件和终端 CLI 能同时用吗？

Q4：能否在多个第三方 API 之间切换？

Q5：配置了第三方 API，启动 claude 后仍然弹出登录页面？

六、总结

4.4 方案三：`.claude/settings.json` 配置文件