Claude Code CLI 使用指南

Claude Code 是 Anthropic 官方的命令行 AI 编程助手，像在终端里有一个懂你整个代码库的高级工程师。

---

一、安装

1.1 安装 Claude Code CLI

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

1.2 验证安装

claude --version

1.3 配置 API（二选一）

方式一：使用 Anthropic 官方 API（推荐，功能最完整）

# 设置 API Key（从 https://console.anthropic.com 获取）
set ANTHROPIC_AUTH_TOKEN=sk-ant-xxx       # Windows CMD
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-xxx"    # Windows PowerShell
export ANTHROPIC_AUTH_TOKEN=sk-ant-xxx    # Linux/Mac

方式二：使用 DeepSeek 兼容接口（便宜，你已经在用）

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"

---

二、基本用法

2.1 启动方式

# 进入项目目录后直接启动（交互模式）
cd /path/to/your-project
claude

# 或者在任意目录指定工作区
claude --workspace /path/to/your-project

启动后进入交互 REPL 界面，可以连续对话。

2.2 单次命令模式（-p）

# 一次性问一个问题，不进入 REPL
claude -p "解释一下这个项目是做什么的"

# 把结果输出到文件
claude -p "列出所有 TypeScript 文件" > files.txt

# 在管道中使用
cat error.log | claude -p "分析这些错误日志，告诉我根因"

2.3 常用参数一览

参数	作用	示例
-p "提示词"	单次问答模式（非交互）	claude -p "总结 git diff"
--workspace <路径>	指定工作区目录	claude --workspace ../other-project
--allowedTools "<工具>"	限制可用工具	claude --allowedTools "Read,Grep"
--model <模型>	指定模型	claude --model claude-sonnet-4-6
--max-turns <N>	限制交互轮数	claude --max-turns 5
--verbose	显示详细日志	claude --verbose
--continue	继续上次对话	claude --continue
--resume <ID>	恢复指定会话	claude --resume abc123
--help	查看完整帮助	claude --help

2.4 交互模式下的操作

进入交互模式后：

  > 输入问题或指令，按 Enter 发送
  > 连续按两次 Enter → 换行
  > /help              → 查看所有命令
  > /clear             → 清空当前会话
  > /compact           → 压缩会话上下文（节省 token）
  > /model             → 切换模型
  > /permissions       → 查看/修改权限
  > /status            → 查看当前状态
  > /logout            → 登出
  > Ctrl+C             → 中断当前操作
  > exit 或 /exit      → 退出

---

三、核心能力

3.1 代码理解与问答

# 理解项目结构
claude -p "这个项目的目录结构是什么样的？每个文件做什么？"

# 理解代码逻辑
claude -p "src/commands/gitCommit/index.ts 的 loadCommitFormat 函数做了什么？三级优先级是什么？"

# 找代码位置
claude -p "DeepSeek API 调用逻辑在哪个文件？给我路径和行号"

3.2 代码修改与生成

# 添加新功能
claude -p "在 gitCommit 命令中新加一个选项：'仅生成不看结果'，跳过弹窗直接使用 AI 生成的提交信息提交"

# 修复 Bug
claude -p "修复 src/logger.ts 中时间戳格式不对的问题，应该是 YYYY-MM-DD HH:mm:ss"

# 重构
claude -p "把 src/commands/ 下三个命令的公共逻辑提取成一个共享函数"

3.3 Git 操作

# 查看变更
claude -p "查看最近的 git 提交记录，总结主要变更"

# 生成 commit message
claude -p "分析 git diff 的变更内容，按照约定式提交格式生成中文 commit message"

# 创建 PR
claude -p "基于当前分支的变更，创建一个 PR 描述"

3.4 代码审查

# 审查 PR diff
git diff main | claude -p "审查这些代码变更，检查是否有安全问题、性能问题或逻辑错误"

# 审查当前修改
claude -p "审查当前 git diff，逐条报告不合规项"

3.5 文档生成

# 生成 API 文档
claude -p "根据 src/deepseek.ts 的代码生成函数接口文档，markdown 格式"

# 生成 README
claude -p "根据 package.json 和 src/ 下的所有代码，更新 README.md"

---

四、配置与定制

4.1 全局配置文件

位置：~/.claude/settings.json

{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "autoCompact": true,
  "permissions": {
    "allow": [
      "Bash(npm test:*)",
      "Bash(npm run build:*)"
    ],
    "deny": [
      "Bash(git push --force:*)",
      "Bash(rm -rf:*)"
    ]
  }
}

4.2 项目级约束：CLAUDE.md

位置：项目根目录 CLAUDE.md（你已经在 Wingman 项目中用了）

# 项目约束

## 目录结构
- 每个命令单独放在 src/commands/<命令名>/index.ts 下

## Git 提交信息格式
- 标题：约定式提交（feat/fix/refactor/docs/chore），包含作用域
- 正文：简短要点列出关键变更
- 全篇中文，300 字以内

## 编码规范
- 共享工具放在 src/ 根目录
- 每个命令关键节点用 log() 输出日志

Claude Code 启动时会自动读取 CLAUDE.md，并作为 system prompt 的一部分——这正是规范驱动开发（SSD）的核心实践：把团队规范编码进 AI 的约束。

4.3 环境变量速查

变量	作用	你的设置
ANTHROPIC_AUTH_TOKEN	API 鉴权	DeepSeek API Key
ANTHROPIC_BASE_URL	API 地址	https://api.deepseek.com/anthropic
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 模型映射	deepseek-v4-pro
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 模型映射	deepseek-v4-pro
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 模型映射	deepseek-v4-flash
CLAUDE_CODE_EFFORT_LEVEL	思考深度	max / high / medium / low

---

五、实战工作流示例

5.1 日常开发工作流

# 早晨：快速回顾昨天做了什么
cd /path/to/your-project
claude -p "查看 git log 最近一天的提交，总结要点"

# 开发中：让 Claude 帮忙写代码
claude -p "给 gitCommit 命令加一个参数 --dry-run，只生成提交信息不实际提交"

# 提交前：生成规范的 commit message
claude -p "分析暂存区的变更，生成约定式提交格式的中文提交信息"

# 下班前：生成周报草稿
claude -p "根据 git log 最近一周的提交记录，生成周报草稿"

5.2 代码审查工作流

# 审查自己的代码
claude -p "审查 src/commands/gitCommit/index.ts，检查：
1. 是否有硬编码密钥
2. 错误处理是否完整
3. 函数是否过长
4. 命名是否清晰
逐条给出结果（PASS/FAIL + 说明）"

# 审查 PR
git fetch origin
git diff origin/main...HEAD | claude -p "审查这些改动，关注安全性和边界条件"

5.3 学习与研究

# 快速理解源码
claude -p "阅读 src/deepseek.ts，画出函数调用关系图，用 mermaid 格式"
claude -p "解释 src/commands/gitCommit/index.ts 中 performCommit 函数的 git 操作逻辑"

# 技术调研
claude -p "TypeScript 中 stdin/stdout 作为 JSON-RPC 传输层的最佳实践是什么？结合 MCP 协议给示例代码"

---

六、与 VSCode 的区别

你平时在 VSCode 中用 Claude Code 插件（你当前的模式），与 CLI 的区别：

维度	VSCode 插件模式	CLI 模式
启动方式	侧边栏 / Ctrl+Shift+P	终端敲 claude
编辑文件	自动应用到编辑器	通过 Edit 工具修改，或在终端看 diff
上下文	跟随 VSCode 工作区	跟随当前目录
权限控制	VSCode 权限体系	CLI 权限体系（可配）
适用场景	边看代码边对话、IDE 内操作	终端环境、自动化脚本、CI/CD 集成
输出	VSCode 面板	终端标准输出

两者共享相同的 CLAUDE.md、settings.json、conversation 存储。你可以随时切换。

---

七、你现在就用起来

步序 1：安装

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

步序 2：配置 DeepSeek 兼容接口（已有环境变量）

# 在 PowerShell 中（建议写入 PowerShell Profile 永久生效）
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<你的 DeepSeek API Key>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"

步序 3：跑第一个命令

cd /path/to/your-project
claude -p "这个项目的目录结构和核心功能是什么？"

---

八、常用命令速查卡

# 安装
npm install -g @anthropic-ai/claude-code

# 交互模式
claude

# 单次问答
claude -p "你的问题"

# 指定工作区
claude --workspace /path/to/project

# 审查代码
git diff | claude -p "审查这些变更"

# 生成提交信息
claude -p "根据当前 git diff 生成约定式提交信息"

# 解释代码
claude -p "解释 src/xxx.ts 的核心逻辑"

# 限制工具（只读模式）
claude --allowedTools "Read,Grep,Glob" -p "分析项目结构"

# 继续上次会话
claude --continue

# 查看版本
claude --version

# 查看帮助
claude --help