12.4 其他常见问题

Claude Code CLI 参数

claude                    # 启动交互式会话
claude "fix the bug"      # 单次任务（不接受后续输入）
claude -p "query"         # 打印模式（不进入交互）
claude -c                  # 继续上一个会话
claude -r <session-id>     # 恢复指定会话
claude --fork-session      # 分叉新会话
claude update              # 更新到最新版本
claude --version           # 查看版本
claude --debug             # 启用调试模式
claude --help              # 显示帮助

文件访问限制

Claude Code 只能读写其启动目录及其子目录下的文件。例如：

cd ~/projects/myapp     # 在这个目录下启动
claude                  # 只能访问 ~/projects/myapp/ 下的文件

无法访问 ~/projects/ 的兄弟目录，也不能访问 /etc/、/usr/ 等系统目录。

模型切换

在会话中切换模型：

→ /model sonnet   # 切换到 Sonnet（平衡模式）
→ /model opus     # 切换到 Opus（最高智能）
→ /model haiku    # 切换到 Haiku（最快速度）

或通过 settings.json 设置默认模型：

{
  "model": "sonnet"
}

Token 计算

Claude Code 在会话内提供 Token 计数，但为本地估算值：

/usage   # 查看当前会话的 Token 使用量

精确用量在 Claude Console（console.anthropic.com）中查看。

如何禁用自动更新

# Homebrew 安装可以通过 pin 禁用更新
brew pin claude-code

# npm 安装的可以通过 .npmrc 固定版本
npm install -g @anthropic-ai/claude-code@2.1.118

Claude Code 能读 Git 历史吗

能。Claude Code 内置了 Git 支持，可以：

→ 查看最后一次 commit 的内容
→ 帮我分析这个 PR 改了什么
→ 找出最近一周新增了哪些文件
→ 对比 current branch 和 main branch 的差异

Claude Code 能处理二进制文件吗

部分支持：

• 图片：可以分析（PNG、JPG、GIF、WebP 等，需 <10MB）
• PDF：可以读取文本内容（需 <10MB，无密码）
• 压缩包：不能直接解压，需要先解压
• Office 文档：不支持直接读取，需要导出为文本

与 GitHub Copilot 的区别

如何反馈问题或建议

通过 Claude Code 内置命令：

/feedback   # 提交反馈

或在 GitHub 提交 Issue：github.com/anthropics/claude-code