Claude Code CLI 使用完整指南

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

claude --version

# 设置 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

# 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"

# 进入项目目录后直接启动（交互模式）
cd /path/to/your-project
claude
# 或者在任意目录指定工作区
claude --workspace /path/to/your-project

# 一次性问一个问题，不进入 REPL
claude -p "解释一下这个项目是做什么的"
# 把结果输出到文件
claude -p "列出所有 TypeScript 文件" > files.txt
# 在管道中使用
cat error.log | claude -p "分析这些错误日志，告诉我根因"

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

# 理解项目结构
claude -p "这个项目的目录结构是什么样的？每个文件做什么？"
# 理解代码逻辑
claude -p "src/commands/gitCommit/index.ts 的 loadCommitFormat 函数做了什么？三级优先级是什么？"
# 找代码位置
claude -p "DeepSeek API 调用逻辑在哪个文件？给我路径和行号"

# 添加新功能
claude -p "在 gitCommit 命令中新加一个选项：'仅生成不看结果'，跳过弹窗直接使用 AI 生成的提交信息提交"
# 修复 Bug
claude -p "修复 src/logger.ts 中时间戳格式不对的问题，应该是 YYYY-MM-DD HH:mm:ss"
# 重构
claude -p "把 src/commands/ 下三个命令的公共逻辑提取成一个共享函数"

# 查看变更
claude -p "查看最近的 git 提交记录，总结主要变更"
# 生成 commit message
claude -p "分析 git diff 的变更内容，按照约定式提交格式生成中文 commit message"
# 创建 PR
claude -p "基于当前分支的变更，创建一个 PR 描述"

# 审查 PR diff
git diff main | claude -p "审查这些代码变更，检查是否有安全问题、性能问题或逻辑错误"
# 审查当前修改
claude -p "审查当前 git diff，逐条报告不合规项"

# 生成 API 文档
claude -p "根据 src/deepseek.ts 的代码生成函数接口文档，markdown 格式"
# 生成 README
claude -p "根据 package.json 和 src/ 下的所有代码，更新 README.md"

{
  "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:*)"
    ]
  }
}

# 项目约束
## 目录结构
- 每个命令单独放在 src/commands/<命令名>/index.ts 下
## Git 提交信息格式
- 标题：约定式提交（feat/fix/refactor/docs/chore），包含作用域
- 正文：简短要点列出关键变更
- 全篇中文，300 字以内
## 编码规范
- 共享工具放在 src/ 根目录
- 每个命令关键节点用 log() 输出日志

# 早晨：快速回顾昨天做了什么
cd /path/to/your-project
claude -p "查看 git log 最近一天的提交，总结要点"
# 开发中：让 Claude 帮忙写代码
claude -p "给 gitCommit 命令加一个参数 --dry-run，只生成提交信息不实际提交"
# 提交前：生成规范的 commit message
claude -p "分析暂存区的变更，生成约定式提交格式的中文提交信息"
# 下班前：生成周报草稿
claude -p "根据 git log 最近一周的提交记录，生成周报草稿"

# 审查自己的代码
claude -p "审查 src/commands/gitCommit/index.ts，检查：
1. 是否有硬编码密钥
2. 错误处理是否完整
3. 函数是否过长
4. 命名是否清晰
逐条给出结果（PASS/FAIL + 说明）"
# 审查 PR
git fetch origin
git diff origin/main...HEAD | claude -p "审查这些改动，关注安全性和边界条件"

# 快速理解源码
claude -p "阅读 src/deepseek.ts，画出函数调用关系图，用 mermaid 格式"
claude -p "解释 src/commands/gitCommit/index.ts 中 performCommit 函数的 git 操作逻辑"
# 技术调研
claude -p "TypeScript 中 stdin/stdout 作为 JSON-RPC 传输层的最佳实践是什么？结合 MCP 协议给示例代码"

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

# 在 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"

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