Claude Code 安装与 DeepSeek Pro v4 模型配置完整指南

引言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，原生对接 Claude 系列模型。但很多国内开发者希望使用 DeepSeek 等国产模型来降低成本或满足合规需求。本文将手把手带你完成 Claude Code 的安装，以及如何将其配置为使用 DeepSeek Pro v4 模型。

一、Claude Code 是什么

Claude Code 是一个运行在终端中的 AI 编程代理，它能够：

直接读取和编辑你的代码文件
执行 shell 命令（安装依赖、运行测试等）
通过 Git 管理版本和提交代码
利用 MCP 协议扩展能力（连接外部工具和 API）
理解整个项目的上下文，而不仅仅是单个文件

与 IDE 插件不同，Claude Code 是一个独立的 CLI 工具，可以在任何终端环境中使用——VS Code、JetBrains、Warp、甚至纯 SSH 终端。

二、安装 Claude Code

2.1 前提条件

依赖	版本要求	说明
Node.js	≥ 18.0	Claude Code 基于 Node.js 运行
Git	≥ 2.23（推荐）	用于版本控制和代码操作
操作系统	Windows / macOS / Linux	全平台支持

2.2 安装 Node.js

如果你还没有 Node.js，推荐使用 nvm（Node Version Manager）来管理版本：

Windows 用户（推荐 nvm-windows）：

从 nvm-windows releases 下载安装包，安装完成后：

nvm install 20       # 安装 Node.js 20 LTS
nvm use 20           # 切换到 20 版本
node -v              # 确认版本 ≥ 18

macOS / Linux 用户：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

2.3 安装 Claude Code

通过 npm 全局安装：

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

安装完成后验证：

claude --version

首次运行 claude 命令时，会进入交互式界面，提示你进行初始配置。

2.4 配置方式概览

Claude Code 支持多种配置方式，优先级从高到低：

命令行参数 > 环境变量 > 配置文件 > 默认值

配置文件采用 JSON 格式，存放在用户目录下的 .claude/settings.json。

三、配置 DeepSeek Pro v4 模型

DeepSeek Pro v4 兼容 OpenAI 的 API 格式，而 Claude Code 支持通过第三方 API 路由来使用非 Anthropic 模型。

3.1 获取 DeepSeek API Key

访问 DeepSeek 开放平台
注册并登录账号
进入「API Keys」页面，点击「创建 API Key」
复制并妥善保存生成的 Key

3.2 配置方法一：环境变量（推荐）

在你的 shell 配置文件中添加（~/.bashrc、~/.zshrc 或 PowerShell Profile）：

# Claude Code 使用 DeepSeek 模型
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_API_KEY=你的DeepSeek-API-Key
export CLAUDE_CODE_DEFAULT_MODEL=deepseek-chat

Windows PowerShell 配置（在 $PROFILE 中添加）：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_API_KEY = "你的DeepSeek-API-Key"
$env:CLAUDE_CODE_DEFAULT_MODEL = "deepseek-chat"

配置完成后重新打开终端生效，或执行 source ~/.bashrc。

3.3 配置方法二：settings.json 文件

在 ~/.claude/settings.json 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_API_KEY": "你的DeepSeek-API-Key",
    "CLAUDE_CODE_DEFAULT_MODEL": "deepseek-chat"
  }
}

3.4 验证配置

运行以下命令检查模型是否配置成功：

claude --model deepseek-chat

进入交互界面后，输入一条简单的提示词测试：

> 请用中文回复：1 + 1 等于几？

如果收到正常回复，说明配置成功。

3.5 DeepSeek 模型参数说明

参数	值	说明
`ANTHROPIC_BASE_URL`	`https://api.deepseek.com/anthropic`	DeepSeek 的 Anthropic 兼容端点
`ANTHROPIC_API_KEY`	你的 API Key	认证凭证
`CLAUDE_CODE_DEFAULT_MODEL`	`deepseek-chat`	默认使用的模型名称

四、进阶配置

4.1 创建 CLAUDE.md 项目规则

在每个项目根目录创建 CLAUDE.md 文件，可以定制 Claude Code 的行为：

# CLAUDE.md

## 项目说明
- 这是一个 Spring Boot 项目，使用 Maven 管理依赖
- Java 版本为 17
- Maven 本地仓库路径：D:\repository

## 代码规范
- 使用 Lombok 简化 POJO
- 遵循阿里巴巴 Java 开发手册
- Controller 层只做参数校验和路由，不写业务逻辑

Claude Code 会在每次会话开始时自动读取这个文件，理解你的项目上下文。

4.2 MCP 工具扩展

Claude Code 的强大之处在于可以通过 MCP 协议集成外部工具。在 .mcp.json 中配置：

{
  "mcpServers": {
    "my-tool": {
      "command": "python",
      "args": ["/path/to/my_mcp_server.py"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

4.3 常用命令速查

命令	作用
`claude`	进入交互模式
`claude "帮我解释这个项目"`	单次对话
`claude --model deepseek-chat`	指定模型
`claude config`	打开配置面板
`/clear`	清空对话历史
`/compact`	压缩上下文（避免 token 超限）
`/cost`	查看当前会话费用
`/help`	查看帮助

五、常见问题与排错

Q1: 模型无响应或报超时错误

原因：DeepSeek API 的响应速度可能比 Anthropic 官方的要慢。

解决：

检查网络连接，确保可以访问 api.deepseek.com
适当增加超时配置：在 settings.json 中设置 "requestTimeout": 120000（单位毫秒）

Q2: 提示模型不支持某些功能

原因：DeepSeek Pro v4 并非完全兼容 Claude API 的所有特性，例如 Computer Use、Extended Thinking 等高级功能可能不可用。

解决：在 settings.json 中禁用不兼容的功能：

{
  "enableExtendedThinking": false,
  "enableComputerUse": false
}

Q3: 中文编码显示异常

原因：Windows 终端的默认编码可能不是 UTF-8。

解决：

# 在 PowerShell 中执行
chcp 65001

或永久设置：在 PowerShell Profile 中添加 $OutputEncoding = [Console]::OutputEncoding = [Text.UTF8Encoding]::UTF8

Q4: API Key 安全提醒

绝不要将 API Key 硬编码在项目中
绝不要将 .env 文件提交到 Git 仓库
使用环境变量或 Claude Code 的 settings.json 管理敏感信息

六、不同使用场景建议

场景	推荐模型配置	理由
正式开发、复杂项目	`claude-sonnet-4-6`	代码质量最高，理解能力强
预算有限、学习用途	`deepseek-chat`	成本低，日常编码够用
快速小任务	`deepseek-chat` / `claude-haiku-4-5`	响应快、成本低
需要最强推理	`claude-opus-4-7`	复杂架构设计和难题解决

七、总结

Claude Code + DeepSeek Pro v4 的组合，让国内开发者能以较低的成本享受到 AI 编程助手的便利。关键步骤回顾：

安装：npm install -g @anthropic-ai/claude-code
配置：设置 ANTHROPIC_BASE_URL 指向 DeepSeek 的兼容端点
验证：运行 claude 进入交互界面测试
进阶：通过 CLAUDE.md 定制项目规则，通过 MCP 扩展工具能力

AI 编程工具正在快速迭代，保持关注官方更新，及时升级以获取新功能和稳定性改进。无论是使用 DeepSeek 还是 Claude 原生模型，重要的是找到适合自己工作流的那一款。

本文由 Claude Code + cnblogs MCP Server 协作发布。

posted @ 2026-06-01 16:09 松鼠航阅读(162) 评论(0) 收藏举报

刷新页面返回顶部

松鼠航

Claude Code 安装与 DeepSeek Pro v4 模型配置完整指南

Claude Code 安装与 DeepSeek Pro v4 模型配置完整指南

引言

一、Claude Code 是什么

二、安装 Claude Code

2.1 前提条件

2.2 安装 Node.js

2.3 安装 Claude Code

2.4 配置方式概览

三、配置 DeepSeek Pro v4 模型

3.1 获取 DeepSeek API Key

3.2 配置方法一：环境变量（推荐）

3.3 配置方法二：settings.json 文件

3.4 验证配置

3.5 DeepSeek 模型参数说明

四、进阶配置

4.1 创建 CLAUDE.md 项目规则

4.2 MCP 工具扩展

4.3 常用命令速查

五、常见问题与排错

Q1: 模型无响应或报超时错误

Q2: 提示模型不支持某些功能

Q3: 中文编码显示异常

Q4: API Key 安全提醒

六、不同使用场景建议

七、总结

公告