主题
01-03 · Claude Code CLI
Claude Code 是 Anthropic 官方推出的、在终端里运行的 AI 编码助手。它能在你电脑上 读文件、写代码、执行命令、跑测试、提交 git。和 Windsurf 配合使用：Windsurf 管"在 IDE 里编辑"，Claude Code 管"在终端里跑长任务"。
公司没有强制要求每个人都用，但我们 强烈建议 至少装上、跑通一次，因为之后大量第三方教程、Skill、MCP 文档默认你会用 Claude Code。
一、Claude Code 解决什么问题
| 场景 | Windsurf | Claude Code CLI |
|---|---|---|
| IDE 里写代码 | ✅ | ❌（无 GUI） |
| 长时间后台任务（10 分钟以上） | 一般 | ✅ |
| 在远程服务器 / Docker 容器里跑 Agent | ❌ | ✅ |
| 写 git commit / 自动 PR | 一般 | ✅ |
| 接 MCP / 自定义 Skill | ✅ | ✅（生态最丰富） |
二、安装
2.1 前置依赖
| 依赖 | 推荐版本 |
|---|---|
| Node.js | 18.x 或更高（建议 20.x LTS） |
| npm | Node 自带 |
如果本机没装：
bash
# macOS
brew install node@20
# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Windows：到 nodejs.org 下载安装包2.2 全局安装 Claude Code
bash
npm install -g @anthropic-ai/claude-code验证：
bash
claude --version三、登录
bash
claude login它会启动一个浏览器登录流程：
- 选择 使用 Claude Pro / Max 订阅（推荐，按月付费，无 Token 焦虑）
- 或者 使用 API Key（按用量计费）
公司方案：默认用个人 Pro 订阅。如有特殊任务（高并发批处理）需要 API Key，找团队 Lead 申请。
四、最小可用流程（5 分钟跑通）
bash
mkdir hello-claude && cd hello-claude
claude
# 进入交互界面后，输入：
# > /init
# 它会扫描整个项目并生成 CLAUDE.md（项目记忆文件）
# > 帮我写一个 fastapi 的 hello world，跑在 8000 端口
# 它会：
# 1. 列出计划
# 2. 创建 main.py / requirements.txt
# 3. 询问是否安装依赖（你确认后会自动跑 pip install）
# 4. 询问是否启动服务
# 退出： /exit 或 Ctrl+D五、关键命令速查
在 Claude Code 内部（交互模式）
| 命令 | 用途 |
|---|---|
/init | 扫描项目生成 CLAUDE.md |
/clear | 清空当前对话上下文 |
/compact | 压缩当前上下文（避免超长） |
/cost | 查看本次会话的 Token 成本 |
/model | 切换模型（Sonnet / Opus） |
/mcp | 管理 MCP servers |
/agents | 管理子 Agent |
/help | 完整命令列表 |
在 shell 里（非交互模式）
bash
# 一次性执行（适合脚本 / CI）
claude -p "把当前目录所有 .py 文件加上类型注解"
# 用某个具体模型
claude -p "..." --model claude-sonnet-4-5
# 指定工作目录
claude --cwd /path/to/project六、CLAUDE.md —— 项目级记忆文件
每个项目都应该有一份 CLAUDE.md，它的作用相当于：给 Agent 的项目说明书。
最小模板：
markdown
# Project: {项目名}
## 一句话说明
这个项目做什么、给谁用。
## 技术栈
- 语言：Python 3.11
- 框架：FastAPI
- 数据库：PostgreSQL
## 重要约束
- 所有 API 路径以 /api/v1 开头
- 数据库不允许加新字段时不写 migration
- commit 必须有 conventional message 前缀
## 常用命令
- 启动开发服务器：`make dev`
- 跑测试：`make test`
- 部署：`make deploy`
## 已知坑
- xxx 模块在 Windows 下要先装 yyy心法：把"你不希望每次都教 Agent 一遍"的内容都写进 CLAUDE.md。这是你 跨会话的记忆。
七、常用增强工具
7.1 CC Switch（多账号 / 多 API Key 切换）
如果你同时有多个 API 来源（如 Claude 官方 + 中转 + 自部署），推荐：
- 仓库：https://github.com/farion1231/cc-switch
- 它能管理 Claude Code / Codex CLI / Gemini CLI 的多份配置，一键切换。
7.2 给 Claude Code 接 MCP
bash
# 给 Claude Code 加一个 MCP server（以 Codex 反过来作为 MCP 为例）
claude mcp add codex -s user -- codex -m gpt-5-codex -c model_reasoning_effort="high" mcp八、参考资料
继续 → 04 · Codex CLI