Claude Code 使用指南

概述

Claude Code 是 Anthropic 推出的官方 AI 编程助手，通过命令行界面提供强大的代码生成、项目理解和开发辅助功能。本文档总结了 Claude Code 的核心功能、最佳实践和使用技巧。

API 配置指南

基础配置

建议使用 settings.json 配置文件方式，相比环境变量更安全且易于管理：

{
  "ANTHROPIC_AUTH_TOKEN": "你的Claude Code专属组令牌密钥",
  "ANTHROPIC_BASE_URL": "中转商API地址",
  "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
  "API_TIMEOUT_MS": "600000",
  "BASH_DEFAULT_TIMEOUT_MS": "600000"
}

模型选择建议

推荐使用 Sonnet 模型：性价比最高（比 Opus 便宜约5倍），性能优秀（智能水平与 Opus 基本相同）
切换方法：在 Claude Code 中输入 /model 命令选择

常见问题处理

网络状态显示”离线”
- Claude Code 通过测试连接 Google 来检查网络状态
- 显示离线不影响正常使用，只是表示无法访问 Google
服务错误
- 上游服务器过载：等待几分钟后重试，或尝试切换到 Sonnet 模型
- 网络连接错误：检查网络稳定性，重启 Claude Code

核心功能与命令

斜杠命令系统

Claude Code 提供丰富的斜杠命令：

/resume - 恢复历史会话
/memory - 在系统编辑器中打开记忆文件
/model - 切换模型（支持 Claude Opus 与 Claude Sonnet 4）
/cost - 查看当前会话使用情况
/exit - 退出当前会话

交互模式快捷键

快速换行：输入 \ 后按 Enter
退出方式：按 Ctrl-C 两次或 Ctrl-D 两次
自定义快捷键：配置后使用 Option+Enter 或 Shift+Enter

CLI 命令参考

# 基础命令
claude                    # 启动交互式 REPL
claude "查询"            # 以初始提示启动 REPL
claude -p "查询"         # 运行一次性查询后退出
claude config            # 配置设置
claude update            # 更新到最新版本

# MCP 配置
claude mcp add <名称> <命令> [参数...]
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

CLAUDE.md 文件机制

CLAUDE.md 是项目上下文记忆文件，Claude Code 会在对话开始时自动加载。它类似于 Cursor 的 rules 规则文件，但功能更强大。

CLAUDE.md 适合记录的内容

常用的 bash 命令
核心文件和实用函数
代码风格指南
测试说明
代码仓库规范（如分支命名、合并与变基策略）
开发者环境设置（如使用 pyenv、可用的编译器）
项目特有的任何意外行为或警告

示例 CLAUDE.md 结构

# 项目名称

## 项目概述
简要描述项目的目的和主要功能

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 常用命令
- 运行开发服务器：`npm run dev`
- 运行测试：`npm test`
- 构建项目：`npm run build`

## 代码规范
- 使用 ESLint 和 Prettier
- 遵循 Airbnb JavaScript 风格指南
- 组件使用函数式组件和 Hooks

## 注意事项
- 环境变量存储在 .env 文件中
- 提交前确保通过所有测试

自定义命令

Claude Code 支持两种级别的自定义命令：

用户级命令：放在 ~/.claude/commands 目录下
项目级命令：放在当前项目 .claude/commands 目录下

使用方式：

用户级命令：/user:命令名
项目级命令：/project:命令名

自定义命令示例

创建 .claude/commands/test.md：

# 运行测试套件

请运行项目的完整测试套件，并分析任何失败的测试。

```bash
npm test

如果有测试失败，请：

分析失败原因
提供修复建议

询问是否需要自动修复

## MCP（模型上下文协议）集成

MCP 允许 Claude Code 集成外部服务，实现更强大的功能：

- **Puppeteer**：网页自动化操作
- **数据库**：直接查询和操作数据库
- **API 服务**：调用第三方 API（如 Stripe、GitHub）

### MCP 配置示例

```bash
# 添加数据库服务
claude mcp add postgres -e DATABASE_URL=postgresql://user:pass@localhost/db -- npx @modelcontextprotocol/server-postgres

# 添加 Puppeteer 服务
claude mcp add puppeteer -- npx @modelcontextprotocol/server-puppeteer

最佳实践

1. 具体化你的需求

避免笼统的指令，如”修复这个漏洞”。相反，提供具体信息：

错误的具体表现
期望的行为
相关的文件或代码片段

2. 批量处理小任务

对于小任务或模块，一次性提供完整需求，让 Claude Code 一次性生成结果，提高整体效率。

3. 利用 Claude Code 作为 Linux 智能助手

无需记住繁杂的 Linux 命令，直接描述你想要做的事情。

4. 项目组织建议

在项目根目录创建并维护 CLAUDE.md 文件，帮助 Claude Code 更好地理解项目上下文。

总结

Claude Code 是一个强大的 AI 编程助手，通过合理配置和使用最佳实践，可以显著提高开发效率。记住：

维护良好的 CLAUDE.md 文件
使用具体明确的指令
选择性价比高的 Sonnet 模型
利用自定义命令和 MCP 扩展功能

通过这些技巧，你将能够充分发挥 Claude Code 的潜力，让它成为你的得力编程助手。

命令总览

基础命令

命令	功能	示例
claude	启动交互模式	claude
claude “task”	运行一次性任务	claude “fix the build error”
claude -p “query”	运行查询后退出	claude -p “explain this function”
claude -c	继续最近的对话	claude -c
claude -r	继续上一个对话	claude -r
claude commit	创建 Git 提交	claude commit

内置斜杠命令

命令	用途
/add-dir	添加额外的工作目录
/bug	报告错误（将对话发送给 Anthropic）
/clear	清除对话历史
/compact [instructions]	压缩对话，可选择性地提供重点指令
/config	查看 / 修改配置
/cost	显示令牌使用统计
/doctor	检查您的 Claude Code 安装的健康状况
/help	获取使用帮助
/init	使用 CLAUDE.md 指南初始化项目
/login	切换 Anthropic 账户
/logout	从您的 Anthropic 账户登出
/mcp	管理 MCP 服务器连接和 OAuth 身份验证
/memory	编辑 CLAUDE.md 内存文件
/model	选择或更改 AI 模型
/permissions	查看或更新权限
/pr_comments	查看拉取请求评论
/review	请求代码审查
/status	查看账户和系统状态
/terminal-setup	安装 Shift+Enter 键绑定用于换行（仅限 iTerm2 和 VSCode）
/vim	进入 vim 模式，在插入和命令模式之间切换

菇太帷iのBlog