Claude Code 基础使用

前置知识

阅读本文前，建议先了解：

01-Claude Code 概述 - 理解 Claude Code 的核心概念

一、安装与配置

1.1 安装方式

原生安装（推荐）：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
 
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

包管理器安装：

系统	命令
macOS (Homebrew)	`brew install --cask claude-code`
Windows (WinGet)	`winget install Anthropic.ClaudeCode`

1.2 登录认证

# 登录（会打开浏览器引导认证）
claude auth login
 
# 查看认证状态
claude auth status
 
# 登出
claude auth logout

支持的认证方式：

┌─────────────────────────────────────────┐
│          支持的认证方式                  │
├─────────────────────────────────────────┤
│ • Claude Pro / Team 订阅                │
│ • Anthropic API Key                     │
│ • AWS Bedrock                          │
│ • GCP Vertex AI                        │
└─────────────────────────────────────────┘

1.3 配置文件优先级

┌─────────────────────────────────────────┐
│         配置文件优先级                   │
├─────────────────────────────────────────┤
│ 1. 托管设置（组织策略）                  │
│ 2. 命令行参数                            │
│ 3. .claude/settings.local.json（本地）   │
│ 4. .claude/settings.json（项目级）       │
│ 5. ~/.claude/settings.json（用户级）     │
└─────────────────────────────────────────┘

1.4 完整配置示例

{
  "model": "opus",
  "effort": "high",
  "env": {
    "EDITOR": "code --wait"
  },
  "permissions": {
    "defaultMode": "default",
    "allow": [
      "Bash(npm run *)",
      "Bash(git commit *)",
      "Read(src/**)",
      "Edit(src/**)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Edit(.env)"
    ]
  },
  "autoMemoryEnabled": true
}

二、启动会话

2.1 基本启动方式

# 启动交互式会话（默认方式）
claude
 
# 带初始提示启动
claude "你的问题"
 
# 继续最近的会话
claude -c
 
# 恢复指定会话
claude -r "session-name"
 
# 命名新会话
claude -n "feature-auth"
 
# 打开会话选择器
claude --resume

2.2 非交互模式（Print Mode）

# 执行后直接退出
claude -p "解释这段代码"
 
# 管道输入
cat file.py | claude -p "审查这段代码"
 
# 简单翻译
echo "Hello" | claude -p "翻译成中文"

2.3 会话选项

参数	说明
`-c`, `--continue`	继续最近的会话
`-r`, `--resume`	恢复指定会话
`-n`, `--name`	命名新会话
`-p`, `--print`	非交互模式
`--permission-mode plan`	以 Plan 模式启动

三、在会话中

3.1 基本交互

# 启动会话后
> 帮我修复 src/api.ts 中的 bug
 
# 直接输入任务
> 添加用户认证功能
 
# 询问问题
> 这个项目如何构建？

3.2 文件引用

使用 @ 符号引用文件路径，Claude 会自动读取文件内容：

# 引用单个文件
> @src/components/Button.tsx 这个组件有什么问题？
 
# 引用多个文件
> 参考 @package.json 的依赖，帮我升级 React
 
# 引用目录
> @src/utils/ 分析这个目录的代码结构

3.3 直接运行命令

使用 ! 前缀直接运行 shell 命令：

# 查看 git 状态
> !git status
 
# 运行测试
> !npm test
 
# 查看文件
> !ls -la

四、斜杠命令

在交互模式中输入 / 查看所有可用命令。

4.1 内置命令

命令	说明
`/help`	显示帮助信息
`/clear`	清除当前对话，重新开始
`/compact`	压缩对话历史，释放上下文空间
`/resume`	切换到其他会话
`/rename`	重命名当前会话
`/init`	初始化或改进 CLAUDE.md 文件
`/memory`	查看/编辑 CLAUDE.md 和自动记忆
`/config`	打开设置界面
`/permissions`	查看/管理权限规则
`/hooks`	浏览已配置的 Hooks
`/agents`	创建/管理子代理
`/commit`	创建 Git 提交
`/cost`	查看 Token 用量和费用
`/context`	检查上下文窗口使用情况
`/effort`	设置推理努力等级（low/medium/high/max）
`/model`	切换 AI 模型
`/btw`	快速旁问（不影响对话历史）

4.2 技能命令（Skills）

命令	说明
`/batch <指令>`	并行化跨代码库的修改
`/simplify [关注点]`	审查最近的代码变更质量
`/loop [间隔] <提示>`	定时运行提示任务
`/debug [描述]`	排查会话问题

4.3 常用命令速查

/help       - 查看帮助
/clear      - 清除对话
/compact    - 压缩上下文
/context    - 检查上下文使用
/memory     - 管理记忆
/config     - 打开配置
/commit     - Git 提交
/btw        - 快速旁问

五、键盘快捷键

5.1 通用控制

快捷键	功能
`Ctrl+C`	取消输入或中止生成
`Ctrl+D`	退出会话
`Ctrl+L`	清屏
`Ctrl+O`	切换详细输出模式
`Ctrl+R`	反向搜索历史
`Ctrl+G`	在编辑器中打开提示
`Ctrl+V` / `Cmd+V`	粘贴图片
`Ctrl+B`	将正在运行的任务放入后台
`Ctrl+T`	切换任务列表显示
`Ctrl+F`	终止所有后台代理
`Esc+Esc`	回退/总结对话
`Shift+Tab` / `Alt+M`	切换权限模式
`Option+P` / `Alt+P`	切换模型
`Option+T` / `Alt+T`	切换扩展思考

5.2 文本编辑

快捷键	功能
`Ctrl+K`	删除到行尾
`Ctrl+U`	删除整行
`Ctrl+Y`	粘贴已删除文本
`Alt+B`	光标左移一个词
`Alt+F`	光标右移一个词

5.3 多行输入

方式	适用终端
`Shift+Enter`	iTerm2, WezTerm, Ghostty, Kitty
`Option+Enter`	macOS 默认终端
`\` + `Enter`	所有终端通用

六、权限模式

6.1 切换权限模式

按 Shift+Tab 循环切换：
default → acceptEdits → plan → default

6.2 权限模式说明

模式	行为	适用场景
Default	文件编辑和命令前都询问	日常开发，需要审核
Auto Accept Edits	自动接受编辑，仍询问命令	信任的修改任务
Plan Mode	只读工具，创建计划	安全分析，规划阶段
DontAsk	未预授权则自动拒绝	受限访问场景

6.3 模式详解

Default（默认模式）：

最安全的模式，适合日常开发：
- 文件编辑前询问 ✓
- Shell 命令执行前询问 ✓

Auto Accept Edits（自动接受编辑）：

适合信任的修改任务：
- 文件编辑自动接受 ✓
- Shell 命令仍需询问 ✓

Plan Mode（计划模式）：

只读探索，适合安全分析：
- 只能使用只读工具（Read、Glob、Grep）✓
- 不能修改文件或执行命令 ✓
- 生成实施计划供审核 ✓

七、会话管理

7.1 查看会话列表

# 在会话中
/resume
 
# 命令行
claude --resume

7.2 继续/分叉会话

# 继续会话
claude --continue
 
# 分叉会话（创建新分支）
claude --continue --fork-session

八、上下文管理

8.1 检查上下文使用

# 查看上下文使用情况
/context

8.2 压缩上下文

# 压缩对话历史
/compact
 
# 指定焦点压缩
/compact focus on the API changes

8.3 减少令牌使用

使用 /compact 压缩旧对话
使用 Subagents 处理长任务
将持久规则放在 CLAUDE.md 中

九、实用技巧

9.1 有效的提示方式

❌ 模糊：修复 bug
✅ 具体：修复 src/api/auth.ts 第 45 行的空指针错误

❌ 模糊：写个测试
✅ 具体：为 validateEmail 写测试，包含这些用例：
        'user@example.com' → true
        'invalid' → false

❌ 模糊：看看代码
✅ 具体：读取 src/auth/ 并理解会话处理逻辑

9.2 迭代式对话

第一次：修复登录错误
         ↓
Claude 调查并尝试修复
         ↓
第二次：这不太对，问题在于会话处理
         ↓
Claude 调整方法
         ↓
成功修复

9.3 先探索再实施

1. Shift+Tab 切换到 Plan Mode
2. 让 Claude 读取代码库
3. 审核生成的计划
4. 切换回 Default 模式执行

9.4 使用旁问

/btw 这个函数是什么意思？

旁问不影响主对话历史，适合快速提问。

十、环境变量

10.1 常用环境变量

变量	说明
`CLAUDE_CODE_EFFORT_LEVEL`	推理努力等级：low/medium/high/max
`CLAUDE_CODE_DISABLE_AUTO_MEMORY`	禁用自动记忆
`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`	禁用自适应思考
`MAX_THINKING_TOKENS`	最大思考 Token 数
`EDITOR`	默认编辑器
`CLAUDE_CODE_DEBUG`	启用调试日志

10.2 设置环境变量

macOS / Linux：

export CLAUDE_CODE_EFFORT_LEVEL=high
export EDITOR="code --wait"

Windows PowerShell：

$env:CLAUDE_CODE_EFFORT_LEVEL="high"
$env:EDITOR="code --wait"

十一、故障排查

11.1 常见问题

问题	解决方案
认证失败	重新运行 `claude auth login`
命令不存在	检查 PATH 配置
权限错误	检查文件权限或使用 sudo
网络问题	检查代理设置或防火墙

11.2 调试模式

# 启用调试日志
export CLAUDE_CODE_DEBUG=1
 
# 诊断常见问题
/doctor

核心要点

安装配置：一行安装，多种认证方式，多层级配置
启动方式：交互式/非交互式，支持会话恢复和命名
文件引用：使用 @ 引用文件，Claude 自动读取
斜杠命令：丰富的内置命令和技能命令
快捷键：高效操作的快捷键系统
权限模式：四种模式适应不同场景
上下文管理：检查、压缩、优化使用

小羊杂物间

探索

Claude Code 基础使用

一、安装与配置

1.1 安装方式

1.2 登录认证

1.3 配置文件优先级

1.4 完整配置示例

二、启动会话

2.1 基本启动方式

2.2 非交互模式（Print Mode）

2.3 会话选项

三、在会话中

3.1 基本交互

3.2 文件引用

3.3 直接运行命令

四、斜杠命令

4.1 内置命令

4.2 技能命令（Skills）

4.3 常用命令速查

五、键盘快捷键

5.1 通用控制

5.2 文本编辑

5.3 多行输入

六、权限模式

6.1 切换权限模式

6.2 权限模式说明

6.3 模式详解

七、会话管理

7.1 查看会话列表

7.2 继续/分叉会话

八、上下文管理

8.1 检查上下文使用

8.2 压缩上下文

8.3 减少令牌使用

九、实用技巧

9.1 有效的提示方式

9.2 迭代式对话

9.3 先探索再实施

9.4 使用旁问

十、环境变量

10.1 常用环境变量

10.2 设置环境变量

十一、故障排查

11.1 常见问题

11.2 调试模式

核心要点

延伸阅读

关系图谱

目录

反向链接