Claude Code 安装及接入 DeepSeek 教程

Claude Code 安装 - 快速开始 | Claude Code 中文站概述Claude Code是 Anthropic 官方推出的终端 AI 编程助手支持在终端中直接对话式编程、代码审查、重构等操作。但由于国内网络限制以及 Anthropic API 的访问门槛直接使用官方服务并不方便。本教程将介绍如何安装 Claude CodeCLI 工具通过 CC Switch 中转将 Claude Code 底层模型替换为DeepSeek或其他兼容 API在VS Code、JetBrains等编辑器中使用名词说明教程中的Cloudecode即指 Claude Code社区中也常简称为 CC。系统要求操作系统macOS 10.15、Windows 10/11、Linux、WSLNode.js18.0 或更高版本内存建议 4GB 以上Claude Code 本身不重但大模型推理需要足够内存一、安装 Claude Code方式一一键安装推荐macOS / Linux / WSL / Windows PowerShell 均可使用source (curl-fsSL https://claude-zh.cn/scripts/install.sh)脚本功能说明自动检测系统中是否已安装 Node.js安装 Claude Code 全局包写入基础配置引导你选择官方 Anthropic、自定义 Provider / OpenRouter或暂时跳过 API 配置如果网络不稳定可以多试几次或切换网络环境。方式二手动安装1. 安装 Node.js如果系统中尚未安装 Node.js 18请先安装系统命令macOSbrew install nodeWindows从 nodejs.org 下载安装包Linux/WSL使用包管理器安装如apt install nodejs验证安装node--version# 需 18.0npm--version2. 安装 Claude Codenpminstall-ganthropic-ai/claude-code国内网络加速如果 npm 官方源较慢可以临时切换到国内镜像npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-codenpmconfigsetregistry https://registry.npmjs.org# 安装完后切回官方源3. 验证安装在终端运行以下命令确认安装成功claude--version如果显示版本号则安装成功。二、配置 CC Switch 中转接入 DeepSeek由于 Claude Code 默认只能调用 Anthropic 的 API而在国内使用 Anthropic API 存在网络与支付门槛。通过CC Switch这个工具可以将 Claude Code 的底层请求劫持并路由到其他兼容的 API 提供商例如DeepSeek。什么是 CC SwitchCC Switch 是一款跨平台桌面助手专为 Claude Code、Codex、OpenCode、Gemini CLI 等 AI 编程 CLI 工具设计。它本质上是一个本地代理/路由可以拦截 CLI 工具的 API 请求并转发到你指定的模型提供商。下载与安装打开 CC Switch Releases 页面根据你的系统选择对应版本下载Windows 选 .exe 安装包macOS 选 .dmgLinux 选 .AppImage安装并启动 CC Switch启动后界面如下图所示可以看到有多个配置入口添加 DeepSeek 配置在 CC Switch 界面中有两个Claude相关的配置入口Claude桌面版用于 Claude 桌面应用Claude终端版用于 Claude Code CLI这里我们选择终端版Claude Code点击添加配置填入以下信息配置项说明API Key你的 DeepSeek API Key从 platform.deepseek.com 获取模型选择不同角色可以分配不同模型对话模型推荐 deepseek-chatv4编码模型推荐 deepseek-coder上下文长度DeepSeek 支持 1M 上下文128K tokens可以大幅提升处理大文件的能力提示DeepSeek 的 API 价格远低于 Anthropic且国内可以直接访问是替代 Claude API 的理想选择。配置界面参考测试连接点击“测试模型”按钮CC Switch 会发送一条测试请求到 DeepSeek API。如果返回成功说明配置正确。测试通过后启用该配置CC Switch 会开始在本地监听并转发请求。三、在终端中使用配置完成后直接在终端中运行claude命令即可启动 Claude Codeclaude首次启动时会进入交互式对话模式你可以直接提问如帮我写一个 Python 排序函数处理文件Claude Code 可以直接读写项目文件代码审查让它 review 你的代码重构优化让 AI 帮你重构现有代码四、在 VS Code 中使用如果你习惯在编辑器中工作可以安装 VS Code 插件来集成 Claude Code。安装插件打开 VS Code进入扩展面板CtrlShiftX搜索“Claude Code for VS Code”点击安装基本用法安装完成后VS Code 底部会出现 Claude Code 的面板。你可以选中代码后右键 - “Ask Claude” 进行代码解释或修改在 Claude Code 面板中直接对话使用快捷键调出快速对话窗口五、在 JetBrains 系列产品中使用JetBrains 全家桶IntelliJ IDEA、PyCharm、WebStorm、GoLand 等同样支持 Claude Code 插件。安装插件打开Settings / Preferences-Plugins搜索“Claude Code for JetBrains”点击Install配置 ProviderJetBrains 插件需要额外配置 SDK 以连接到本地运行的 Claude Code打开Settings - Claude Code点击Install SDK安装 Claude Code SDK等待安装完成在 Provider 设置中选择“Local”作为供应商即本地运行的 CC Switch 中转服务基本用法配置完成后你可以在 JetBrains 编辑器内直接使用 Claude Code代码内联对话选中代码后右键选择 “Ask Claude”工具窗口通过侧边工具窗口打开 Claude Code 面板代码审查与重构让 AI 分析当前文件或项目结构常见问题与排错1. CC Switch 连接失败检查 CC Switch 是否正在运行确认系统托盘中 CC Switch 图标正常检查端口冲突CC Switch 默认监听 8080 端口确保没有被其他程序占用防火墙拦截检查防火墙是否拦截了本地端口2. DeepSeek API 调用失败API Key 是否正确重新复制粘贴注意不要有多余空格账户余额是否充足登录 DeepSeek 平台检查 API 额度网络是否能访问 DeepSeek API国内网络一般可直接访问偶尔需切换 DNS3. Claude Code 启动报错Node.js 版本过低确保 18.0运行node --version确认npm 全局包冲突尝试重新安装npm install -g anthropic-ai/claude-code环境变量问题某些系统需要配置 PATH 包含 npm 全局包路径4. VS Code / JetBrains 插件不显示重启编辑器安装插件后建议重启检查 Claude Code 是否已安装插件依赖本地claude命令检查版本兼容性确保插件版本与 Claude Code 版本匹配结语通过本教程你已经完成了Claude Code CLI 的安装与环境配置CC Switch 中转工具的安装与 DeepSeek 模型配置终端中使用 Claude Code 进行 AI 编程VS Code 插件集成JetBrains 系列编辑器集成这套配置方案的核心优势在于低成本DeepSeek API 价格远低于 Anthropic适合日常高频使用低延迟国内可直接访问 DeepSeek无需代理灵活性高CC Switch 支持切换多种模型提供商不止 DeepSeek现在打开终端输入claude开始你的 AI 编程之旅吧 本文发布于 栏轩阁 欢迎关注我的其他平台博客园掘金CSDNGitHubGitee 联系我2194844980qq.com