概述

Claude Code 是 Anthropic 公司推出的终端 AI 编程助手，运行在命令行环境中。与代码补全类工具不同，Claude Code 能够理解项目整体架构，支持读取文件、编写代码、执行命令、管理 Git 仓库等操作，可作为交互式开发辅助工具使用。

Claude Code 默认使用 Anthropic 官方的 Claude 系列模型（Sonnet、Opus 等）。通过社区开发的 cc-switch 工具，可以切换到其他兼容的模型后端，例如 DeepSeek 系列。

环境准备

安装 Claude Code 前需要确认以下环境已就绪：

组件 版本要求 验证方式
Node.js v18 或更高版本 执行 node -v
npm 随 Node.js 附带 执行 npm -v
Git 任意版本 执行 git --version

Node.js 可从 nodejs.org 下载 LTS 版本安装包完成安装。

安装 Claude Code

使用 npm 全局安装：

1
npm install -g @anthropic-ai/claude-code

参数 -g 表示全局安装，安装完成后可在任意目录下调用 claude 命令。

验证安装是否成功：

1
claude --version

正常输出版本号即表示安装完成。

首次启动

在项目目录中执行：

1
2
cd 你的项目目录
claude

首次启动的流程如下：

  1. 协议确认 — 阅读并同意用户条款
  2. 权限设置 — 选择权限模式（推荐 auto，后续可修改）
  3. 项目扫描 — Claude Code 读取项目结构以建立上下文
  4. 配置生成 — 在项目根目录创建 .claude/ 配置文件

启动完成后会显示 > 提示符，在此输入指令即可与 Claude Code 交互。

基础命令

命令 功能 使用场景
/help 查看帮助文档 查询可用命令列表
/clear 清除对话历史 重置对话上下文
/cost 查看 API 消耗 监控当前会话用量
/config 打开设置面板 调整主题、权限等配置
!<command> 执行 shell 命令 如 !node -v 查看版本
/plan 生成实现计划 复杂功能开发前规划方案

安全提示：Claude Code 不会主动获取系统敏感信息。执行 shell 命令前会请求用户授权，这是内置的安全机制。

使用 cc-switch 切换模型

Claude Code 默认连接 Anthropic 官方模型。若需切换至其他模型，可使用 cc-switch 工具。

切换模型的考量

DeepSeek 系列模型的 API 定价通常低于 Claude 官方模型，对于日常开发场景具有更好的成本效益。cc-switch 支持在不同模型之间灵活切换，无需重复配置。

安装 cc-switch

方式一：下载 MSI 安装包（Windows 推荐）

  1. 访问 cc-switch GitHub Releases 页面
  2. 选择最新的 Release 版本
  3. 在 Assets 区域找到并下载 cc-switch-x.x.x.msi 文件
  4. 双击运行安装程序，按提示完成安装
  5. 重启终端使配置生效

安装完成后在终端执行 cc-switch 确认工具可用。

方式二：npm 安装（macOS / Linux）

1
npm install -g cc-switch

获取 DeepSeek API Key

使用 DeepSeek 模型需要申请 API Key：

  1. 打开 DeepSeek 开发者平台
  2. 注册账号（支持邮箱、微信、GitHub 登录）
  3. 登录后进入左侧 API Keys 页面
  4. 点击 创建 API Key，输入名称（如 “claude-code”）
  5. 复制生成的 Key（以 sk- 开头的字符串）

注意：API Key 仅在此页面显示一次，关闭后无法再次查看，请立即妥善保存。

配置 API Key

Windows PowerShell：

1
$env:DEEPSEEK_API_KEY = "sk-你的API Key"

如需持久化配置，添加系统环境变量：Win+R → sysdm.cpl → 高级 → 环境变量 → 新建，变量名填写 DEEPSEEK_API_KEY，值填写你的 API Key。

macOS / Linux：

1
export DEEPSEEK_API_KEY="sk-你的API Key"

如需持久化，将上述命令写入 ~/.bashrc 或 ~/.zshrc。

切换模型

查看可用模型列表：

1
cc-switch list

切换到 DeepSeek V4 Flash（响应速度较快，适用于日常开发）：

1
cc-switch set deepseek-v4-flash

切换到 DeepSeek Pro（推理能力更强，适用于复杂任务）：

1
cc-switch set deepseek-pro

验证切换

启动 Claude Code：

1
claude

输入一条简单指令，观察响应是否正常。可通过 /cost 命令查看当前 API 消耗情况。

恢复官方模型

1
cc-switch reset

cc-switch 命令速查

命令 说明
cc-switch list 列出可用模型
cc-switch set deepseek-v4-flash 切换到 DeepSeek Flash
cc-switch set deepseek-pro 切换到 DeepSeek Pro
cc-switch reset 恢复 Claude 官方模型
cc-switch current 查看当前模型

使用建议

1. 提供充分的上下文

向 Claude Code 描述需求时，包含足够的背景信息能显著提升输出质量。例如在项目配置类问题中，说明使用的框架、版本和具体需求。

1
2
3
4
5
推荐的方式：
"使用 Hexo + Butterfly 主题搭建博客，如何为文章添加目录导航功能？"

不推荐的方式：
"加目录"

2. 分步骤处理复杂任务

将大型需求拆解为多个小步骤，每步确认结果后再进行下一步，有助于及时发现偏差。

3. 使用 ! 执行 shell 命令

在对话中可直接执行终端命令：

1
2
!node -v
!npm run server

4. 适时重置上下文

当对话上下文偏离预期时，使用 /clear 清除历史记录重新开始，可保持回答的准确性。

5. 查阅帮助文档

输入 /help 可随时查看完整的命令列表和使用说明。

常见问题

Q：cc-switch 切换后无法使用如何排查？

常见原因及解决方法：

  1. 检查 API Key 是否完整复制
  2. 确认系统环境变量已正确设置（Windows 需重启终端）
  3. 在 DeepSeek 开发者平台确认 API Key 状态正常

Q：安装时出现权限错误如何处理？

Windows 用户请以管理员身份运行终端后重试。macOS / Linux 用户可在命令前添加 sudo：

1
sudo npm install -g @anthropic-ai/claude-code

Q：cc-switch 的配置是全局生效还是项目级生效？

cc-switch 的配置为全局生效，切换后影响所有使用 Claude Code 的项目。

Q：如何卸载？

1
2
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g cc-switch

通过 MSI 安装的 cc-switch，可在 Windows 设置 → 应用管理中找到并卸载。

总结

Claude Code 是一款功能完整的终端 AI 编程辅助工具，安装配置流程较为简洁。通过 cc-switch 可在不同模型之间灵活切换，以适应不同的开发场景和成本需求。使用过程中，提供清晰的上下文并合理拆解任务，可以获得更好的辅助效果。