Claude Code 命令行工具的安装、配置与使用指南
Claude是Anthropic推出的专注于安全性与工程可靠性的AI语言模型系列，包含Opus、Sonnet和Haiku三个层级模型，分别针对不同复杂度任务。其计费基于token，代码场景token消耗较大。 Claude Code是Claude的官方命令行工具，提供代码理解、Git变更分析、多轮交互等核心能力，支持CLI命令式和REPL交互式两种使用模式。安装需Node.js环境，在VSCode
·
一、简要介绍
1、Claude 是什么
Claude 是由 Anthropic 推出的大型语言模型（Large Language Model, LLM）系列，面向复杂推理、代码理解、写作生成与多轮对话等任务，强调安全性、可控性与工程可靠性。
Claude 的设计目标并非单纯追求“参数规模最大”，而是提供：
- 稳定的长上下文推理能力
- 对复杂指令的高遵循度
- 面向真实工程场景的可控输出
（1）模型体系（以 Claude 4.x/4.5 为例）
Claude 采用多型号分层策略，以覆盖不同性能与成本需求：
| 模型 | 定位 | 典型用途 |
|---|---|---|
| Opus | 最强推理能力 | 复杂系统、架构设计 |
| Sonnet | 能力与成本平衡 | 日常开发、分析 |
| Haiku | 快速、低成本 | 自动化、批量任务 |
（2）token和计费
token（令牌）是模型内部计费与处理的最小文本单元。
- 英文通常
1 token ≈ 4 个字符或 0.75 个单词- 中文通常
1 token ≈ 1 个汉字- 代码 token 密度很高（符号、缩进都会算）
1M tokens = 1,000,000 个 token，这是 Claude 计费的基本单位，不是一次请求的上限，而是累计消耗量。为什么 Claude Code 特别 “烧 token” ？
1️⃣ 代码 token 密度极高：符号、括号、缩进、注释、路径、配置文件等
2️⃣ 隐式输入极多：当前命令、选中文件、自动读取的相关文件、Git diff、CLAUDE.md、历史上下文等
3️⃣ Agent 会反复消耗 output tokens：拆步骤、解释理由、给建议、再生成代码等以 Sonnet 为例：
- 任务：输入 200k tokens、输出 100k tokens
- 成本：输入：0.2 × $3 = $0.6、输出：0.1 × $15 = $1.5、单次 ≈ $2.1
Opus 情况更极端，10–20 次重任务就能上百美元。
Agent 连跑几小时，$1000 非常正常。
| 内容 | token 数量 |
|---|---|
| 中文 1000 字 | ≈ 1000 tokens |
| 英文 A4 一页 | ≈ 500–700 tokens |
| 100 行 Python 代码 | ≈ 800–1500 tokens |
| 中型项目一次全仓扫描 | 50k – 300k tokens |
2、Claude Code 是什么
Claude Code是 Anthropic 官方推出的命令行（CLI）编程代理工具（全名通常是 @anthropic-ai/claude-code），它可以在你的终端里直接运行，帮你修改代码、执行命令。强调代码感知、上下文理解与工程决策能力。
⚠️ 注意：这是一个付费工具，它会消耗你的 Anthropic API 额度。你需要绑定信用卡才能使用。
（1）核心能力
| 核心能力 | 详细描述 | 特点与优势 | 使用场景 |
|---|---|---|---|
| 代码上下文理解（Context-aware） | 可以直接读取文件、目录或 Git diff 作为输入；理解函数、模块、调用关系、代码结构；基于工程语义提供分析、解释或改进建议 | 不是逐行解释，而是“像资深工程师一样理解整个模块”；理解工程结构、依赖和逻辑 | 代码理解、函数/模块分析、模块间调用分析、代码优化建议 |
| Git 变更分析（Diff-native Reasoning） | 基于 --diff 读取工作区改动；分析修改内容、潜在风险和设计意图；提供优化建议或重构方案 |
直接面向工程实践，能够理解变更上下文与设计意图；不仅分析文本，而是理解变更背后的工程逻辑 | 代码审查、变更风险分析、重构方案建议、Pull Request 审查 |
| 多轮上下文感知（Session-aware） | 交互式会话模式可累积上下文，多轮推理；CLI 调用模式上下文独立，适合自动化与脚本 | 既能“像人一样思考”，又能“像工具一样可控”；可在会话内连续提问和推理 | 复杂问题拆解、逐步重构、架构设计讨论、多轮代码优化 |
| 指令遵循与工程化输出（Instruction-following） | 输出结构化、面向工程，避免无关扩展；高度遵循指令 | 输出结果可直接用于决策或集成到工作流；可生成审查报告或优化建议 | 代码优化建议、审查报告生成、自动化文档、结构化分析 |
| 工程决策能力（Decision-oriented） | 不只是生成代码，更能判断合理性、识别潜在 bug；提供可行性分析、性能/可维护性取舍建议 | 输出基于工程判断，而非单纯语言生成；能做风险评估和取舍建议 | 代码审查、系统设计建议、重构决策、风险分析 |
| 可嵌入自动化流程（Automation-ready） | CLI 支持单次调用，Token 成本可控；可集成 CI/CD、批量分析、代码审查等流程 | 在团队与项目中可直接作为工具链组件使用；支持脚本化调用 | CI/CD 审查、批量代码分析、自动化工具链、代码质量检查 |
（1）使用模式（CLI命令行 + REPL交互式）
从使用方式上，Claude Code 表现为两类行为：
交互式会话：多轮推理、上下文累积命令行执行：一次性调用、无历史依赖两者调用的是同一模型，区别在于上下文生命周期。
CLI（Command Line Interface，命令行交互）
- 定义：CLI 是 一次性、非交互式的模型调用方式，遵循典型的命令执行范式：一次命令 → 一次执行 → 输出结果 → 进程结束
- 示例：
claude --model haiku "解释这段正则"- 上下文策略：最小上下文（Minimal Context）
CLI 的上下文构建遵循最小必要原则：仅包含：当前命令文本、显式指定的文件 / diff / 参数、必要的系统级提示、不继承历史会话、不自动扩展上下文、Agent 行为默认不触发
总结：CLI 的上下文是显式、短生命周期、可完全预测的。REPL（Read–Eval–Print Loop，交互式会话）
- 定义：REPL 是 常驻的、多轮交互式模型会话，遵循循环式交互模型：启动 → 输入 → 评估 → 输出 → 等待下一轮输入
- 示例：
claude或claude --model opus- 上下文策略：累积上下文（Accumulated Context）
REPL 的上下文是持续累积且动态扩展的，包括但不限于：历史全部对话内容、Claude 生成的中间推理与结论、已读取文件的摘要或内部表示、当前隐含的任务目标与约束
总结：REPL 的第 N 轮交互，永远比第 1 轮更“重”。
二、安装指南
以下是 Windows 系统下的详细安装步骤（基于你之前的环境）：
- 阶段零：准备“门票” (最重要，否则后续无法使用)
Claude Code 必须使用 API 付费额度，这与网页版 Claude Pro 会员（$20/月）不互通。
- 登录后台：访问 Anthropic Console 并登录。
- 绑定支付方式：点击
Settings->Billing，绑定 Visa 或 Mastercard 信用卡。- 充值 (Pre-paid)：点击
Claim Credits或Add Funds。
- ⚠️ 注意：必须先充值（例如充 $5 美元），余额为 0 时无法使用。
- 阶段一：安装基础环境 (Node.js)
Claude Code 是基于 Node.js 运行的，所以必须先安装 Node。
- 下载：访问 Node.js 官网，下载左边的 LTS 版本 (长期支持版)。
- 安装：运行下载的
.msi文件，一路点击Next(下一步) 直到完成。- 验证：：安装完后，必须关闭所有旧的 CMD/终端窗口，重新打开一个新的。
- 检查是否已安装：输入
node -v，如果出现类似v18.x.x或v20.x.x的版本号，即为成功。- 阶段二：安装 Claude Code
- 管理员权限打开终端并执行安装命令：
npm install -g @anthropic-ai/claude-code
- npm：Node 的包管理器。
- -g：表示全局安装（Global），这样你在任何文件夹下都能用 claude 命令。
- 如果卡住不动（国内网络问题），请先运行这个换源命令，再重新运行上面的安装命令：
npm config set registry https://registry.npmmirror.com- 阶段三：启动与授权
- 进入项目文件夹：
cd /d D:\models\project- 运行 Claude：
claude- 交互授权流程：
- 终端提示：
Press Enter to open the browser...- 动作：按一下键盘上的 回车键 (Enter)。
- 网页操作：
- 浏览器会自动弹出一个网页。
- 网页会显示你的账号，点击绿色的 “Allow Access” (允许访问) 按钮。
- 网页提示 “Success” 后，可以关闭网页。
- 回到终端：你会看到屏幕上显示
Welcome to Claude Code!，并且出现一个等待输入的提示符>。🎉 至此，安装全部完成！
🚨 常见报错急救包 (遇到问题看这里)
- 问题 1：红色报错 “running scripts is disabled on this system”
- 原因：Windows PowerShell 的安全策略拦截。
- 解决：在管理员 PowerShell 中执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，(输入Y确认)- 问题 2：报错 “Connection timeout” 或 “Network error”
- 原因：国内网络无法连接 Anthropic 服务器。
- 解决：开启梯子/VPN，并确保你的终端走了代理。
- 问题 3：报错 “402 Payment Required” 或 “Credit balance is too low”
- 原因：API 后台没钱了。
- 解决：回到 [阶段零]，去 Console 后台充值余额。
三、使用指南
VSCode快速启动终端Terminal：
Ctrl + J
1、启动方式
是否进入 REPL 的唯一判据：会话状态是否被保留并用于下一轮推理。
【REPL】交互式会话模式：claude
"""含义：
启动 Claude Code 的交互式 REPL
使用当前默认模型（通常是 Sonnet 4.5）
自动加载当前目录作为项目上下文
自动读取 CLAUDE.md（如果存在）
这是最常用、最安全的启动方式。"""
【REPL】交互式会话模式 + 指定模型：claude --model opus（或sonnet、haiku）
或切换模型
【CLI】命令行执行模式：claude “解释这个函数”
【CLI】命令行执行模式：claude src/matcher.py
【CLI】命令行执行模式：claude --diff
# 一次性命令调用（CLI）
claude "解释 src/matcher.py 中的 match_keypoints 函数"
"""特点：
不进入 REPL
一次请求，一次响应
token 消耗可控
非常适合脚本化或快速查询"""
# 指定分析文件
claude src/matcher.py
或
claude "只分析 src/image_matcher.py，不要扫描其他文件"
"""工程建议：
始终显式限定文件范围
避免默认全仓扫描"""
# 基于 Git diff 工作
claude --diff
"""含义：
只关注当前 Git 工作区改动
不扫描未修改文件
成本显著低于全仓分析
推荐用于代码 review / 局部修改。"""
2、核心命令
初始化代码库文档：/init
选择模型：/model（或/model opus切换模型）
切换不同的claude模型。适用于本次会话以及后续的claude代码会话。对于其他/之前的模型名称，请使用“-model”进行指定。
1. Sonnet 4.5 —— Default（推荐）
定位：工程与算法工作的主力模型
成本：
输入：$3 / 1M tokens
输出：$15 / 1M tokens
特点：
推理能力与成本的最佳平衡
代码理解、局部修改、算法讨论表现稳定
适合 90% 的 Claude Code 使用场景
结论：这是 Claude Code 的“标准配置”，也是官方推荐选项。
######################################################
2. Opus 4.5 —— 最强但最贵
定位：高复杂度、长上下文、重推理任务
成本：
输入：$5 / 1M tokens
输出：$25 / 1M tokens
"""
特点：
更强的跨文件理解能力
更复杂的规划与重构能力
对 Agent 行为、全仓分析更激进
风险点（非常关键）：
高 token 消耗
自动上下文膨胀
快速打满月度 cap
【例如】claude提示：429 已达到费用限制 ($1000)，将在 2808 分钟后重置
429：标准的 HTTP 限流状态码，表示请求被拒绝，原因是额度已用尽。
已达到费用限制 ($1000)：当前账号或组织在当前计费周期内的 Claude 使用费用已累计到 $1000 上限。
将在 2808 分钟后重置：额度会在 2808 分钟（约 46.8 小时）后自动恢复，可再次调用 Claude。
【备注】
达到 $1000 费用上限后，并不是所有 Claude 能力都会立刻全部停用。
429 + $1000 cap 命中的是某一类使用通道，而不是所有 Claude 入口。
Claude 的使用至少分为三类通道，它们的计费、限流策略是分离的。
对不同产品通道与能力进行了分级限流与自动降级：
降级模型（Opus → Sonnet → Haiku）
限制上下文长度
降低推理深度
禁用 Agent / 工具调用
"""
结论：只应在明确、短时、必要的复杂任务中手动使用。
######################################################
3. Haiku 4.5 —— 低成本高速模型
定位：轻量级交互与查询
成本：
输入：$1 / 1M tokens
输出：$5 / 1M tokens
特点：响应极快、成本最低、推理深度有限
不适合的场景：多文件代码理解、架构级修改、算法推导
结论：适合查语法、看单个函数、快速解释一段代码
中断当前输入或模型生成：Esc
1️⃣ 中断当前输入（最常见、最重要）
- 在交互式会话中：
- 当正在输入一行较长内容
- 误输入命令、粘贴错误文本
- 按下：
Esc- 行为结果：
- ❌ 当前输入被取消
- ✔ 不发送给模型
- ✔ 会话仍然保持
这相当于：撤销本轮输入，但不结束会话
2️⃣ 中断模型生成（Stop Generation）
- 当 Claude 正在输出内容时
- 误提交
- 输出明显跑偏
- 输出过长
- 已经得到想要的答案
- 按下
Esc- 行为结果：
- 立即停止当前生成
- 不再消耗 token
- 会话继续存在
- 已生成内容保留在终端中
3️⃣ 返回会话输入态（安全返回点）
在部分 Claude Code 版本中（包括 v2.x）：
- Esc 会将状态强制拉回到主输入提示符
- 清理未完成的内部状态（如多行输入）
可视为：软 reset 当前轮次，不 reset 会话上下文。
退出对话：/exit【或 Ctrl + C / Ctrl + D】
3、查看命令
查看版本：claude --version
查看帮助：/help
查看配置参数：/config
查看系统状态：/doctor
查看Token使用情况：/cost
4、其他命令
清除对话记录，并释放存储空间：/clear
清除对话记录，但保留摘要内容：/compact
编辑项目记忆：/memory
查看项目记忆：/memory view
有“AI”的1024 = 2048，欢迎大家加入2048 AI社区
更多推荐
16
0- 0
已为社区贡献2条内容
所有评论(0)