当前位置：首页 > news >正文

Claude Code 安装与配置指南：手把手教你接入DeepSeek API（实操一遍过）

news 2026/5/25 11:06:43

🔥个人主页：北极的代码（欢迎来访）
🎬作者简介：java后端学习者
❄️个人专栏：苍穹外卖日记，SSM框架深入，JavaWeb
✨命运的结局尽可永在，不屈的挑战却不可须臾或缺！

前言：

基于学完了点评，也就算是后端入门了，下面要学习的侧重点在后端agent的相关知识，Python基础语法和Python后端的一些知识，还有一些框架，然后我们自己在日常学习中，也要学会去调用AI，了解一些原理和实际操作。可以提高我们的效率，这一章节主要就是从一个初学者的角度来安装使用Claude code，以及如何接入大模型并使用。

摘要：

本文详细介绍了AI编程工具ClaudeCode的安装与配置过程。作为Anthropic推出的革命性工具，ClaudeCode具备多文件协作、项目记忆和三种工作模式等核心功能。安装需准备Node.js和Git环境，提供npm和原生两种安装方式。针对国内使用问题，给出了修改配置文件的解决方案。重点演示了如何通过ccswitch工具接入DeepSeek-V4-Pro模型，包括API密钥获取和模型切换步骤。文章为初学者提供了从安装到接入大模型的完整指导，帮助开发者利用AI提升编程效率。

首先：我们要知道什么是Claude code

产品官网：

https://claude.com/product/claude-code

中文文档：

https://code.claude.com/docs/zh-CN/quickstart

Claude Code是AI公司Anthropic推出的一款革命性的AI编程工具。与传统的代码补全插件不同，它被定位为一个终端里的AI编程代理，能够自主理解、规划并执行复杂的开发任务。
它的核心价值在于将大模型的推理能力与操作终端、文件系统的能力相结合，实现从需求到代码落地的全流程自动化。
为了帮你快速了解，以下是它的几个关键特点：
核心工作原理
Claude Code通过一个叫做"代理循环"的机制工作：
理解上下文：自动扫描你的整个项目目录，理解代码结构、依赖关系和技术栈。
采取行动：自主执行Shell命令、创建或编辑多个文件、运行测试等。
验证结果：执行完后（如运行测试），它会检查结果。如果失败了，会自动调整方案重试，直到任务完成。
简单来说，你可以把它当作一个知道如何编程的极客同事，你把任务交给它，它就在你的电脑上帮你干完了。
主要功能与特点
多文件协作能力：能一次性理解和修改十几个甚至更多的文件来完成重构或修复Bug，这是它和只能编辑单个文件的内联助手最大的区别。
项目记忆 (CLAUDE.md)：你可以在项目根目录放一个CLAUDE.md文件，用来写清楚项目规范、常用命令、架构说明。Claude Code每次启动都会读这个文件，确保它的操作符合团队规范。
三种工作模式：你可以通过快捷键Shift+Tab切换模式，非常灵活：
Default (默认)：最安全，修改文件或执行命令前会向你确认。
Auto-Accept (自动)：自动接受文件修改，适合批量操作，但重要命令仍需确认。
Plan Mode (计划)：只读模式，AI只分析和制定方案，完全不修改任何代码。
丰富的集成能力：它不仅能跑在终端，还深度集成到了VS Code、JetBrains等IDE中，甚至支持Slack和CI/CD流水线，可以在聊天里直接派它干活。
与其他工具的对比
为了让你有更直观的感受，这里把它和两款主流工具做个简单对比：
功能特性 Claude Code Cursor GitHub Copilot
核心定位 终端自主AI代理 AI驱动的IDE编辑器 AI结对编程助手
工作方式 理解需求 -> 自主规划 -> 执行 -> 验证对话式 + 编辑器内联建议主要提供代码自动补全和聊天
任务能力 可跨多文件、长时间自主运行复杂任务擅长对话式辅助和代码生成擅长行内或函数级代码补全
环境终端优先，同时支持IDE和Web 独立的编辑器（基于VSCode）插件形式，集成在现有IDE中
简单来说：
如果你只想写代码时有个补全，Copilot很合适；
如果想通过聊天辅助写代码，Cursor很棒；
但如果你想把一个复杂的编程任务直接丢给AI让它自己搞定（比如"把项目中所有用户认证逻辑从JWT改成OAuth"），那么Claude Code是更强大的选择。它在SWE-bench测试中达到了80.9%的自主问题解决率，证明了其处理复杂任务的能力。

功能特性	Claude Code	Cursor	GitHub Copilot
核心定位	终端自主AI代理	AI驱动的IDE编辑器	AI结对编程助手
工作方式	理解需求 -> 自主规划 -> 执行 -> 验证	对话式 + 编辑器内联建议	主要提供代码自动补全和聊天
任务能力	可跨多文件、长时间自主运行复杂任务	擅长对话式辅助和代码生成	擅长行内或函数级代码补全
环境	终端优先，同时支持IDE和Web	独立的编辑器（基于VSCode）	插件形式，集成在现有IDE中

安装环境准备：

系统支持
macOS: 10.14+
Linux: Ubuntu 18.04+, CentOS 7+, 以及其他主流发行版
Windows: Windows 10/11 (推荐使用 PowerShell 或 Git Bash)

前置依赖

Claude Code主要通过npm包分发，因此Node.js是必需项。
检查Node.js是否安装：win + R 输入 cmd打开终端输入以下命令，确保版本在16.0以上（推荐18+）
node --version npm --version
检查：
如果不了解Node.js的安装，我前面的文章也具体讲过，可以具体参考一下。
检查 Git 是否安装：版本不做要求
Claude Code 在执行任务的时候会用到 Git 的一个 bash 命令，Git Bash 是 Git for Windows 提供的一个模拟类 Unix 的命令行工具，它为 Claude Code 提供了必要的终端环境，支持执行相关命令，所以需要安装
我们可以通过查看 Git 版本号的命令验证是否安装了 Git
git --version
如图：

Claude Code的安装：

Claude Code有两种安装方式。其实比较推荐使用npm进行安装

3.1 方式一：原生安装

在官方文档中提供了Claude Code的安装方式
有本地安装、Homebrew安装和WinGet安装，可以安装官方文档的方式来进行安装
就直接复制官网上的本地安装方式
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

3.2 方式二：npm 安装

Claude Code是基于npm的形式安装的：
Linux/macOS安装：
# 全局安装 Claude Code sudo npm install -g @anthropic-ai/claude-code # 验证安装 claude --version
Windows安装：
# 以管理员身份打开 Powershell 或命令提示符 # 全局安装 npm install -g @anthropic-ai/claude-code # 验证安装 claude --version
由于博主自己是windows，感觉大多数都是，所以这里主要演示的就是windows具体的步骤：
我们在命令行输入上面的命令（注意要以管理员的权限才能安装成功，否则报错）
出现这个就说明安装成功。
然后我们可以先启动一下：
我们发现出现了问题
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
运行之后我们会发现报了以上的错误，这是因为 Claude Code 工具会校验位置信息，国内是无法使用的，我们有两种方式可以解决这个问题： ①配置代理网络 ②修改配置绕过校验
第一种方式就不多说了，用魔法即可。
我们主要还是用第二种方式，修改配置文件跳过登录检验
打开文件夹，在搜索栏输入自己的用户名
我们可以看到这个配置文件
然后用记事本打开，添加一行：
"hasCompletedOnboarding": true
要注意：我们要在前面加一个逗号，否则会出现问题，同时标点符号都要用英文
具体如图
然后保存即可
做完以上配置我们再次启动Claude Code
就能发现Claude Code是启动成功的，它会问你是否需要去读取这个目录文件
如果我们选择Yes，它会出现一个报错
提示：not login
正常你启动的话，它会用到Claude Code自带的一个模型Sonnet 4.6模型，但这个模型是要收费的，一个月最低也要17$

接入模型：

这里我们可以使用API的方式，就不需要去登录Claude Code的账户我们这里用DeepSeek用来演示

安装cc switch

这里我们要用到cc switch,我们要去GitHub上下载安装即可。
cc switch并不是 Claude Code 自带的官方命令，而是一个社区开发的、用于管理 Claude Code 多套配置的第三方工具。
简单来说，如果你平时需要在不同 API 密钥、不同模型供应商（比如 Anthropic、DeepSeek、SiliconFlow）或不同项目配置之间反复切换，手动改配置文件非常麻烦。cc switch这类工具就是为了解决这个痛点而生的。
找到这个发行：
我们在里面选择安装包下载即可：
具体链接：
https://github.com/farion1231/cc-switch/releases/download/v3.15.0/CC-Switch-v3.15.0-Windows.msi