Claude Code CLI命令使用小结

目录

• 安装与配置
• 安装方式
• 初始化配置
• 验证安装
• 核心命令概览
• claude（默认交互模式）
• 基本用法
• 交互模式特点
• 交互命令
• 示例
• claude chat
• 命令语法
• 选项
• 模型选项
• 温度参数
• 系统提示词
• 上下文管理
• 示例
• claude complete
• 命令语法
• 选项
• 使用场景
• 从文件补全
• 多语言支持
• 集成到编辑器
• 示例
• claude config
• 命令语法
• 子命令
• 配置项列表
• 使用示例
• 配置文件位置
• 配置文件示例
• 全局选项与参数
• 所有命令通用选项
• 模型相关选项
• 输入输出选项
• 上下文选项
• 实用示例集锦
• 代码开发
• 调试与问题解决
• 文档与解释
• 自动化脚本
• 数据处理
• 高级用法
• 自定义系统提示
• 管道与重定向
• Shell 别名配置
• 环境变量配置
• 工作流集成
• 常见问题与技巧
• 常见问题
• 实用技巧
• 命令速查表
• 总结

Claude Code 是 Anthropic 官方推出的命令行工具，让开发者能在终端中与 Claude 进行交互，实现代码编写、调试、重构等任务。

# 使用 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 chat	显式启动聊天模式	明确指定聊天场景
claude complete	代码补全模式	代码自动补全
claude config	配置管理	设置/查看配置项
claude –help	显示帮助信息	查看命令用法
claude –version	显示版本号	版本确认

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

• 多轮对话：支持上下文记忆，可进行连续对话
• 代码感知：能理解当前目录的项目结构
• 文件操作：可读取、创建、修改文件
• 命令执行：可执行 shell 命令（需确认）

在交互模式中，可以使用以下特殊命令：

命令	描述
/help	显示帮助信息
/clear	清除对话历史
/exit 或 Ctrl+D	退出交互模式
/model	切换模型
/save <file>	保存对话到文件
/load <file>	加载对话历史
/config	查看当前配置

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

claude chat 是显式的聊天模式命令，功能与默认模式相同，但更明确。

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

选项	简写	描述	默认值
–model	-m	指定使用的模型	claude-sonnet-4-20250514
–temperature	-t	设置温度参数（0-1）	0.7
–max-tokens		最大生成 token 数	4096
–system	-s	设置系统提示词	–
–file	-f	从文件读取输入	–
–context	-c	添加上下文文件/目录	–
–no-stream		禁用流式输出	false
–json		JSON 格式输出	false
–verbose	-v	详细输出模式	false

# 使用 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 用于代码补全场景，提供类似 IDE 的智能代码补全功能。

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

选项	简写	描述	默认值
–model	-m	指定模型	claude-sonnet-4-20250514
–language	-l	指定编程语言	自动检测
–max-tokens		最大补全长度	256
–file	-f	从文件读取	–
–stop		停止标记	–
–temperature	-t	温度参数	0.2
–n		返回多个补全结果	1

# 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 Code 的配置。

claude config <子命令> [选项]

子命令	描述
list	列出所有配置
get <key>	获取单个配置项
set <key> <value>	设置配置项
unset <key>	删除配置项
reset	重置所有配置
path	显示配置文件路径

配置项	描述	默认值
model	默认模型	claude-sonnet-4-20250514
temperature	默认温度	0.7
maxTokens	最大 token 数	4096
apiEndpoint	API 端点	https://api.anthropic.com
apiKey	API Key（不推荐直接存储）	–
editor	默认编辑器	$EDITOR 或 vim
historySize	历史记录大小	1000
stream	是否流式输出	true
contextLines	上下文行数限制	500

# 查看所有配置
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-codeconfig.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": "为以下代码生成单元测试："
  }
}

选项	简写	描述	示例
–help	-h	显示帮助信息	claude –help
–version	-V	显示版本号	claude –version
–verbose	-v	详细输出	claude -v chat "问题"
–quiet	-q	静默模式	claude -q complete "代码"
–json		JSON 格式输出	claude –json chat
–no-color		禁用彩色输出	claude –no-color
–log-level		日志级别	claude –log-level debug
–config	-c	指定配置文件	claude -c custom.json

选项	描述	可选值
–model	指定模型	claude-sonnet-4-20250514, claude-3-opus-20240229, claude-3-haiku-20240307
–temperature	随机性控制	0.0 – 1.0
–max-tokens	最大输出长度	1 – 4096+
–top-p	核采样参数	0.0 – 1.0
–top-k	Top-K 采样	1 – 100

选项	描述
–file <path>	从文件读取输入
–output <path>	输出到文件
–append	追加模式输出
–no-stream	禁用流式输出

选项	描述
–context <path>	添加上下文文件/目录
–context-lines <n>	上下文行数限制
–no-context	禁用自动上下文检测

# 生成项目结构
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 并按优先级排序"

添加到 ~/.zshrc 或 ~/.bashrc：

# 基础别名
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

Q: 如何切换不同的模型？

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

Q: 如何处理大型文件？

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

Q: 如何保存对话历史？

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

Q: 如何处理超时或网络问题？

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

1. 快速原型开发

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

2. 代码转换

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

3. 学习助手

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

4. 调试助手

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

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

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

Claude Code CLI 是一个强大的命令行 AI 助手，掌握其命令和选项能极大提升开发效率：

• claude / claude chat：日常对话和代码问答的主力工具
• claude complete：代码补全，适合集成到编辑器工作流
• claude config：灵活配置，定制个人偏好

结合 Shell 别名、管道操作和自动化脚本，可以构建高效的 AI 辅助开发工作流。

到此这篇关于Claude Code CLI命令使用小结的文章就介绍到这了,更多相关Claude Code CLI命令内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！