2026年玩转 Claude Code CLI | 1、安装配置 & 基本使用

玩转 Claude Code CLI | 1、安装配置 & 基本使用Anthropic 推出的 基于 终端 的 AI 编码工具 允许用户通过 命令行界面 CLI 发送 自然语言 与 Claude AI 进行交互 完成编码 调试 代码分析等一系列开发任务 智能代码分析 深度理解代码结构和逻辑 自动代码生成

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



Anthropic 推出的,基于 "终端 " 的 "AI编码工具 ", 允许用户通过 "命令行界面 (CLI) " 发送 "自然语言 " 与 Claude AI 进行交互,完成编码、调试、代码分析等一系列开发任务。

  • 智能代码分析:深度理解代码结构和逻辑。
  • 自动代码生成:基于自然语言描述生成高质量代码。
  • 代码重构优化:自动重构和性能优化。
  • 自动化任务执行:批量处理和脚本化操作。
  • Git 流程辅助:智能 Git 操作和代码审查。
  • 工具集成:与各种开发工具无缝集成。

1.3.1. 100万 Token 上下文窗口

Claude Sonnet 4 在 API 端支持高达 1,000,000,000 Token 的上下文窗口,无需分片便可完整加载上万行代码或数百个文件,实现对大型仓库的 "一次性通读"。

  • 全局索引 & 智能检索 】在项目初始化阶段,CC 会对整个代码库进行一次 "深度索引 ",不仅仅是建立一个文件和函数的列表,更是利用 "嵌入(Embeddings) " 技术将代码块、函数、类、甚至是注释转换成高纬度的数学向量 (向量化 ),创建了一个代码的 "语义索引"。
  • 按需加载 & 上下文填充 】当你提出一个需求时,如 "重构用户登录模块",CC 会先分析你的指令,然后利用前面建立的语义索引,检索出与 "用户登录" 这个概念最相关的所有的代码片段 (可能包含:前端组件、后端API路由、数据库模型、认证服务等)。只有这些 "最相关、最高优先级 " 的代码才会被精准地加载到 "工作内存 " (上下文窗口) 中。
  • 滑动窗口 & 摘要记忆 】对于超出单次上下文容量的超大型任务,CC 会利用类似 "滑动窗口 " 的机制。在处理完一部分代码后,会生成一个 "高度精炼的技术摘要 ",在处理下一部分代码时,将这个摘要作为 "前情提要" 放入上下文中。通过这种方式,CC 能保持对整个任务链的连贯理解,即使物理上无法一次性看到所有代码。

😄 得益于超长的上下文窗口:

  • 代码生成 :能洞察项目中已有的设计模式与编码规范,产出风格统一、无缝集成的 "原生" 代码
  • 代码重构:能精准执行跨越多文件的全局性修改,如批量更新API调用。
  • 复杂BUG:能进行深度分析,完整追踪跨模块的调用链,准确定位问题的根源。

1.3.2. Agent 架构 & 工作流自动化

Claude Code 引入了分布式智能体 (Sub-Agent) 系统,允许针对分析、生成、测试、合并等不同环节并行部署独立智能体。

当你下达一个复杂指令,如 "实现一个用户个人资料页的新功能",任务处理链路:

主Agent

先扮演 "项目经理" 的角色,将这个宏大任务分解为一系列更小的、可执行的子任务,如:

  • 任务一 (后端): 设计并创建数据库 schema。
  • 任务二 (后端): 编写获取和更新用户资料的 API 端点。
  • 任务三 (前端): 创建用户资料页面的 UI 组件。
  • 任务四 (前端): 连接 UI 组件与后端 API。
  • 任务五 (测试): 编写单元测试和集成测试。

专业子Agent

主Agent 会将这些子任务委派给预设的、拥有不同专长的子Agent,比如:

  • backend-dev-agent: 专门负责处理数据库和 API 相关任务。
  • frontend-dev-agent: 精通 React/Vue,负责 UI 开发。
  • qa-agent: 负责编写和运行测试。

并行与协作

子 Agent 可以并行工作 (如前后端同时开工),并通过一个 共享的"状态板" 或内部通信协议来同步进度。如:当前端需要 API 时,它会等待后端代理完成并提供 API 定义。

🤔 又比如:实现 Issues-to-PR 的自动化流程

  • 需求解析 :整个流程始于一个项目管理工具 (如Github Issues) 中的新需求,主Agent 首先会 "阅读" 这个 issue,理解其标题、描述、标签和评论,将其转化为明确的开发目标。
  • 规划与执行:接着,主Agent进行任务分解,并将其分配给相应的子Agent团队开始开发。
  • 代码提交与审查:开发完成后,git-agent 会负责将代码格式化、创建有意义的 commit message,并新建一个 Pull Request (PR)。它甚至可以根据 CLAUDE.md 文件中的规范,自动在 PR 描述中链接相关的 Issue。
  • CI/CD 与自我修正:PR 创建后,会自动触发 CI/CD 流水线 (如Github Actions),如果测试失败,qa-agent 会被激活,分析失败日志,并尝试自动修复代码,然后再次提交,直到测试通过。
  • 等待开发者审批:最终,一个测试通过、描述清晰的 PR 会被呈现在开发者面前,等待最终的审核和合并。

1.3.3. 多层防护机制

  • 用户确认 :最基础也是最重要的一道防线,默认情况下,CC 在执行如何具有 "副作用 " 的操作前 (如:修改文件、执行shell命令、安装依赖等) 都会在终端明确列出要执行的命令,并暂停执行,等待用户的明确批准 (通常是输入y或n),即用户具有 最终的否决权。对于有经验的用户,也可以通过添加 --yes 或类似标志来跳过确认,但这也需要用户主动选择。
  • 沙箱环境:对于一些风险较高的操作,尤其是在云端或多租户环境中,代码的执行可以在一个隔离的沙箱 (受限容器) 中进行,无法访问宿主操作系统的敏感文件或网络。即使代码存在恶意或破坏性行为,其影响也被严格限制在沙箱内部。
  • 显式控制 & 权限配置 :项目管理员可通过 CLAUDE.md 配置文件为 AI 的能力设定精细的权限策略。如:文件系统访问权限 -明确指定AI可读写的目录和文件,禁止访问的目录。命令黑白名单 -允许npm install,拉黑高危命令 (如rm -rf/)。网络访问控制-限制 AI 只能访问特定的 API 端点或域名,防止数据泄露。

😄 不开源 (隔壁Codex开源) ,要钱, 而且还 "不便宜"CC 采用 "按Token计费 (额度) ",支持 个人订阅团队/企业 、或 API按量计费,官方定价:

🤡 Claude 号称 "封号斗罗",对环境要求苛刻,账号封禁频率极高:

  • 需要"科学"上网 :对 IP质量 要求较高,香港还不行,使用时需避免频繁切换IP地址。
  • 邮箱:需使用 Gmail、Outlook等海外邮箱,避免使用 、163等国内邮箱。
  • 手机验证:需支持接收国际短信的手机号码,这个可以找稳定的"接码平台"解决。
  • 支付方式:需海外虚拟/实体信用卡。
  • 更推荐的订阅方式美区Apple ID 内购Google Play 订阅

🤷‍♀️ 然后,国内用户即便成功注册,并付费订阅 Claude Pro,也是有可能被封的,见过论坛有人吐槽开通不到一个小时就被封,官方直接退款,没有任何解释。

🤷‍♀️ "专业事情交给专业的人 ",想用 CC 又懒得折腾的童鞋,建议找下 "靠谱 " 的 "国内镜像站 " 或 "第三方中转",然后买的时候注意下这几点:

  • "跑路" 风险:不要一次充太多 (月付>年付),跑路了亏损也能降到最低,按自己的实际用量购买,尽量找有售后保障的 (如按使用时间退款)。
  • "数据泄露"风险 :🤷‍♀️ 中转嘛,请求都经人家服务器,而数据是能 卖钱 的,保密性要求高的自己看着办。实在要用,建议找国内正规的大模型公司中转,如:GLM-4.5Kimi K2Qwen3-Coder 等,代码能力差点,但是安全性高一些。
  • "价廉不一定物美 ":😄 就挂羊头卖狗肉,说是 CC 官转 ,结果整个 "廉价" 模型。

2.2.1. 系统要求

  • 硬件:内存至少2GB (推荐4GB+),硬盘存储至少500MB (推荐1GB+)
  • 系统Windows 10 (版本1903+) 或 Windows 11、macOS 10.15 (Catalina) 或更高版本、Ubuntu 18.04+、CentOS 7+、Debian 10+、Fedora 30+。
  • 软件:Node.js 18+,Shell 推荐使用 Bash、Zsh 或 PowerShell。

2.2.2. 安装步骤

 

2.2.3. Claude 账号登录

😄 有 Claude 官方账号 且订阅了套餐的用户,先确认好是否开启 TUN 模式 (全局代理),未开启的话登录页可能无法正常跳转!确认开启无误后,再执行 claude 命令启动。接着会先让你选择 界面风格 ,这里直接用默认的 Dark (黑夜) 模式,回车后,选择账号登录的方式:

接着会自动打开一个网页,授权完,就能正常使用了。

2.2.4. 第三方中转

走 "第三方中转 " 的则需要配置下 "环境变量 " 和 "settings.json" 文件 (💡 部分中转站会提供一键配置的脚本)。

环境变量配置

Windows 用户 (PowerShell)

 

😄 没生效的话可以手动配:右键此电脑 → 高级系统设置 → 环境变量 → 系统变量 → 新建


Linux/macOS 用户

Settings 文件配置

创建 ~/.claude/settings.json 文件并配置 API 密钥:

配置完,执行 claude 命令后,可能会问你是否信任当前目录下的文件,直接回车,然后就可以开始耍了~

Claude Code CLI 的核心功能,提供了丰富的实时交互体验。

3.1.1. 启动

3.1.2. 文件操作

选中文件/文件夹

  • 直接拖拽: 将文件/文件夹从文件管理器拖拽到 CLI 输入框中,会自动插入路径。
  • 输入路径: 在消息中直接输入文件路径,我可以读取和操作该文件。
  • 使用 @ 符号: 输入 @ 然后选择文件。

粘贴图片/文件

  • Ctrl+V/Cmd+V/Alt+V: 直接粘贴剪贴板中的图片,会自动上传并显示,如:[Image #1]。
  • 拖拽图片: 将图片文件直接拖拽到输入框中。
  • 粘贴文件内容: 复制文件内容后用 Ctrl+Shirt+V 将多行文本粘贴到消息中。

3.1.3. 斜杠命令

3.1.4. CLAUDE.md

Claude Code CLI 的配置和上下文文件,用于存储持久的指令、偏好设置和项目特定规范,它允许开发者在不同的编程会话中保持一致的工作流程和编码标准。可放置在多个位置 (优先级从高到低):

  • 项目根目录:./CLAUDE.md
  • 项目 .claude 目录:./.claude/CLAUDE.md
  • 用户主目录:~/.claude/CLAUDE.md (Windows: C:Users你的用户名.claudeCLAUDE.md)

存在多个规则文件时,规则的处理方式:冲突按优先级,不冲突的全部合并。模板示例:

无需进入交互式聊天界面直接执行任务 ,这种模式特别适用于:构建脚本自动化工具、批处理任务、CI/CD管道、预提交钩子 (pre-commit hooks)。

3.2.1. 基础操作

  • :简写 -p,启用非交互模式的标记,执行后直接在终端输出结果而不进入交互界面,如:claude -p "分析代码"。
  • :简写 -c,继续最近的会话,如:claude -c。
  • :简写 -r,恢复特定会话,如:claude -r session-id。
  • :简写 -h,显示帮助信息,如:claude -h。
  • :简写 -v,显示版本号,如:claude -v。

3.2.2. 模型控制

  • :选择AI模型,如:claude -p "复杂分析" --model opus
  • :主模型过载时的备用模型,如:claude -p "任务" --fallback-model sonnet

💡 模型opus - 最强性能,复杂任务、sonnet - 平衡性能,日常使用、haiku - 最快速度,简单任务。

3.2.3. 输入输出控制

  • :输出格式,可选值:text ,、jsonstream-json,用于API集成、脚本处理。
  • :输入格式,可选值:text、stream-json,用于流式数据处理。
  • :包含部分消息块,用于实时流式输出。
  • :回显用户消息,用于消息确认。

使用示例:

 

3.2.4. 权限安全

:权限模式设置,可选值:

  • 默认 :采用交互式权限询问模式,安全优先,采用最保守的权限策略,每次操作都需要用户确认。可在 settings.json 中的 permissions 字段的 defaultMode 配置默认模式
  • acceptEdits:自动接受文件编辑权限,允许大多数普通文件编辑操作,但仍会对危险操作进行询问。适用于:需要Claude进行代码修改、重构或修复时。
  • acceptAll:自动接受所有权限请求,包括文件操作、命令执行、网络访问等所有权限。适用于:完全信任的环境下,需要Claude执行复杂自动化任务,最便利,但需谨慎使用 ❗️
  • deny:拒绝所有权限请求,仅限只读操作。适用于:只让Claude进行代码分析、审查而不进行任何修改。
  • plan:允许分析但不执行修改操作,可以读取和分析文件,但不能修改或执行命令。适用于:需要Claude分析问题并制定执行计划,但不立即执行。

:允许使用的工具,如:--allowed-tools "Bash,Edit,Read"。

:禁用的工具,如:--disallowed-tools "Web,Network"。

:跳过所有权限检查,谨慎使用,仅限沙盒环境使用。

使用示例:

 

3.2.5. 工作环境管理

  • :添加可访问目录,如:–add-dir ./src –add-dir ./tests
  • :使用特定会话ID,如:–session-id "team-project-uuid"
  • :创建会话分支,如:–fork-session –resume old-id

使用示例:

 

3.2.6. 扩展集成

  • :指定MCP配置文件路径,覆盖默认的MCP配置路径,允许为不同项目使用不同的MCP工具集。默认MCP配置文件位置:claude_desktop_config.json、项目级别:.claude/settings.local.json、用户级别:~/.claude/settings.local.json。如:claude –mcp-config /path/to/custom/mcp-config.json -p "使用自定义MCP工具"
  • :强制严格遵循MCP配置文件设置,禁止运行时动态添加MCP服务器,增强安全性,防止意外的工具访问,确保配置的一致性和可预测性。如:claude –strict-mcp-config -p "严格按照配置文件执行"。
  • :IDE集成模式,本质上是一个"上下文提示",用于告诉CC当前的开发环境和工作流程,以便它更好地适应你的工作方式,如:claude –ide vscode -p "设置TypeScript项目",CC可能会:建议安装VSCode TypeScript扩展、生成.vscode/settings.json 配置文件,以及推荐VSCode特定的调试配置。可选值除了 vscode 外,还有:cursor、neovim、emacs。

使用示例:

 

3.2.7. 调试诊断

  • :启用调试模式,提供最详细的内部信息,如:错误堆栈、异常详情、系统诊断信息等。
  • :启用详细日志输出,显示CC内部工作过程,如:命令处理、上下文构建、工具执行、API通信。

💡 Ubuntu 24.04和Windows系统上存在设置丢了这两个参数,内容没有输出到stderr的BUG。

3.2.8. 高级配置

  • 指定自定义设置文件的路径 ,覆盖默认settings.json配置,适用于:临时配置不影响全局设置、不同项目使用不同的配置策略。设置文件的层级结构:系统级:managed-settings.json、用户级:~/.claude/settings.json、项目级:./project/.claude/settings.json。如:claude –settings ./configs/prod-settings.json -p "生产部署"。
  • 添加临时系统提示词

使用示例:

 

3.2.9. "万金油"日常模板

小讯
上一篇 2026-04-03 19:58
下一篇 2026-04-03 19:56

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/224389.html