Claude Code 安装与配置指南:手把手教你接入DeepSeek API(实操一遍过)
个人主页北极的代码欢迎来访作者简介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/quickstartClaude Code是AI公司Anthropic推出的一款革命性的AI编程工具。与传统的代码补全插件不同它被定位为一个终端里的AI编程代理能够自主理解、规划并执行复杂的开发任务。它的核心价值在于将大模型的推理能力与操作终端、文件系统的能力相结合实现从需求到代码落地的全流程自动化。为了帮你快速了解以下是它的几个关键特点核心工作原理Claude Code通过一个叫做代理循环的机制工作理解上下文自动扫描你的整个项目目录理解代码结构、依赖关系和技术栈。采取行动自主执行Shell命令、创建或编辑多个文件、运行测试等。验证结果执行完后如运行测试它会检查结果。如果失败了会自动调整方案重试直到任务完成。简单来说你可以把它当作一个知道如何编程的极客同事你把任务交给它它就在你的电脑上帮你干完了。主要功能与特点多文件协作能力能一次性理解和修改十几个甚至更多的文件来完成重构或修复Bug这是它和只能编辑单个文件的内联助手最大的区别。项目记忆 (CLAUDE.md)你可以在项目根目录放一个CLAUDE.md文件用来写清楚项目规范、常用命令、架构说明。Claude Code每次启动都会读这个文件确保它的操作符合团队规范。三种工作模式你可以通过快捷键ShiftTab切换模式非常灵活Default (默认)最安全修改文件或执行命令前会向你确认。Auto-Accept (自动)自动接受文件修改适合批量操作但重要命令仍需确认。Plan Mode (计划)只读模式AI只分析和制定方案完全不修改任何代码。丰富的集成能力它不仅能跑在终端还深度集成到了VS Code、JetBrains等IDE中甚至支持Slack和CI/CD流水线可以在聊天里直接派它干活。与其他工具的对比为了让你有更直观的感受这里把它和两款主流工具做个简单对比功能特性Claude CodeCursorGitHub Copilot核心定位终端自主AI代理AI驱动的IDE编辑器AI结对编程助手工作方式理解需求 - 自主规划 - 执行 - 验证对话式 编辑器内联建议主要提供代码自动补全和聊天任务能力可跨多文件、长时间自主运行复杂任务擅长对话式辅助和代码生成擅长行内或函数级代码补全环境终端优先同时支持IDE和Web独立的编辑器基于VSCode插件形式集成在现有IDE中简单来说如果你只想写代码时有个补全Copilot很合适如果想通过聊天辅助写代码Cursor很棒但如果你想把一个复杂的编程任务直接丢给AI让它自己搞定比如把项目中所有用户认证逻辑从JWT改成OAuth那么Claude Code是更强大的选择。它在SWE-bench测试中达到了80.9%的自主问题解决率证明了其处理复杂任务的能力。安装环境准备系统支持macOS: 10.14Linux: Ubuntu 18.04, CentOS 7, 以及其他主流发行版Windows: Windows 10/11 (推荐使用 PowerShell 或 Git Bash)前置依赖Claude Code主要通过npm包分发因此Node.js是必需项。检查Node.js是否安装win R 输入 cmd打开终端输入以下命令确保版本在16.0以上推荐18node --version npm --version检查如果不了解Node.js的安装我前面的文章也具体讲过可以具体参考一下。检查 Git 是否安装版本不做要求Claude Code 在执行任务的时候会用到 Git 的一个 bash 命令 Git Bash 是 Git for Windows 提供的一个模拟类 Unix 的命令行工具它为 Claude Code 提供了必要的终端环境支持执行相关命令所以需要安装我们可以通过查看 Git 版本号的命令验证是否安装了 Gitgit --version如图Claude Code的安装Claude Code有两种安装方式。其实比较推荐使用npm进行安装3.1 方式一原生安装在官方文档中提供了Claude Code的安装方式有本地安装、Homebrew安装 和WinGet安装可以安装官方文档的方式来进行安装就直接复制官网上的本地安装方式macOS, Linux, WSL:curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:irm https://claude.ai/install.ps1 | iexWindows CMD:curl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd3.2 方式二npm 安装Claude Code是基于npm的形式安装的Linux/macOS安装# 全局安装 Claude Code sudo npm install -g anthropic-ai/claude-code # 验证安装 claude --versionWindows安装# 以管理员身份打开 Powershell 或命令提示符 # 全局安装 npm install -g anthropic-ai/claude-code # 验证安装 claude --version由于博主自己是windows感觉大多数都是所以这里主要演示的就是windows具体的步骤我们在命令行输入上面的命令注意要以管理员的权限才能安装成功否则报错出现这个就说明安装成功。然后我们可以先启动一下我们发现出现了问题Unable to connect to Anthropic servicesFailed 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然后我们开始接入模型打开DeepSeek官网选择API开放平台注册登录即可需要有一定的余额然后创建APIkey随便起个名字即可然后会让你复制密钥一定要复制不然关闭了就找不到了然后也要保护好不要给别人不然花的就是自己的钱。然后我们打开CC右上角 的加号我们把密钥填进去同时把模型也换了DeepSeek-V4-Pro最新的模型。[1m]代表上下文100万不加Claude默认是128k添加即可然后我们打开Claude然后输入/model可以查看我们配置的模型以上就是如何安装Claude并接入模型以上仅仅是用DeepSeek做一个示范有需要更好的模型的操作都一样。结语之后我会发布具体的使用方法和感受如果对你有帮助请点赞关注收藏你的支持就是我最大的鼓励