Claude Code CLI命令使用小结

  发布时间:2026-04-13 10:14:01   作者:Anyi研习社   我要评论
Claude Code 是 Anthropic 官方推出的命令行工具,让开发者能在终端中与 Claude 进行交互,本文就来详细的介绍一下Claude Code CLI命令使用,感兴趣的可以了解一下

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 "请帮我分析这个项目的结构"
# 从文件读取提示
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 是显式的聊天模式命令,功能与默认模式相同,但更明确。

命令语法

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
--jsonJSON 格式输出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

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 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
apiEndpointAPI 端点https://api.anthropic.com
apiKeyAPI 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-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": "为以下代码生成单元测试:"
  }
}

全局选项与参数

所有命令通用选项

选项简写描述示例
--help-h显示帮助信息claude --help
--version-V显示版本号claude --version
--verbose-v详细输出claude -v chat "问题"
--quiet-q静默模式claude -q complete "代码"
--jsonJSON 格式输出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-kTop-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 并按优先级排序"

Shell 别名配置

添加到 ~/.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命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!

相关文章

  • Claude Code 命令行的使用总结

    本文主要介绍了ClaudeCode的安装、配置及使用方法,包括环境要求、安装步骤、API配置、核心使用方式和常用命令等,强调了配置第三方API中转服务的重要性,感兴趣的可以了解一
    2026-04-13
  • 2026年Claude Code常用命令与操作详解

    这篇文章主要为大家详细介绍了2026年Claude Code中常用命令与具体操作,包括文件操作命令,Bash 命令执行,Git 操作,AWS CLI 操作等,文中的示例代码讲解详细,有需要的小
    2026-04-10
  • Claude Code 超详细完整指南2026最新版

    本文介绍了在Windows上安装并使用ClaudeCode(Anthropic开发的AI编程助手)的步骤,从安装Node.js、Git等依赖开始,到配置API Key、初次运行及常用命令,感兴趣的朋友一起看
    2026-04-09

最新评论