Claude Code CLI 命令详解免费专栏全套教程 Claude Code 从入门到精通✦开篇总览最新目录 Claude Code 从入门到精通 —带你玩转Claude CodeClaude Code 是 Anthropic 官方推出的命令行工具让开发者能在终端中与 Claude 进行交互实现代码编写、调试、重构等任务。目录安装与配置核心命令概览claude默认交互模式claude chatclaude completeclaude config全局选项与参数实用示例集锦高级用法常见问题与技巧安装与配置安装方式# 使用 npm 安装npminstall-ganthropic-ai/claude-code# 使用 yarn 安装yarnglobaladdanthropic-ai/claude-code# 使用 pnpm 安装pnpmadd-ganthropic-ai/claude-code初始化配置# 首次运行会引导配置 API Keyclaude# 或手动设置环境变量exportANTHROPIC_API_KEYyour-api-key-here# 添加到 shell 配置文件持久化echoexport ANTHROPIC_API_KEYyour-api-key~/.zshrcechoexport ANTHROPIC_API_KEYyour-api-key~/.bashrc验证安装# 查看版本claude--version# 查看帮助claude--help核心命令概览命令描述常用场景claude启动交互式聊天默认日常对话、代码问答claude chat显式启动聊天模式明确指定聊天场景claude complete代码补全模式代码自动补全claude config配置管理设置/查看配置项claude --help显示帮助信息查看命令用法claude --version显示版本号版本确认claude默认交互模式基本用法# 直接启动交互式聊天claude# 带初始提示启动claude请帮我分析这个项目的结构# 从文件读取提示claude--fileprompt.txt# 从标准输入读取echo解释这段代码|claudecatcode.py|claude请解释这段代码的功能交互模式特点多轮对话支持上下文记忆可进行连续对话代码感知能理解当前目录的项目结构文件操作可读取、创建、修改文件命令执行可执行 shell 命令需确认交互命令在交互模式中可以使用以下特殊命令命令描述/help显示帮助信息/clear清除对话历史/exit或CtrlD退出交互模式/model切换模型/save file保存对话到文件/load file加载对话历史/config查看当前配置示例# 启动并直接提问$ claude什么是闭包请用 JavaScript 举例# 分析当前项目$cdmy-project $ claude分析这个项目的架构给出改进建议# 代码审查模式$ claude请审查当前目录的代码指出潜在的安全问题claude chatclaude chat是显式的聊天模式命令功能与默认模式相同但更明确。命令语法claude chat[选项][初始提示]选项选项简写描述默认值--model-m指定使用的模型claude-sonnet-4-20250514--temperature-t设置温度参数0-10.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--modelclaude-sonnet-4-20250514# 使用 Claude 3 Opus最强能力claude chat--modelclaude-3-opus-20240229# 使用 Claude 3 Haiku最快速度claude chat--modelclaude-3-haiku-20240307# 模型别名claude chat-msonnet# 最新 Sonnetclaude chat-mopus# 最新 Opusclaude chat-mhaiku# 最新 Haiku温度参数# 低温度更确定、一致适合代码生成claude chat--temperature0.2写一个排序函数# 高温度更有创意适合头脑风暴claude chat--temperature0.9给我一些创意项目想法系统提示词# 设置角色claude chat--system你是一位资深 Python 开发者擅长代码优化# 从文件读取系统提示claude chat --system-file system-prompt.txt# 组合使用claude chat-s你是代码审查专家-msonnet审查这段代码上下文管理# 添加单个文件作为上下文claude chat--contextsrc/main.py解释这个文件# 添加整个目录claude chat--context./src分析项目结构# 多个上下文claude chat-cpackage.json-csrc/分析项目依赖示例# 1. 基础问答claude chat什么是 RESTful API# 2. 代码生成claude chat-msonnet-t0.3用 TypeScript 实现一个 LRU 缓存# 3. 代码解释claude chat--contextapp.js解释这个文件的架构# 4. 多轮对话保存claude chat --save-session session.json帮我设计一个数据库 schema# 5. JSON 输出适合脚本处理claude chat--json列出 5 种排序算法|jq.response# 6. 非交互模式单次问答后退出claude chat --no-interactive今天是星期几claude completeclaude 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 completefunction fibonacci(n) {# 2. 类方法补全claude completeclass UserService { async getUser(id) {# 3. SQL 补全claude complete--languagesqlSELECT * FROM users WHERE# 4. Shell 脚本补全claude complete--languagebashfor file in *.json; do从文件补全# 补全文件末尾的代码claude complete--filesrc/utils.js# 补全特定位置claude complete--filesrc/app.py--line42--column15多语言支持# JavaScript/TypeScriptclaude complete-ljavascriptconst fetchData async () # Pythonclaude complete-lpythondef quicksort(arr):# Rustclaude complete-lrustimpla Iterator for # Goclaude complete-lgofunc (s *Server) Handle(# Javaclaude complete-ljavapublic class Calculator {# C/Cclaude complete-lcint binary_search(int* arr, int n, int target) {# Rubyclaude complete-lrubyclass 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-ltypescript --max-tokens128$PREFIX示例# 1. 简单函数补全$ claude completefunction greet(name) {// 输出 //returnHello, ${name}!;//}# 2. 带类型注解的补全$ claude complete-ltypescriptinterface User { id: number; name: string; } function formatUser(user: User): string {// 输出 //returnUser ${user.id}: ${user.name};//}# 3. 批量补全建议$ claude complete--n3const numbers [1, 2, 3, 4, 5]; const doubled // 输出三个补全选项 //1. numbers.map(nn *2);//2. numbers.forEach(nconsole.log(n *2));//3. numbers.reduce((acc, n)acc n *2,0);# 4. SQL 查询补全$ claude complete-lsqlSELECT u.name, COUNT(o.id) as order_count FROM users u// 输出 // JOIN orders o ON u.ido.user_id // GROUP BY u.id, u.name // ORDER BY order_count DESC;claude configclaude config用于管理 Claude Code 的配置。命令语法claude config子命令[选项]子命令子命令描述list列出所有配置get key获取单个配置项set key value设置配置项unset key删除配置项reset重置所有配置path显示配置文件路径配置项列表配置项描述默认值model默认模型claude-sonnet-4-20250514temperature默认温度0.7maxTokens最大 token 数4096apiEndpointAPI 端点https://api.anthropic.comapiKeyAPI Key不推荐直接存储-editor默认编辑器$EDITOR 或 vimhistorySize历史记录大小1000stream是否流式输出truecontextLines上下文行数限制500使用示例# 查看所有配置claude config list# 获取单个配置claude config get model claude config get temperature# 设置配置claude configsetmodel claude-3-opus-20240229 claude configsettemperature0.5claude configsetmaxTokens8192# 设置自定义 API 端点企业部署claude configsetapiEndpoint https://your-proxy.example.com# 删除配置项恢复默认claude configunsettemperature# 重置所有配置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 文档调试与问题解决# 分析错误日志caterror.log|claude分析这些错误日志找出根本原因# 调试帮助claude这段代码为什么会报 undefined is not a function 错误# 性能分析claude分析这段代码的性能瓶颈# 安全检查claude检查这段代码是否有 SQL 注入风险文档与解释# 解释复杂代码claude--contextcomplex-algorithm.js用简单的话解释这个算法# 生成 READMEclaude为这个项目生成 README.md包括安装、使用和 API 说明# 代码注释claude为这个函数添加详细的 JSDoc 注释# 翻译注释claude将代码中的英文注释翻译成中文自动化脚本# Git 提交信息生成gitdiff--cached|claude根据这些更改生成一个简洁的 Git 提交信息# 变更日志生成gitlog--oneline-20|claude生成 CHANGELOG.md 格式的变更日志# 代码格式化建议claude检查这个项目的代码风格给出 ESLint 配置建议# 依赖分析claude--contextpackage.json分析项目依赖指出过时的包和安全风险数据处理# JSON 格式化catdata.json|claude格式化这个 JSON按字段名排序# 数据转换claude将这个 JSON 数组转换为 CSV 格式# 正则表达式claude写一个正则表达式匹配中国手机号码# SQL 生成claude根据这个 JSON 结构生成创建表的 SQL 语句高级用法自定义系统提示创建系统提示文件用于特定任务# 创建系统提示cat~/.claude-prompts/code-reviewer.txtEOF 你是一位资深代码审查专家。审查代码时请关注 1. 代码可读性和可维护性 2. 潜在的安全漏洞 3. 性能问题 4. 最佳实践遵循情况 5. 测试覆盖率建议 请用简洁的列表形式给出审查意见每项包含问题描述和修复建议。 EOF# 使用自定义系统提示claude chat --system-file ~/.claude-prompts/code-reviewer.txt审查这段代码管道与重定向# 读取剪贴板内容pbpaste|claude总结这段文本的要点# 输出到文件claude生成一个待办事项应用的设计文档design.md# 处理多个文件find.-name*.js-execclaude检查这个文件的代码质量{}\;# 与 grep 结合grep-rTODO.|claude整理这些 TODO 并按优先级排序Shell 别名配置添加到~/.zshrc或~/.bashrc# 基础别名aliascclaudealiasccclaude chataliascccclaude complete# 快捷命令aliasccodeclaude -m claude-sonnet-4-20250514# 快速 Sonnetaliascopusclaude -m claude-3-opus-20240229# 快速 Opusaliaschaikuclaude -m claude-3-haiku-20240307# 快速 Haiku# 专用功能aliasc-reviewclaude --system 你是代码审查专家请详细审查代码aliasc-docclaude --system 你是技术文档专家请生成清晰的文档aliasc-fixclaude --system 你是调试专家请帮助诊断和修复代码问题# Git 集成aliasgit-commit-msggit diff --cached | claude 生成 Git 提交信息aliasgit-branch-nameclaude 根据这个任务生成简洁的 Git 分支名环境变量配置# ~/.zshrc 或 ~/.bashrc# API 配置exportANTHROPIC_API_KEYyour-api-key# 默认模型exportCLAUDE_MODELclaude-sonnet-4-20250514# 默认温度exportCLAUDE_TEMPERATURE0.7# 日志级别exportCLAUDE_LOG_LEVELinfo# 自定义端点代理exportANTHROPIC_BASE_URLhttps://your-proxy.com# 代理设置exportHTTP_PROXYhttp://proxy.example.com:8080exportHTTPS_PROXYhttp://proxy.example.com:8080工作流集成#!/bin/bash# code-review.sh - 代码审查工作流echo 开始代码审查...# 获取变更文件CHANGED_FILES$(gitdiff--name-only HEAD~1)forFILEin$CHANGED_FILES;doecho\n 审查文件:$FILEclaude--system你是代码审查专家\--context$FILE\审查这个文件指出问题和改进建议doneecho\n✅ 审查完成#!/bin/bash# auto-doc.sh - 自动生成文档PROJECT_ROOT$(pwd)# 生成 API 文档find$PROJECT_ROOT/src/api-name*.js|whilereadFILE;doDOC_FILE${FILE%.js}.mdclaude--context$FILE\为这个 API 文件生成详细的 Markdown 文档\$DOC_FILEecho 生成文档:$DOC_FILEdone常见问题与技巧常见问题Q: 如何切换不同的模型# 临时切换claude-mclaude-3-opus-20240229复杂问题# 永久切换claude configsetmodel claude-3-opus-20240229Q: 如何处理大型文件# 限制上下文行数claude --context-lines200--contextlarge-file.js分析这个文件# 分段处理head-500large-file.js|claude分析前 500 行Q: 如何保存对话历史# 方法 1: 使用 /save 命令交互模式/save conversation.json# 方法 2: 重定向输出claude chat问题output.txt21# 方法 3: 使用 --output 选项claude--outputsession.log chatQ: 如何处理超时或网络问题# 设置更长的超时exportCLAUDE_TIMEOUT120000# 毫秒# 使用代理exportHTTP_PROXYhttp://your-proxy:port实用技巧1. 快速原型开发claude创建一个 Node.js CLI 工具支持以下命令 - init: 初始化项目 - build: 构建项目 - deploy: 部署到服务器 使用 commander.js包含完整的项目结构2. 代码转换# 语言转换claude将这段 Python 代码转换为 TypeScript--contextscript.py# 风格转换claude将这段代码从回调风格转换为 Promise 风格3. 学习助手# 概念解释claude用简单的比喻解释 React 的 Virtual DOM# 学习路径claude我想学习 Go 语言后端开发给我一个 3 个月的学习计划# 代码演练claude给我一个 Rust 所有权概念的小测验4. 调试助手# 错误分析claude这个错误是什么意思TypeError: Cannot read property x of undefined# 修复建议claude这段代码有 bug请帮我找出问题$(catbuggy.js)命令速查表# 基础命令claude# 启动交互模式claude问题# 带初始提示启动claude chat# 显式聊天模式claude complete代码# 代码补全claude config list# 查看配置# 常用选项-m,--modelname# 指定模型-t,--temperaturen# 设置温度--max-tokensn# 最大 token 数-s,--systemprompt# 系统提示词-c,--contextpath# 添加上下文-f,--filepath# 从文件读取--json# JSON 输出--no-stream# 禁用流式输出# 配置管理claude config getkey# 获取配置claude configsetkeyvalue# 设置配置claude configunsetkey# 删除配置claude config reset# 重置配置claude config path# 配置文件路径# 实用组合catfile.js|claude解释这段代码# 管道输入claude--contextsrc/分析项目# 目录上下文claude-mopus-t0.3生成代码# Opus 低温度gitdiff|claude生成提交信息# Git 集成总结Claude Code CLI 是一个强大的命令行 AI 助手掌握其命令和选项能极大提升开发效率claude/claude chat日常对话和代码问答的主力工具claude complete代码补全适合集成到编辑器工作流claude config灵活配置定制个人偏好结合 Shell 别名、管道操作和自动化脚本可以构建高效的 AI 辅助开发工作流。