Claude Code 快速开始

安装

建议使用智普GLM 套餐

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

bash 复制代码

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

权限模式

bash 复制代码

# 启动 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

工作目录

bash 复制代码

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

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

启动方式

bash 复制代码

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`	切换模型	Opus、Sonnet、Haiku，快捷键 `Alt + P`
`/effort`	调整思考深度	`max`、`high`、`low`(深度低，响应快)
`/fast`	快速模式	不换模型，加速输出，快捷键 `Alt + O`

/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