Claude Code 快速开始

安装

建议使用 智普GLM 套餐

• 安装并配置 API key
• Coding Tool Helper 统一管理与配置 Claude Code 等 CLI 工具的命令行助手
• CC Switch 对 Claude Code 等进行可视化配置的客户端工具

npm install -g @anthropic-ai/claude-code # 安装
claude --version # 检查当前版本
claude update # 升级到最新版本
npx @z_ai/coding-helper # 配置

权限模式

# 启动 claude，默认为 default，会有很多授权申请
claude
# 让 Claude 获得所有权限，跳过任何授权申请
claude --permission-mode bypassPermissions # 新版本的推荐写法
claude --dangerously-skip-permissions # 老版本的写法

可选模式：

• default — 只读 ask before every edit
• bypassPermissions — 跳过任何授权申请
• acceptEdits — 自由编辑 edit freely, ask for commands
• auto — 智能 Claude decides what is safe
• plan — 规划模式 research and propose, never touch files

建议使用 bypassPermissions，不然授权申请很频繁

修改默认模式：/config -> Default permission mode

工作目录

# 附加工作目录，默认只处理当前目录下的文件
claude --add-dir ../qtAi ../qtTest

用于跨模块修改、统一重构、对比分析

启动方式

claude           # 交互模式（默认）
claude -c        # 恢复最近会话（--continue），适合异常中断后恢复
claude -r        # 恢复指定会话（--resume），会弹出列表选择
claude -p "问题" # 非交互模式（--print），单次问答后退出，适合脚本集成

对话模式

• /plan：规划模式。规划再执行，大型修改、重构、多文件调整时使用
• /fast：极速模式。使用更快的模型输出，适合日常简单任务
• /clear：重置模式。清空上下文后重新开始，毫秒级重启，比退出重进快
• /btw：追加模式。对话中途追加信息，不打断当前流程；一般不需要
• /loop 5m 任务：循环模式。定时重复执行任务，适合轮询状态、定时检查
• /fast：快速模式，使用更快的模型，但能力较弱，适合简单任务

常用快捷键

通过命令 /keybindings 可自定义快捷键

• 双击 Esc：清空输入的内容；终端可能也支持 Ctrl + C/W
• !：直接执行 shell 命令，如 ! pwd
• /：匹配并执行命令，如 /help
• @：插入文件路径，会自动模糊匹配本地文件
• &：在后台执行；注意是在输入内容末尾加；一般默认就是在后台执行
• Alt + V：粘贴图片
• \ + Enter：换行，终端可能也支持 Ctrl/Shift + Enter
• Ctrl + Shift + _：撤销上次操作，也可移除上次输入的内容
• Ctrl + G：在编辑器中编辑输入，适合输入大段内容
• Ctrl + O：详细输出模式，展示完整的分析过程、影响内容
• Ctrl + T：切换任务面板，可能被终端拦截
• Ctrl + S：暂存当前输入
• Shift + Tab：切换权限模式
• Alt + P：切换模型
• Alt + O：切换快速模式(Fast mode)

模型与深度控制

三种模型，按需切换：

• Opus — 最强但最慢，适合复杂架构、深度分析、难题排查
• Sonnet — 性能与速度平衡，适合日常开发、代码编写、重构
• Haiku — 最快但能力有限，适合快速问答、简单修改、格式化

可以通过命令 /model 或快捷键 Alt + P 切换模型。

有三个控制维度，可组合使用：

• /model 换模型 - 能力不同
• /effort 调深度 - 思考时间不同
• /fast 调速度 - 输出更快

内置命令

• /config：进入可视化配置页面
  • /status：查看状态，Version、token、Session、Model
  • /usage 或 /cost：查看本次 Session 的实时用量统计
  • /stats：查看历史使用统计，按月、星期、模型等维度统计
• /init：项目初始化。系统性扫描项目，生成 CLAUDE.md 文件
• /help：帮助文档，包括 Shortcuts、Commands、Custom commands
• /powerup：学习 claude 最常用的功能
• /compact：压缩上下文，提炼提示词，防止超出上下文窗口大小
• /memory：查看、编辑持久化记忆文件，包括项目级和用户级的文件
• /permissions：查看、修改权限设置，如黑白命令名单、工作目录
• /keybindings：自定义快捷键
• /add-dir：动态添加额外的工作目录
• /tasks：查看后台任务，包括 agent、workflows、& 启动的后台任务
• /doctor：诊断环境问题

扩展

Claude Code 有多种机制来扩展和定制 Claude 的行为：

• CLAUDE.md — 告诉 Claude 规则，每次会话自动加载
• Memory — 让 Claude 记住偏好，跨会话持久化，自动关联上下文
• Hooks — 基于 Claude 事件驱动，由框架自动执行，大模型无感知
• Skill — 教 Claude 方法，定义触发条件和执行流程
• Plugin — 给 Claude 装技能包，一个 Plugin 可包含多个 Skill
• MCP — 给 Claude 装工具，连接外部服务，提供可调用的工具函数
• Agent — 给 Claude 分身，并行处理独立任务，独立子会话

配置

配置命令：/config

推荐使用 CC Switch 工具

Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的全方位管理工具

配置文件

• macOS：~/.claude/settings.json
• Windows：$HOME/.claude/settings.json
• 项目级配置文件：.claude/settings.json

常用配置项

• anthropicApiKey：API Key
• language：界面语言，如 简体中文
• permissions.defaultMode：默认权限模式
• autoCompact：自动压缩上下文，默认 true
• model：默认使用模型，如 claude-sonnet-4-6
• theme：终端主题，可选 dark、light、auto
• permissions.allow：允许的工具/命令名单
• permissions.deny：禁止的工具/命令名单
• excludeDirs：排除目录
• excludeFilePatterns：排除后缀文件
• enabledPlugins：启用的插件列表
• extraKnownMarketplaces：额外的插件市场源
• skipDangerousModePermissionPrompt：跳过危险模式确认弹窗
• skipAutoPermissionPrompt：跳过自动权限确认弹窗
• mcpServers：配置的 MCP 服务器
• env：注入环境变量，如 ANTHROPIC_BASE_URL、ANTHROPIC_MODEL
• hooks：生命周期钩子，如 PreToolUse、PostToolUse

实用技巧

• 使用 /powerup 快速学习 claude 常用功能
• 一个任务一个会话。不要在一个会话里既重构代码又写新功能又修 bug
• 任务完成后开新会话。通过 /clear 清空上下文或直接 claude 开新的
• 用 /compact 主动压缩。感觉 Claude 开始忘事时主动压缩
• 关键信息写进 CLAUDE.md，不要每次重复说。可以让 claude 帮你写
• 用 @文件名 引用文件，比手动粘贴更高效
• 用 !command 直接执行 shell 命令，不需要退出 Claude
• 复杂任务先用 /plan 规划方案，确认后再执行
• 输入大段内容时用 Ctrl + G 打开编辑器，比在终端里逐行输入方便
• 用 /btw 追加补充信息，如报错日志、环境细节，不用重开会话
• 用 Alt + V 粘贴截图，UI 问题、报错截图可以直接给 Claude 看
• 用 /memory 保存个人偏好和项目约定，下次会话自动生效
• 配置 hooks 自动化重复操作，如每次修改后自动格式化、自动运行测试
• 用 claude -p "问题" 嵌入脚本和 CI/CD 流水线，实现自动化代码审查

2026-5-21