Claude Code 是由 Anthropic 开发的一款代理型命令行编码助手（Agentic CLI）。它能够直接读取本地代码库、执行终端命令、修改文件、运行测试并管理 Git 提交，是开发者的强大助手。

---

一、 环境准备

在安装 Claude Code 之前，请确保你的系统满足以下基础条件：

1. Node.js: 需安装 v18 或更高版本。

   • 检查命令：node -v

2. Git: 强烈建议安装，用于代码版本控制和变更管理。

   • 检查命令：git --version

3. Anthropic 账户: （对国内很不友好）

   • 方案 A (推荐): 订阅 Claude Pro (固定月费，包含使用额度)。
   • 方案 B: 使用 Anthropic API Key (按量计费，适合轻量或企业用户)。

4. 国内大模型：

   • 方案 A : 使用deepseek的api。
   • 方案 B：购买各大厂商的cooding plan。例如glm，minimax，kimi，火山引擎，阿里等。

---

二、 安装步骤

请根据你的操作系统，在终端中执行对应的安装命令：

1. macOS / Linux / WSL

使用官方一键安装脚本：

curl -fsSL https://claude.ai/install.sh | bash

或者通过 Homebrew 安装（仅限 Mac）：

brew install --cask claude-code

2. Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

---

三、 快速上手

1. 首次登录与初始化

在你的项目根目录下打开终端，输入以下命令启动：

claude

• 身份验证: 程序会提供一个 URL 链接。在浏览器中打开它，登录你的 Anthropic 账号并完成授权。
• 界面配置: 根据提示选择你喜欢的 UI 主题（深色/浅色）。

2. 核心操作示例

进入交互界面后，你可以直接使用自然语言下达指令：

• 项目理解: "解释一下这个项目的架构。"
• 代码修改: "将所有 API 的超时时间改为 10 秒。"
• 故障排除: "运行 npm test，并修复所有报错的测试用例。"
• 功能开发: "在主页添加一个暗黑模式切换按钮。"

3. 确认变更

Claude Code 在修改文件前总是会请求你的许可。它会展示代码差异（Diff），你可以输入 y 确认应用，或要求它重新修改。

---

四、使用cc switch

安装cc switch

1. 下载地址：https://github.com/farion1231/cc-switch/releases/tag/v3.13.0

2. 滑动到底部，选择对应系统的安装包下载安装即可。blog.csdnimg.cn/direct/25da05dd844e42e4984c3d48a3a7c93c.png)
   

3. 安装完成之后，打开主界面。打开右上角的" + " 。

4. 平台上购买coding plan后，复制其文档提高的配置信息粘贴到这里。

5. 选择刚刚添加的模型，点击启动及其。这时候重新在命令行输入claude即可生效。
   

五、 进阶功能与常用命令

在 Claude Code 界面中，输入 / 即可查看所有内置命令：

命令	说明
/init	在项目根目录生成 Claude.md (项目规则文件)
/model	切换 AI 模型（如从 Sonnet 切换到 Opus）
/plan	计划模式: 先制定详细开发方案，审核后再写代码
/compact	压缩对话历史，节省 Token 使用量
/clear	清空当前会话历史
/terminal-setup	配置终端高级功能（如换行符支持）

项目大脑：Claude.md

运行 /init 后生成的 Claude.md 非常关键。你可以在其中记录：

• 项目的特定代码规范。
• 架构设计原则。
• 常用技术栈的偏好。
  Claude 每次启动都会读取此文件，从而更精准地符合你的开发习惯。

---

六、 注意事项与技巧

1. 安全第一: Claude Code 只会将它认为必要的代码片段发送到服务器。它绝不会在未经你确认的情况下删除重要文件或执行高危操作。
2. MCP 扩展: 支持 Model Context Protocol。你可以通过安装 MCP 服务器，让 Claude 具备访问数据库、搜索网页或操作浏览器的能力。
3. VS Code 集成: 你可以直接在 VS Code 的集成终端中运行 claude，实现边看代码边交流的无缝体验。