Claude Code CLI 使用完整指南
Claude Code CLI 使用指南
Claude Code 是 Anthropic 官方的命令行 AI 編程助手,像在終端里有一個懂你整個代碼庫的高級工程師。
一、安裝
1.1 安裝 Claude Code CLI
npm install -g @anthropic-ai/claude-code
1.2 驗(yàn)證安裝
claude --version
1.3 配置 API(二選一)
方式一:使用 Anthropic 官方 API(推薦,功能最完整)
# 設(shè)置 API Key(從 https://console.anthropic.com 獲?。? set ANTHROPIC_AUTH_TOKEN=sk-ant-xxx # Windows CMD $env:ANTHROPIC_AUTH_TOKEN="sk-ant-xxx" # Windows PowerShell export ANTHROPIC_AUTH_TOKEN=sk-ant-xxx # Linux/Mac
方式二:使用 DeepSeek 兼容接口(便宜,你已經(jīng)在用)
# Windows PowerShell $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>" $env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
二、基本用法
2.1 啟動方式
# 進(jìn)入項(xiàng)目目錄后直接啟動(交互模式) cd /path/to/your-project claude # 或者在任意目錄指定工作區(qū) claude --workspace /path/to/your-project
啟動后進(jìn)入交互 REPL 界面,可以連續(xù)對話。
2.2 單次命令模式(-p)
# 一次性問一個問題,不進(jìn)入 REPL claude -p "解釋一下這個項(xiàng)目是做什么的" # 把結(jié)果輸出到文件 claude -p "列出所有 TypeScript 文件" > files.txt # 在管道中使用 cat error.log | claude -p "分析這些錯誤日志,告訴我根因"
2.3 常用參數(shù)一覽
| 參數(shù) | 作用 | 示例 |
|---|---|---|
-p "提示詞" | 單次問答模式(非交互) | claude -p "總結(jié) git diff" |
--workspace <路徑> | 指定工作區(qū)目錄 | claude --workspace ../other-project |
--allowedTools "<工具>" | 限制可用工具 | claude --allowedTools "Read,Grep" |
--model <模型> | 指定模型 | claude --model claude-sonnet-4-6 |
--max-turns <N> | 限制交互輪數(shù) | claude --max-turns 5 |
--verbose | 顯示詳細(xì)日志 | claude --verbose |
--continue | 繼續(xù)上次對話 | claude --continue |
--resume <ID> | 恢復(fù)指定會話 | claude --resume abc123 |
--help | 查看完整幫助 | claude --help |
2.4 交互模式下的操作
進(jìn)入交互模式后: > 輸入問題或指令,按 Enter 發(fā)送 > 連續(xù)按兩次 Enter → 換行 > /help → 查看所有命令 > /clear → 清空當(dāng)前會話 > /compact → 壓縮會話上下文(節(jié)省 token) > /model → 切換模型 > /permissions → 查看/修改權(quán)限 > /status → 查看當(dāng)前狀態(tài) > /logout → 登出 > Ctrl+C → 中斷當(dāng)前操作 > exit 或 /exit → 退出
三、核心能力
3.1 代碼理解與問答
# 理解項(xiàng)目結(jié)構(gòu) claude -p "這個項(xiàng)目的目錄結(jié)構(gòu)是什么樣的?每個文件做什么?" # 理解代碼邏輯 claude -p "src/commands/gitCommit/index.ts 的 loadCommitFormat 函數(shù)做了什么?三級優(yōu)先級是什么?" # 找代碼位置 claude -p "DeepSeek API 調(diào)用邏輯在哪個文件?給我路徑和行號"
3.2 代碼修改與生成
# 添加新功能 claude -p "在 gitCommit 命令中新加一個選項(xiàng):'僅生成不看結(jié)果',跳過彈窗直接使用 AI 生成的提交信息提交" # 修復(fù) Bug claude -p "修復(fù) src/logger.ts 中時間戳格式不對的問題,應(yīng)該是 YYYY-MM-DD HH:mm:ss" # 重構(gòu) claude -p "把 src/commands/ 下三個命令的公共邏輯提取成一個共享函數(shù)"
3.3 Git 操作
# 查看變更 claude -p "查看最近的 git 提交記錄,總結(jié)主要變更" # 生成 commit message claude -p "分析 git diff 的變更內(nèi)容,按照約定式提交格式生成中文 commit message" # 創(chuàng)建 PR claude -p "基于當(dāng)前分支的變更,創(chuàng)建一個 PR 描述"
3.4 代碼審查
# 審查 PR diff git diff main | claude -p "審查這些代碼變更,檢查是否有安全問題、性能問題或邏輯錯誤" # 審查當(dāng)前修改 claude -p "審查當(dāng)前 git diff,逐條報告不合規(guī)項(xiàng)"
3.5 文檔生成
# 生成 API 文檔 claude -p "根據(jù) src/deepseek.ts 的代碼生成函數(shù)接口文檔,markdown 格式" # 生成 README claude -p "根據(jù) package.json 和 src/ 下的所有代碼,更新 README.md"
四、配置與定制
4.1 全局配置文件
位置:~/.claude/settings.json
{
"model": "claude-sonnet-4-6",
"theme": "dark",
"autoCompact": true,
"permissions": {
"allow": [
"Bash(npm test:*)",
"Bash(npm run build:*)"
],
"deny": [
"Bash(git push --force:*)",
"Bash(rm -rf:*)"
]
}
}4.2 項(xiàng)目級約束:CLAUDE.md
位置:項(xiàng)目根目錄 CLAUDE.md(你已經(jīng)在 Wingman 項(xiàng)目中用了)
# 項(xiàng)目約束 ## 目錄結(jié)構(gòu) - 每個命令單獨(dú)放在 src/commands/<命令名>/index.ts 下 ## Git 提交信息格式 - 標(biāo)題:約定式提交(feat/fix/refactor/docs/chore),包含作用域 - 正文:簡短要點(diǎn)列出關(guān)鍵變更 - 全篇中文,300 字以內(nèi) ## 編碼規(guī)范 - 共享工具放在 src/ 根目錄 - 每個命令關(guān)鍵節(jié)點(diǎn)用 log() 輸出日志
Claude Code 啟動時會自動讀取 CLAUDE.md,并作為 system prompt 的一部分——這正是規(guī)范驅(qū)動開發(fā)(SSD)的核心實(shí)踐:把團(tuán)隊(duì)規(guī)范編碼進(jìn) AI 的約束。
4.3 環(huán)境變量速查
| 變量 | 作用 | 你的設(shè)置 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | API 鑒權(quán) | DeepSeek API Key |
ANTHROPIC_BASE_URL | API 地址 | https://api.deepseek.com/anthropic |
ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 模型映射 | deepseek-v4-pro |
ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 模型映射 | deepseek-v4-pro |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 模型映射 | deepseek-v4-flash |
CLAUDE_CODE_EFFORT_LEVEL | 思考深度 | max / high / medium / low |
五、實(shí)戰(zhàn)工作流示例
5.1 日常開發(fā)工作流
# 早晨:快速回顧昨天做了什么 cd /path/to/your-project claude -p "查看 git log 最近一天的提交,總結(jié)要點(diǎn)" # 開發(fā)中:讓 Claude 幫忙寫代碼 claude -p "給 gitCommit 命令加一個參數(shù) --dry-run,只生成提交信息不實(shí)際提交" # 提交前:生成規(guī)范的 commit message claude -p "分析暫存區(qū)的變更,生成約定式提交格式的中文提交信息" # 下班前:生成周報草稿 claude -p "根據(jù) git log 最近一周的提交記錄,生成周報草稿"
5.2 代碼審查工作流
# 審查自己的代碼 claude -p "審查 src/commands/gitCommit/index.ts,檢查: 1. 是否有硬編碼密鑰 2. 錯誤處理是否完整 3. 函數(shù)是否過長 4. 命名是否清晰 逐條給出結(jié)果(PASS/FAIL + 說明)" # 審查 PR git fetch origin git diff origin/main...HEAD | claude -p "審查這些改動,關(guān)注安全性和邊界條件"
5.3 學(xué)習(xí)與研究
# 快速理解源碼 claude -p "閱讀 src/deepseek.ts,畫出函數(shù)調(diào)用關(guān)系圖,用 mermaid 格式" claude -p "解釋 src/commands/gitCommit/index.ts 中 performCommit 函數(shù)的 git 操作邏輯" # 技術(shù)調(diào)研 claude -p "TypeScript 中 stdin/stdout 作為 JSON-RPC 傳輸層的最佳實(shí)踐是什么?結(jié)合 MCP 協(xié)議給示例代碼"
六、與 VSCode 的區(qū)別
你平時在 VSCode 中用 Claude Code 插件(你當(dāng)前的模式),與 CLI 的區(qū)別:
| 維度 | VSCode 插件模式 | CLI 模式 |
|---|---|---|
| 啟動方式 | 側(cè)邊欄 / Ctrl+Shift+P | 終端敲 claude |
| 編輯文件 | 自動應(yīng)用到編輯器 | 通過 Edit 工具修改,或在終端看 diff |
| 上下文 | 跟隨 VSCode 工作區(qū) | 跟隨當(dāng)前目錄 |
| 權(quán)限控制 | VSCode 權(quán)限體系 | CLI 權(quán)限體系(可配) |
| 適用場景 | 邊看代碼邊對話、IDE 內(nèi)操作 | 終端環(huán)境、自動化腳本、CI/CD 集成 |
| 輸出 | VSCode 面板 | 終端標(biāo)準(zhǔn)輸出 |
兩者共享相同的 CLAUDE.md、settings.json、conversation 存儲。你可以隨時切換。
七、你現(xiàn)在就用起來
步序 1:安裝
npm install -g @anthropic-ai/claude-code
步序 2:配置 DeepSeek 兼容接口(已有環(huán)境變量)
# 在 PowerShell 中(建議寫入 PowerShell Profile 永久生效) $env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN = "<你的 DeepSeek API Key>" $env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"
步序 3:跑第一個命令
cd /path/to/your-project claude -p "這個項(xiàng)目的目錄結(jié)構(gòu)和核心功能是什么?"
八、常用命令速查卡
# 安裝 npm install -g @anthropic-ai/claude-code # 交互模式 claude # 單次問答 claude -p "你的問題" # 指定工作區(qū) claude --workspace /path/to/project # 審查代碼 git diff | claude -p "審查這些變更" # 生成提交信息 claude -p "根據(jù)當(dāng)前 git diff 生成約定式提交信息" # 解釋代碼 claude -p "解釋 src/xxx.ts 的核心邏輯" # 限制工具(只讀模式) claude --allowedTools "Read,Grep,Glob" -p "分析項(xiàng)目結(jié)構(gòu)" # 繼續(xù)上次會話 claude --continue # 查看版本 claude --version # 查看幫助 claude --help
到此這篇關(guān)于Claude Code CLI 使用完整指南的文章就介紹到這了,更多相關(guān)Claude Code CLI 使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

Claude Code cli 及vscode版本的各種命令參考手冊(最新推薦)
Claudede是 Anthropic 提供的一個命令行接口,用于與 Claude AI 交互,它提供了超過70個內(nèi)置命令和綁定技能,這篇文章給大家介紹了Claude Code cli 及vscode版本的各種命令參2026-05-21
Claude Code 是 Anthropic 官方推出的命令行工具,讓開發(fā)者能在終端中與 Claude 進(jìn)行交互,本文就來詳細(xì)的介紹一下Claude Code CLI命令使用,感興趣的可以了解一下2026-04-13



