Claude code + DeepSeek 配置笔记

本文档整理自 Claude.docx，涵盖 Claude Code 的安装配置、API 集成、工具管理、Skill 导入及 MCP 协议扩展。所有截图均来自原文档，知识点做了补充和深化。

一、Claude 的安装

1.1 安装命令

在终端（CMD/PowerShell）中执行以下命令进行全局安装：

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

前置条件： 确保已安装 Node.js（建议 v18 以上），安装完成后可通过 node --version 确认。

npm 安装过程

1.2 验证安装

安装完成后检查版本号，确认是否安装成功：

1	claude --version

版本验证

1.3 启动 Claude

安装成功后，直接输入指令启动交互式终端：

claude

首次启动时会进入引导流程（Onboarding），按提示操作即可。

1.4 绕过地区限制

背景： 若当前所在地区不在 Anthropic 官方支持的服务范围内，启动时会出现如下限制提示，无法正常使用。

地区限制提示

解决方法： 修改本地配置文件，绕过 IP 地区校验。

配置文件路径：

1	C:\Users\{用户名}\.claude.json

操作步骤：

打开上述配置文件
在 JSON 顶层加入以下配置项并保存：
1
"hasCompletedOnboarding": true,
重新启动 Claude

提示： 该配置的作用是跳过首次引导检查。后续使用第三方 API（如 DeepSeek）时还需配置 API 端点，详见下一章。

配置文件修改后

重新启动 Claude 即可看到正常启动画面：

Claude 正常启动

二、配置 DeepSeek API

背景： 启动 Claude 后若出现未登录提示（即没有登录 Claude Code 官方账户），可以通过配置第三方 API Key 来绕过，从而使用 DeepSeek 等兼容后端。

未登录提示

2.1 打开配置文件

再次编辑 C:\Users\{用户名}\.claude.json，在其中配置 API 环境变量。

2.2 配置 API Key

在配置文件中添加 env 字段，填入 DeepSeek 的 API 信息：

"env": {
  "ANTHROPIC_AUTH_TOKEN": "sk-9d*********2",
  "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  "ANTHROPIC_MODEL": "deepseek-v4-flash",
  "CLAUDE CODE ATTRIBUTION HEADER": "0"
},

参数说明

配置项	说明	示例值
`ANTHROPIC_AUTH_TOKEN`	API 认证密钥（替换为你自己的 Key）	`sk-xxxx`
`ANTHROPIC_BASE_URL`	API 请求地址（DeepSeek 兼容 Anthropic 的端点）	`https://api.deepseek.com/anthropic`
`ANTHROPIC_MODEL`	使用的模型标识	`deepseek-v4-flash`
`CLAUDE CODE ATTRIBUTION HEADER`	关闭 Attribution 头部检查	`"0"`

⚠️ 安全提醒： 文中的 Token 仅为示例，切勿将真实 API Key 提交到公开仓库。建议使用环境变量或 .gitignore 保护配置文件。

配置项详解

ANTHROPIC_AUTH_TOKEN — 你的 API 密钥，从 DeepSeek（或其他兼容服务商）的开发者后台获取。
ANTHROPIC_BASE_URL — DeepSeek 提供了与 Anthropic API 兼容的代理端点，使得 Claude Code 可以无缝切换后端。
ANTHROPIC_MODEL — 指定要使用的模型版本，支持的模型包括 deepseek-v4-flash、deepseek-v4 等。
CLAUDE CODE ATTRIBUTION HEADER — 设为 "0" 可关闭 Claude Code 的 attribution 检测，避免因后端不兼容该特性而导致错误。

配置 DeepSeek API

2.3 验证配置

保存配置文件后，重新启动 Claude，输入任意内容即可正常得到回答。

正常使用效果

三、使用 CC Switch 管理 API

3.1 为什么需要 CC Switch

当使用多个不同的 API 后端或需要频繁切换模型时，手动修改 .claude.json 很不方便。CC Switch 提供了一个可视化的 API 管理界面，可以：

在同一界面管理多组 API 配置
一键切换不同的 API 端点
直观查询 Token 使用量和消耗
无需手动编辑配置文件

3.2 官网与下载

官网： https://www.ccswitch.io/zh/
推荐版本： CC-Switch-v3.16.5-Windows.msi

3.3 使用方式

安装后打开 CC Switch，在界面中添加对应的 API 配置（名称、Base URL、Key、模型等），保存后即可在 Claude Code 中正常使用。

CC Switch 界面

💡 小技巧： CC Switch 支持导入/导出配置，方便在多台电脑间同步你的 API 设置。

四、导入 Skill

4.1 什么是 Skill

Skill 是 Claude Code 的"技能插件"，可以为 Claude 赋予特定领域的能力，如八字命理分析、公众号文章生成、代码审查、数据可视化等。安装后通过 / 命令或自然语言触发。

4.2 导入方式

导入 Skill 有三种方式：

方式	说明	适用场景
① 项目导入	在项目目录 `.claude/skills/` 中配置	仅当前项目需要该 Skill
② 全局导入	下载至 `~\.claude\skills` 目录	所有项目均可使用
③ CC Switch 导入	通过 CC Switch 工具内嵌管理	结合 API 统一管理

4.3 全局导入步骤（推荐）

以全局导入为例：

将 Skill 文件下载至以下目录：
1
~\.claude\skills
确认文件已正确放置：
在 Claude 对话中输入 /skills 查看已配置的 Skill 列表：

4.4 使用 Skill

安装成功后，在对话中输入对应的触发话题或 Skill 名称，即可获得相应的专业回复。

使用 Skill 效果

💡 提示： 部分 Skill 还支持 /skill-name 这样的斜杠命令，输入 /? 或 /help 可查看当前可用的所有命令。

五、MCP（Model Context Protocol）

5.1 什么是 MCP

MCP（Model Context Protocol，模型上下文协议） 是 Anthropic 推出的一个开放标准，旨在让 AI 模型能够安全、标准化地连接外部数据源和工具。

简单理解：MCP 做的就是给 AI 制定了一套统一的标准接口。不管是连数据库、查公司文档、还是发 Slack 消息，所有工具都按同一个"规矩"来对接。

对于 Claude Code 而言，MCP 是其扩展能力的核心机制——通过 MCP，Claude Code 可以：

访问文件系统和数据库
调用浏览器进行网页测试
与第三方服务（Slack、GitHub、Jira 等）交互
执行自定义工具和脚本

5.2 安装 MCP 示例：Playwright（浏览器自动化）

以下以 Playwright MCP 为例，演示如何让 Claude Code 获得打开浏览器、访问网页的能力。

安装命令

在终端执行：

1	claude mcp add playwright npx @playwright/mcp@latest

安装 Playwright MCP

使用效果

安装成功后，可以让 Claude Code 打开任意网站进行测试，观察浏览器是否正常启动和渲染：

浏览器测试效果

5.3 MCP 使用场景举例

MCP 服务	用途	安装命令示例
Playwright	浏览器自动化、网页测试	`claude mcp add playwright npx @playwright/mcp@latest`
Filesystem	安全的文件系统访问	内置支持
GitHub	仓库管理、PR/Issue 操作	`claude mcp add github`
数据库	SQL 查询与操作	需根据数据库类型安装对应 MCP
Slack	消息发送与频道管理	`claude mcp add slack`

💡 提示： 运行 claude mcp list 可查看当前已安装的所有 MCP 服务；claude mcp remove <name> 可移除不需要的服务。

5.4 MCP 的工作原理

┌──────────────┐      MCP 协议      ┌──────────────────┐
│  Claude Code │ ◄────────────────► │    MCP Server    │
│   (AI 模型)   │    标准化接口      │  (外部工具/数据)  │
└──────────────┘                    └──────────────────┘

Claude Code 作为 MCP 客户端，发起工具调用请求
MCP Server 作为中介，将请求转发给实际的外部工具或数据源
双方通过统一的 JSON-RPC 协议通信，确保安全性和兼容性

六、常见问题与技巧

6.1 常用命令速查

命令	说明
`claude --version`	查看当前版本
`claude mcp add <name> <command>`	安装 MCP 服务
`claude mcp list`	列出已安装的 MCP 服务
`claude mcp remove <name>`	移除 MCP 服务
`/skills`	查看已安装的 Skill
`/?` 或 `/help`	查看可用命令

6.2 配置文件速查

配置文件位置：C:\Users\{用户名}\.claude.json

常见配置项：

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "CLAUDE CODE ATTRIBUTION HEADER": "0"
  }
}

6.3 注意事项

API Key 安全：勿将真实 Key 上传至公开仓库，建议使用 .gitignore 排除 .claude.json
Node.js 版本：建议使用 v18 以上版本，低版本可能导致安装失败
网络环境：安装 MCP 和 Skill 时需确保网络通畅，必要时可配置代理
Skill 与 MCP 的区别：
- Skill → 赋予 Claude 特定领域的知识能力
- MCP → 赋予 Claude 访问外部工具/数据的能力（如打开浏览器、查数据库）