Claude Code CLI命令大全

Claude Code 作为 Anthropic 官方命令行工具，可助力开发者高效完成代码编写、调试等任务。本文全面讲解其安装、配置、核心命令及高阶用法，覆盖 chat、complete、config 等关键指令与模型切换、上下文管理等实操技巧。本文就来详细的介绍一下 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 "请帮我分析这个项目的结构"
# 从文件读取提示
claude --file prompt.txt
# 从标准输入读取
echo "解释这段代码" | claude
cat code.py | claude "请解释这段代码的功能"

交互模式特点

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

交互命令

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

示例

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

claude chat

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

命令语法

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

claude complete 用于代码补全场景，提供类似 IDE 的智能代码补全功能。

命令语法

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 用于管理 Claude Code 的配置。

命令语法

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 并按优先级排序"

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命令大全的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。