Claude Code CLI命令使用小结实用指南

# 使用 npm 安装
npm install -g @anthropic-ai/claude-code
# 使用 yarn 安装
yarn global add @anthropic-ai/claude-code
# 使用 pnpm 安装
pnpm add -g @anthropic-ai/claude-code

# 首次运行会引导配置 API Key
claude
# 或手动设置环境变量
export ANTHROPIC_API_KEY="your-api-key-here"
# 添加到 shell 配置文件（持久化）
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.bashrc

# 查看版本
claude --version
# 查看帮助
claude --help

# 直接启动交互式聊天
claude
# 带初始提示启动
claude "请帮我分析这个项目的结构"
# 从文件读取提示
claude --file prompt.txt
# 从标准输入读取
echo "解释这段代码" | claude
cat code.py | claude "请解释这段代码的功能"

# 启动并直接提问
$ claude "什么是闭包？请用 JavaScript 举例"
# 分析当前项目
$ cd my-project
$ claude "分析这个项目的架构，给出改进建议"
# 代码审查模式
$ claude "请审查当前目录的代码，指出潜在的安全问题"

claude chat [选项] [初始提示]

# 使用 Claude 3.5 Sonnet（推荐）
claude chat --model claude-sonnet-4-20250514
# 使用 Claude 3 Opus（最强能力）
claude chat --model claude-3-opus-20240229
# 使用 Claude 3 Haiku（最快速度）
claude chat --model claude-3-haiku-20240307
# 模型别名
claude chat -m sonnet    # 最新 Sonnet
claude chat -m opus      # 最新 Opus
claude chat -m haiku     # 最新 Haiku

# 低温度：更确定、一致（适合代码生成）
claude chat --temperature 0.2 "写一个排序函数"
# 高温度：更有创意（适合头脑风暴）
claude chat --temperature 0.9 "给我一些创意项目想法"

# 设置角色
claude chat --system "你是一位资深 Python 开发者，擅长代码优化"
# 从文件读取系统提示
claude chat --system-file system-prompt.txt
# 组合使用
claude chat -s "你是代码审查专家" -m sonnet "审查这段代码"

# 添加单个文件作为上下文
claude chat --context src/main.py "解释这个文件"

# 添加整个目录
claude chat --context ./src "分析项目结构"

# 多个上下文
claude chat -c package.json -c src/ "分析项目依赖"

# 1. 基础问答
claude chat "什么是 RESTful API？"
# 2. 代码生成
claude chat -m sonnet -t 0.3 "用 TypeScript 实现一个 LRU 缓存"
# 3. 代码解释
claude chat --context app.js "解释这个文件的架构"
# 4. 多轮对话保存
claude chat --save-session session.json "帮我设计一个数据库 schema"
# 5. JSON 输出（适合脚本处理）
claude chat --json "列出 5 种排序算法" | jq '.response'
# 6. 非交互模式（单次问答后退出）
claude chat --no-interactive "今天是星期几？"

claude complete [选项] [前缀代码]

# 1. 函数补全
claude complete "function fibonacci(n) {"
# 2. 类方法补全
claude complete "class UserService {
  async getUser(id) {"
# 3. SQL 补全
claude complete --language sql "SELECT * FROM users WHERE"
# 4. Shell 脚本补全
claude complete --language bash "for file in *.json; do"

# 补全文件末尾的代码
claude complete --file src/utils.js
# 补全特定位置
claude complete --file src/app.py --line 42 --column 15

claude complete -l javascript "const fetchData = async () =>"
# Python
claude complete -l python "def quicksort(arr):"
# Rust
claude complete -l rust "impl<'a> Iterator for "
# Go
claude complete -l go "func (s *Server) Handle("
# Java
claude complete -l java "public class Calculator {"
# C/C++
claude complete -l c "int binary_search(int* arr, int n, int target) {"
# Ruby
claude complete -l ruby "class Article < ApplicationRecord"

# Vim/Neovim 集成示例
claude complete --file "$FILE" --line "$LINE" --column "$COL"
# Emacs 集成
claude complete --file (buffer-file-name) --line (line-number-at-pos)
# VS Code 扩展可调用
claude complete -l typescript --max-tokens 128 "$PREFIX"

# 1. 简单函数补全
$ claude complete "function greet(name) {"
// 输出：
//   return `Hello, ${name}!`;
// }
# 2. 带类型注解的补全
$ claude complete -l typescript "interface User {
  id: number;
  name: string;
}
function formatUser(user: User): string {"
// 输出：
//   return `User ${user.id}: ${user.name}`;
// }
# 3. 批量补全建议
$ claude complete --n 3 "const numbers = [1, 2, 3, 4, 5];
const doubled ="
// 输出三个补全选项：
// 1. numbers.map(n => n * 2);
// 2. numbers.forEach(n => console.log(n * 2));
// 3. numbers.reduce((acc, n) => acc + n * 2, 0);
# 4. SQL 查询补全
$ claude complete -l sql "SELECT u.name, COUNT(o.id) as order_count
FROM users u"
// 输出：
// JOIN orders o ON u.id = o.user_id
// GROUP BY u.id, u.name
// ORDER BY order_count DESC;

claude config <子命令> [选项]

# 查看所有配置
claude config list
# 获取单个配置
claude config get model
claude config get temperature
# 设置配置
claude config set model claude-3-opus-20240229
claude config set temperature 0.5
claude config set maxTokens 8192
# 设置自定义 API 端点（企业部署）
claude config set apiEndpoint https://your-proxy.example.com
# 删除配置项（恢复默认）
claude config unset temperature
# 重置所有配置
claude config reset
# 查看配置文件位置
claude config path
# 输出：~/.config/claude-code/config.json

# macOS / Linux
~/.config/claude-code/config.json
# Windows
%APPDATA%\claude-code\config.json
# 或通过环境变量指定
CLAUDE_CONFIG_DIR=/custom/path claude

{
  "model": "claude-sonnet-4-20250514",
  "temperature": 0.7,
  "maxTokens": 4096,
  "stream": true,
  "contextLines": 500,
  "historySize": 1000,
  "editor": "code",
  "apiEndpoint": "https://api.anthropic.com",
  "customPrompts": {
    "review": "请审查以下代码，关注安全性、性能和可维护性：",
    "test": "为以下代码生成单元测试："
  }
}

# 生成项目结构
claude "帮我创建一个 Express + TypeScript 项目的目录结构"
# 代码审查
claude --context ./src "审查这些代码，指出潜在问题和改进建议"
# 生成单元测试
claude "为 utils.js 中的 formatDate 函数生成 Jest 测试用例"
# 代码重构
claude "将这个回调风格的函数重构为 async/await"
# 添加类型定义
claude "为这个 JavaScript 文件添加 TypeScript 类型定义"
# 生成文档
claude "为 API 路由生成 Swagger/OpenAPI 文档"

# 分析错误日志
cat error.log | claude "分析这些错误日志，找出根本原因"
# 调试帮助
claude "这段代码为什么会报 'undefined is not a function' 错误？"
# 性能分析
claude "分析这段代码的性能瓶颈"
# 安全检查
claude "检查这段代码是否有 SQL 注入风险"

# 解释复杂代码
claude --context complex-algorithm.js "用简单的话解释这个算法"
# 生成 README
claude "为这个项目生成 README.md，包括安装、使用和 API 说明"
# 代码注释
claude "为这个函数添加详细的 JSDoc 注释"
# 翻译注释
claude "将代码中的英文注释翻译成中文"

# Git 提交信息生成
git diff --cached | claude "根据这些更改生成一个简洁的 Git 提交信息"
# 变更日志生成
git log --oneline -20 | claude "生成 CHANGELOG.md 格式的变更日志"
# 代码格式化建议
claude "检查这个项目的代码风格，给出 ESLint 配置建议"
# 依赖分析
claude --context package.json "分析项目依赖，指出过时的包和安全风险"

# JSON 格式化
cat data.json | claude "格式化这个 JSON，按字段名排序"
# 数据转换
claude "将这个 JSON 数组转换为 CSV 格式"
# 正则表达式
claude "写一个正则表达式匹配中国手机号码"
# SQL 生成
claude "根据这个 JSON 结构生成创建表的 SQL 语句"

# 创建系统提示
cat > ~/.claude-prompts/code-reviewer.txt << 'EOF'
你是一位资深代码审查专家。审查代码时请关注：
1. 代码可读性和可维护性
2. 潜在的安全漏洞
3. 性能问题
4. 最佳实践遵循情况
5. 测试覆盖率建议
请用简洁的列表形式给出审查意见，每项包含问题描述和修复建议。
EOF
# 使用自定义系统提示
claude chat --system-file ~/.claude-prompts/code-reviewer.txt "审查这段代码"

# 读取剪贴板内容
pbpaste | claude "总结这段文本的要点"
# 输出到文件
claude "生成一个待办事项应用的设计文档" > design.md
# 处理多个文件
find . -name "*.js" -exec claude "检查这个文件的代码质量" {} \;
# 与 grep 结合
grep -r "TODO" . | claude "整理这些 TODO 并按优先级排序"

# 基础别名
alias c='claude'
alias cc='claude chat'
alias ccc='claude complete'
# 快捷命令
alias ccode='claude -m claude-sonnet-4-20250514'  # 快速 Sonnet
alias copus='claude -m claude-3-opus-20240229'   # 快速 Opus
alias chaiku='claude -m claude-3-haiku-20240307' # 快速 Haiku
# 专用功能
alias c-review='claude --system "你是代码审查专家，请详细审查代码"'
alias c-doc='claude --system "你是技术文档专家，请生成清晰的文档"'
alias c-fix='claude --system "你是调试专家，请帮助诊断和修复代码问题"'
# Git 集成
alias git-commit-msg='git diff --cached | claude "生成 Git 提交信息"'
alias git-branch-name='claude "根据这个任务生成简洁的 Git 分支名"'

# ~/.zshrc 或 ~/.bashrc
# API 配置
export ANTHROPIC_API_KEY="your-api-key"
# 默认模型
export CLAUDE_MODEL="claude-sonnet-4-20250514"
# 默认温度
export CLAUDE_TEMPERATURE="0.7"
# 日志级别
export CLAUDE_LOG_LEVEL="info"
# 自定义端点（代理）
export ANTHROPIC_BASE_URL="https://your-proxy.com"
# 代理设置
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

#!/bin/bash
# code-review.sh - 代码审查工作流
echo "? 开始代码审查..."
# 获取变更文件
CHANGED_FILES=$(git diff --name-only HEAD~1)
for FILE in $CHANGED_FILES; do
    echo "\n? 审查文件: $FILE"
    claude --system "你是代码审查专家" \
           --context "$FILE" \
           "审查这个文件，指出问题和改进建议"
done
echo "\n✅ 审查完成"

#!/bin/bash
# auto-doc.sh - 自动生成文档
PROJECT_ROOT=$(pwd)
# 生成 API 文档
find "$PROJECT_ROOT/src/api" -name "*.js" | while read FILE; do
    DOC_FILE="${FILE%.js}.md"
    claude --context "$FILE" \
           "为这个 API 文件生成详细的 Markdown 文档" \
           > "$DOC_FILE"
    echo "? 生成文档: $DOC_FILE"
done

# 临时切换
claude -m claude-3-opus-20240229 "复杂问题"
# 永久切换
claude config set model claude-3-opus-20240229

# 限制上下文行数
claude --context-lines 200 --context large-file.js "分析这个文件"
# 分段处理
head -500 large-file.js | claude "分析前 500 行"

# 方法 1: 使用 /save 命令（交互模式）
/save conversation.json
# 方法 2: 重定向输出
claude chat "问题" > output.txt 2>&1
# 方法 3: 使用 --output 选项
claude --output session.log chat

# 设置更长的超时
export CLAUDE_TIMEOUT=120000  # 毫秒
# 使用代理
export HTTP_PROXY="http://your-proxy:port"

claude "创建一个 Node.js CLI 工具，支持以下命令：
- init: 初始化项目
- build: 构建项目
- deploy: 部署到服务器
使用 commander.js，包含完整的项目结构"

# 语言转换
claude "将这段 Python 代码转换为 TypeScript" --context script.py
# 风格转换
claude "将这段代码从回调风格转换为 Promise 风格"

# 概念解释
claude "用简单的比喻解释 React 的 Virtual DOM"
# 学习路径
claude "我想学习 Go 语言后端开发，给我一个 3 个月的学习计划"
# 代码演练
claude "给我一个 Rust 所有权概念的小测验"

# 错误分析
claude "这个错误是什么意思：TypeError: Cannot read property 'x' of undefined"

# 修复建议
claude "这段代码有 bug，请帮我找出问题：$(cat buggy.js)"

# 基础命令
claude                              # 启动交互模式
claude "问题"                        # 带初始提示启动
claude chat                         # 显式聊天模式
claude complete "代码"              # 代码补全
claude config list                  # 查看配置
# 常用选项
-m, --model                   # 指定模型
-t, --temperature                # 设置温度
--max-tokens                     # 最大 token 数
-s, --system                # 系统提示词
-c, --context                 # 添加上下文
-f, --file                    # 从文件读取
--json                              # JSON 输出
--no-stream                         # 禁用流式输出
# 配置管理
claude config get              # 获取配置
claude config set       # 设置配置
claude config unset            # 删除配置
claude config reset                 # 重置配置
claude config path                  # 配置文件路径
# 实用组合
cat file.js | claude "解释这段代码"  # 管道输入
claude --context src/ "分析项目"     # 目录上下文
claude -m opus -t 0.3 "生成代码"    # Opus + 低温度
git diff | claude "生成提交信息"     # Git 集成