Claude Code 安装及接入 DeepSeek 教程
2026/6/15 6:45:51 网站建设 项目流程

Claude Code 安装 - 快速开始 | Claude Code 中文站

概述

Claude Code是 Anthropic 官方推出的终端 AI 编程助手,支持在终端中直接对话式编程、代码审查、重构等操作。但由于国内网络限制以及 Anthropic API 的访问门槛,直接使用官方服务并不方便。

本教程将介绍如何:

  1. 安装 Claude CodeCLI 工具
  2. 通过 CC Switch 中转,将 Claude Code 底层模型替换为DeepSeek(或其他兼容 API)
  3. VS CodeJetBrains等编辑器中使用

名词说明:教程中的"Cloudecode"即指 Claude Code,社区中也常简称为 CC。


系统要求

  • 操作系统:macOS 10.15+、Windows 10/11、Linux、WSL
  • Node.js:18.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 node
Windows从 nodejs.org 下载安装包
Linux/WSL使用包管理器安装(如apt install nodejs

验证安装:

node--version# 需 >= 18.0npm--version
2. 安装 Claude Code
npminstall-g@anthropic-ai/claude-code

国内网络加速:如果 npm 官方源较慢,可以临时切换到国内镜像:

npmconfigsetregistry https://registry.npmmirror.comnpminstall-g@anthropic-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 Switch?

CC Switch 是一款跨平台桌面助手,专为 Claude Code、Codex、OpenCode、Gemini CLI 等 AI 编程 CLI 工具设计。它本质上是一个本地代理/路由,可以拦截 CLI 工具的 API 请求并转发到你指定的模型提供商。

下载与安装

  1. 打开 CC Switch Releases 页面
  2. 根据你的系统选择对应版本下载(Windows 选 .exe 安装包,macOS 选 .dmg,Linux 选 .AppImage)
  3. 安装并启动 CC Switch

启动后界面如下图所示,可以看到有多个配置入口:

添加 DeepSeek 配置

在 CC Switch 界面中有两个"Claude"相关的配置入口:

  • Claude(桌面版):用于 Claude 桌面应用
  • Claude(终端版):用于 Claude Code CLI

这里我们选择终端版(Claude Code),点击添加配置,填入以下信息:

配置项说明
API Key你的 DeepSeek API Key(从 platform.deepseek.com 获取)
模型选择不同角色可以分配不同模型:对话模型推荐 deepseek-chat(v4),编码模型推荐 deepseek-coder
上下文长度DeepSeek 支持 1M 上下文(128K tokens),可以大幅提升处理大文件的能力

提示:DeepSeek 的 API 价格远低于 Anthropic,且国内可以直接访问,是替代 Claude API 的理想选择。

配置界面参考:

测试连接

点击“测试模型”按钮,CC Switch 会发送一条测试请求到 DeepSeek API。如果返回成功,说明配置正确。

测试通过后,启用该配置,CC Switch 会开始在本地监听并转发请求。


三、在终端中使用

配置完成后,直接在终端中运行claude命令即可启动 Claude Code:

claude

首次启动时会进入交互式对话模式,你可以:

  • 直接提问:如"帮我写一个 Python 排序函数"
  • 处理文件:Claude Code 可以直接读写项目文件
  • 代码审查:让它 review 你的代码
  • 重构优化:让 AI 帮你重构现有代码


四、在 VS Code 中使用

如果你习惯在编辑器中工作,可以安装 VS Code 插件来集成 Claude Code。

安装插件

  1. 打开 VS Code,进入扩展面板(Ctrl+Shift+X)
  2. 搜索“Claude Code for VS Code”
  3. 点击安装

基本用法

安装完成后,VS Code 底部会出现 Claude Code 的面板。你可以:

  • 选中代码后右键 -> “Ask Claude” 进行代码解释或修改
  • 在 Claude Code 面板中直接对话
  • 使用快捷键调出快速对话窗口


五、在 JetBrains 系列产品中使用

JetBrains 全家桶(IntelliJ IDEA、PyCharm、WebStorm、GoLand 等)同样支持 Claude Code 插件。

安装插件

  1. 打开Settings / Preferences->Plugins
  2. 搜索“Claude Code for JetBrains”
  3. 点击Install

配置 Provider

JetBrains 插件需要额外配置 SDK 以连接到本地运行的 Claude Code:

  1. 打开Settings -> Claude Code
  2. 点击Install SDK(安装 Claude Code SDK)
  3. 等待安装完成

  1. 在 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:国内网络一般可直接访问,偶尔需切换 DNS

3. 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 编程之旅吧!


📝 本文发布于 栏轩阁

🌐 欢迎关注我的其他平台:

  • 博客园
  • 掘金
  • CSDN
  • GitHub
  • Gitee

📧 联系我:2194844980@qq.com

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询