平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“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
# 带初始提示启动
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-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": "为以下代码生成单元测试："
  }
}

全局选项与参数

所有命令通用选项

模型相关选项

输入输出选项

上下文选项

实用示例集锦

代码开发

# 生成项目结构
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命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多兼容脚本之家！