安装claude code并调用deepseek v4教程

admin | 2026-04-27 09:47 | 阅读 2 次

要在国内环境安装 Claude Code 并调用 DeepSeek V4 模型，核心思路是利用 DeepSeek 提供的与 Anthropic 兼容的 API 接口，通过修改配置文件“无缝切换”模型。

以下是详细的操作步骤：

🛠️ 第一步：安装 Claude Code

首先，你需要安装 Node.js 环境，然后使用 npm 来安装 Claude Code 命令行工具。

打开你的终端（如 CMD、PowerShell 或 Terminal）。

运行以下命令进行全局安装：

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

安装完成后，可以通过运行 claude --version 来验证是否安装成功。

🔑 第二步：获取 DeepSeek API Key

前往 DeepSeek 开放平台注册并登录。
在平台内创建一个新的 API Key，并妥善保存。这个密钥将用于后续的配置。

⚙️ 第三步：配置 Claude Code 使用 DeepSeek

这是最关键的一步。你需要创建一个配置文件，告诉 Claude Code 不要连接官方服务，而是转向 DeepSeek 的兼容接口。

在你的用户主目录下，找到或创建 .claude 文件夹。
- Windows 路径示例: C:\Users\你的用户名\.claude\
- macOS/Linux 路径示例: ~/.claude/
在该文件夹内，创建或编辑一个名为 settings.json 的文件。
将以下 JSON 配置内容粘贴进去，并务必将 你的DeepSeek_API_Key 替换为你在第二步中获取的真实 API Key。
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  },
  "model": "deepseek-v4-pro"
}
```
配置说明：
- ANTHROPIC_BASE_URL: 指向 DeepSeek 的兼容 API 地址。
- ANTHROPIC_AUTH_TOKEN: 你的 DeepSeek API Key，注意字段名是 ANTHROPIC_AUTH_TOKEN 而不是 API_KEY。
- ANTHROPIC_MODEL 等: 将不同能力的模型（如 Opus, Sonnet）都指向 DeepSeek 的对应模型。这里将重量级任务指向 deepseek-v4-pro，轻量级任务指向 deepseek-v4-flash，以平衡性能和成本。
- CLAUDE_CODE_EFFORT_LEVEL: 设置为 max 可以拉满模型的推理能力。

🚀 第四步：启动并使用

配置完成后，你就可以启动 Claude Code 了。

在终端中进入你想要操作的任意项目目录。
运行命令：
```
claude
```
启动成功后，界面底部应该会显示当前正在使用的模型，例如 deepseek-v4-pro · API Usage Billing。
现在，你可以像使用原版 Claude Code 一样向它提问，它会通过 DeepSeek V4 模型来回答你的问题。

⚠️ 重要提示

旧模型弃用：请注意，DeepSeek 官方已宣布旧模型 deepseek-chat 和 deepseek-reasoner 将于 2026年7月24日 停用。建议在新的配置中直接使用 deepseek-v4-pro 或 deepseek-v4-flash。
费用：使用此方法调用 DeepSeek 模型会产生相应的 API 调用费用，但通常比直接使用 Anthropic 的 API 更经济。
非官方功能：此方法利用了 DeepSeek 的兼容接口，属于非官方的使用方式，配置可能会随双方服务的更新而变化。在成功配置好 Claude Code 调用 DeepSeek V4 后，你就可以开始用它来写代码了。它的操作核心是自然语言交互，你只需用文字描述需求，它就能理解、规划并执行。

以下是几种核心操作方式，帮助你快速上手：

🚀 启动并进入交互模式

在终端中，使用 cd 命令进入你的项目目录。
输入 claude 并回车，即可启动交互会话。
启动后，你就可以在提示符 > 后面直接输入指令了。

💻 核心交互技巧

1. 自然语言描述需求

这是最基本也是最强大的功能。直接告诉它你想做什么，它会分析项目结构，规划步骤，然后生成或修改代码。

示例：

> 帮我用 React 和 TypeScript 写一个待办事项(TodoList)组件，支持添加、删除和标记完成，并用 Tailwind CSS 进行样式美化。

它会自动创建或修改相关文件，并给出完整的代码实现。

2. 精准引用文件 (`@` 命令)

当你的需求只针对特定文件时，使用 @ 符号可以快速定位，避免 AI 分析整个项目，提高效率和准确性。

示例：

> 分析一下 @src/api/user.ts 这个文件的逻辑，看看有没有潜在的性能问题。
> 帮我把 @components/Button.jsx 组件重构为函数式组件。

3. 执行终端命令 (`!` 命令)

你无需离开 Claude Code 的界面，就可以直接运行终端命令，实现一体化操作。

示例：
```
> !git status
> !npm run dev
> !ls -la
```

4. 调试与修复 Bug

遇到报错时，直接将错误信息粘贴给它，它能快速定位问题并提供修复方案。

示例：

> 运行时报错：`TypeError: Cannot read properties of undefined (reading 'map')`，帮我定位并修复。

🧠 高阶使用模式

Plan Mode (规划模式)

这是处理复杂任务时的“神器”。在动手修改代码前，先让 AI 生成一份详细的执行计划，等你确认无误后，它再按计划执行，可以有效避免“跑偏”。

如何开启： 在会话中按下 Shift + Tab 组合键，即可在普通模式和规划模式间切换。
操作流程：
1. 切换到 Plan Mode。
2. 输入你的复杂需求，例如：“我想为项目添加一个用户认证功能，包括登录、注册和JWT令牌管理。”
3. AI 会分析代码，然后输出一份详细的计划，比如需要修改哪些文件、创建哪些新文件、具体的实现步骤等。
4. 你审阅计划后，再次按下 Shift + Tab 切回普通模式，AI 就会严格按照已确认的计划开始编码。

📝 常用斜杠命令 (`/` 命令)

斜杠命令是 Claude Code 的控制面板，可以让你执行一些特定操作。

💡 最佳实践：初始化项目

在开始一个新项目时，强烈建议先运行 /init 命令。

作用： 它会自动扫描你的项目，生成一个 CLAUDE.md 文件。这个文件就像是给 AI 的“项目说明书”，里面包含了项目结构、技术栈、编码规范等信息。
好处： 有了这个文件，AI 能更深刻地理解你的项目，后续生成的代码会更符合你的项目风格，准确率也更高。你也可以手动编辑这个文件，加入你自己的偏好和要求。让 Claude Code（调用 DeepSeek V4）全程使用中文回答，最稳妥的方法是将指令写入配置文件。这样设置后，无论是代码注释、解释说明还是报错分析，它都会默认使用中文。

以下是三种不同层级的设置方法，推荐优先使用方法一或方法二，因为它们能“一劳永逸”。

方法一：修改全局配置（推荐，一劳永逸）

这是最彻底的方法，设置一次后，你在任何项目中使用 Claude Code 都会生效。

找到你的用户配置目录：
- Windows: C:\Users\你的用户名\.claude\
- macOS/Linux: ~/.claude/
在该目录下，找到或创建名为 CLAUDE.md 的文件。

用文本编辑器打开它，写入以下内容并保存：

# 全局语言设置
请始终使用简体中文回答我的所有问题。
生成的代码注释、提交信息（Commit Message）以及解释说明都必须使用简体中文。

方法二：项目级配置（适合团队协作）

如果你只想在当前特定项目中强制使用中文，可以使用此方法。

在你的项目根目录下，创建一个名为 CLAUDE.md 的文件。

写入同样的指令：

# 项目语言规范
请严格遵守以下规则：
1. 所有对话、解释、建议必须使用**简体中文**。
2. 代码注释必须使用中文。
3. 严禁出现大段未翻译的英文技术名词（保留专业术语如 API、SDK 除外）。

Claude Code 启动时会自动读取项目根目录下的这个文件，并将其作为当前项目的专属指令。

方法三：会话内临时指令（快速，但不持久）

如果你不想修改任何文件，只是临时想让当前对话变成中文，可以在启动 claude 后，直接在对话框中输入第一条指令：

从现在开始，请始终使用简体中文回答我的所有问题。不要使用英文单词，除非是代码语法本身。

注意： 这种方法只在当前会话中有效，关闭终端后重新打开，你需要再次输入。

💡 进阶技巧：直接修改 settings.json

如果你习惯直接编辑 JSON 配置文件，也可以修改之前创建的 settings.json 文件，在其中添加自定义指令。

打开 ~/.claude/settings.json，在 JSON 对象中添加 "custom_instructions" 字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro"
  },
  "model": "deepseek-v4-pro",
  "custom_instructions": "Always respond in Simplified Chinese. You must not output English explanations."
}

设置完成后，重启终端即可生效。

安装claude code并调用deepseek v4教程

🛠️ 第一步：安装 Claude Code

🔑 第二步：获取 DeepSeek API Key

⚙️ 第三步：配置 Claude Code 使用 DeepSeek

🚀 第四步：启动并使用

⚠️ 重要提示

🚀 启动并进入交互模式

💻 核心交互技巧

1. 自然语言描述需求

2. 精准引用文件 (`@` 命令)

3. 执行终端命令 (`!` 命令)

4. 调试与修复 Bug

🧠 高阶使用模式

Plan Mode (规划模式)

📝 常用斜杠命令 (`/` 命令)

💡 最佳实践：初始化项目

方法一：修改全局配置（推荐，一劳永逸）

方法二：项目级配置（适合团队协作）

方法三：会话内临时指令（快速，但不持久）

💡 进阶技巧：直接修改 settings.json

评论 (0)

发表评论

安装claude code并调用deepseek v4教程

🛠️ 第一步：安装 Claude Code

🔑 第二步：获取 DeepSeek API Key

⚙️ 第三步：配置 Claude Code 使用 DeepSeek

🚀 第四步：启动并使用

⚠️ 重要提示

🚀 启动并进入交互模式

💻 核心交互技巧

1. 自然语言描述需求

2. 精准引用文件 (@ 命令)

3. 执行终端命令 (! 命令)

4. 调试与修复 Bug

🧠 高阶使用模式

Plan Mode (规划模式)

📝 常用斜杠命令 (/ 命令)

💡 最佳实践：初始化项目

方法一：修改全局配置（推荐，一劳永逸）

方法二：项目级配置（适合团队协作）

方法三：会话内临时指令（快速，但不持久）

💡 进阶技巧：直接修改 settings.json

评论 (0)

发表评论

2. 精准引用文件 (`@` 命令)

3. 执行终端命令 (`!` 命令)

📝 常用斜杠命令 (`/` 命令)