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、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+,请先安装:
| 系统 | 命令 |
|---|---|
| macOS | brew install node |
| Windows | 从 nodejs.org 下载安装包 |
| Linux/WSL | 使用包管理器安装(如apt install nodejs) |
验证安装:
node--version# 需 >= 18.0npm--version2. 安装 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 请求并转发到你指定的模型提供商。
下载与安装
- 打开 CC Switch Releases 页面
- 根据你的系统选择对应版本下载(Windows 选 .exe 安装包,macOS 选 .dmg,Linux 选 .AppImage)
- 安装并启动 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。
安装插件
- 打开 VS Code,进入扩展面板(Ctrl+Shift+X)
- 搜索“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
配置 Provider
JetBrains 插件需要额外配置 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:国内网络一般可直接访问,偶尔需切换 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