Claude Code：Anthropic AI 编程 CLI 全方位指南 (2026)

Claude Code：Anthropic AI 编程 CLI 全位指南 (2026)

Claude Code 是 Anthropic 官方推出的用于 AI 辅助软件开发的命令行界面。与基于浏览器的 AI 聊天工具不同，Claude Code 直接在您的终端中运行，能够读取和写入文件、运行命令，并以全上下文感知的能力导航您的代码库。

本指南涵盖了从安装到高级工作流的所有内容，是 2026 年充分发挥 Claude Code 潜力的权威资源。

什么是 Claude Code？

Claude Code 是一款 CLI 工具，赋予了 Claude 直接访问您开发环境的权限。当您在项目目录中运行它时，它可以：

阅读并理解您的整个代码库
跨多个目录编辑文件
运行 shell 命令（构建、测试、git 操作）
搜索代码并导航文件结构
创建 commit 和 pull request
通过读取日志和堆栈跟踪来调试错误

它与 GitHub Copilot 或 Cursor 等 AI 编程工具的不同之处在于，它完全是以代理（agent）的形式在终端中运行，通过执行多步操作来完成任务，而不仅仅是提供行内代码建议。

安装与配置

环境要求

要求	最低版本
Node.js	18+
操作系统	macOS, Linux, 或 Windows (通过 WSL)
Anthropic API key	或 Claude Pro/Max 订阅

安装

npm install -g @anthropic-ai/claude-code

验证安装

claude --version

身份验证

首次启动时，Claude Code 会提示您进行身份验证。您有两种选择：

选项 1：Anthropic API Key

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude

选项 2：Claude Pro/Max 订阅

启动 Claude Code 并按照基于浏览器的 OAuth 流程操作：

claude
# 按照身份验证提示操作

Claude Pro 订阅者享有受限的 Claude Code 使用额度。Claude Max（100 美元/月或 200 美元/月）订阅者可获得显著更高的额度。

订阅方案对比

方案	Claude Code 访问权限	每月额度
免费版	否	不适用
Pro ($20/月)	受限	低使用上限
Max ($100/月)	是	高使用上限
Max ($200/月)	是	极高使用上限
API (按需付费)	是	基于消费额度
Team/Enterprise	是	基于方案

基础用法

交互模式

在您的项目目录中启动 Claude Code：

cd your-project
claude

您将进入一个交互式会话，在这里您可以输入自然语言指令。Claude Code 会读取您的项目结构并基于对代码库的理解做出响应。

单次命令模式（One-Shot Mode）

在不进入交互模式的情况下发送单个提示词：

claude "explain what this project does"

打印模式（Print Mode）

在不进行交互会话或工具调用的情况下获取回复：

claude -p "what does the main function in src/index.ts do?"

管道输入

通过 stdin 将内容注入 Claude Code：

cat error.log | claude "explain this error and suggest a fix"
git diff | claude "review these changes"
npm test 2>&1 | claude "fix the failing tests"

恢复对话

# 恢复最近的一次对话
claude --resume

# 继续上一次对话
claude --continue

关键 CLI 参数

参数	简写	描述
`--version`	`-v`	打印版本
`--help`	`-h`	显示帮助
`--resume`	`-r`	恢复最近的对话
`--continue`	`-c`	继续上次对话
`--print`	`-p`	打印模式（无交互会话）
`--model`	`-m`	指定模型（例如 `claude-sonnet-4-20250514`）
`--max-turns`		限制代理执行步数
`--system-prompt`		自定义系统提示词
`--allowedTools`		限制可用工具
`--output-format`		输出格式：`text`, `json`, `stream-json`
`--dangerously-skip-permissions`		自动批准所有工具使用

斜杠命令 (Slash Commands)

在交互会话中，使用斜杠命令进行快速操作：

命令	描述
`/help`	显示可用命令
`/compact`	压缩对话以节省上下文
`/clear`	清除对话历史
`/cost`	显示 token 使用情况和预估费用
`/model`	会话中途切换模型
`/permissions`	查看和管理工具权限
`/config`	查看当前配置
`/bug`	向 Anthropic 报告 bug
`/quit`	退出 Claude Code

配置

项目级配置

在项目根目录创建一个 CLAUDE.md 文件，为 Claude Code 提供持久的上下文：

# CLAUDE.md

## 项目概览
这是一个使用 App Router、TypeScript 和 Tailwind CSS 的 Next.js 15 应用程序。

## 技术栈
- Next.js 15 (App Router)
- TypeScript (严格模式)
- Tailwind CSS + shadcn/ui
- Prisma ORM 配合 PostgreSQL
- NextAuth.js 负责身份验证

## 规范
- 默认使用 server components
- API 路由放在 app/api/ 中
- 所有输入验证使用 Zod
- 使用 Vitest 编写测试

## 重要注意事项
- 未创建 migration 前严禁修改数据库 schema
- 提交前务必运行 `npm run typecheck`
- 环境变量位于 .env.local 中（请勿读取或修改此文件）

Claude Code 在每次对话开始时会自动读取此文件。

设置文件

创建 .claude/settings.json 来配置工具权限和行为：

{
  "allowedTools": [
    "Read",
    "Write",
    "Glob",
    "Grep",
    "Bash(npm run *)",
    "Bash(npx *)",
    "Bash(git *)"
  ],
  "ignorePatterns": [
    "node_modules",
    "dist",
    ".next"
  ]
}

用户级配置

对于适用于所有项目的设置，请创建 ~/.claude/settings.json 或 ~/.claude.md。

常见工作流

1. 实现新功能

为 API 添加速率限制中间件。使用 Redis 实现令牌桶算法。
限制为每个 API key 每分钟 100 次请求。
添加测试。

Claude Code 将读取您现有的中间件，理解项目结构，创建实现并编写测试。

2. 修复 Bug

# 直接通过管道传输错误
npm test 2>&1 | claude "fix these failing tests"

或者描述 Bug：

有用户反映重置密码的邮件没有发送。
调试并修复该问题。

3. 代码审查

git diff main...feature-branch | claude "review this code for bugs, security issues, and style problems"

4. 代码重构

重构 user service 以使用 repository 模式。
将数据库查询从 route handlers 移动到 UserRepository 类中。
更新所有导入和测试。

5. 生成文档

为 src/utils/ 目录下的所有导出函数添加 JSDoc 注释。

6. Git 操作

创建一个名为 feature/rate-limiting 的新分支，提交当前更改并附上详细说明，然后推送到 origin。

7. 使用日志调试

cat server.log | claude "find the root cause of the 500 errors happening after 3pm"

高级用法

自定义系统提示词

针对特定任务覆盖默认行为：

claude --system-prompt "You are a security auditor. Review all code for vulnerabilities." \
  "audit the authentication module"

脚本编写与自动化

在 CI/CD 流水线或脚本中使用 Claude Code：

# 从最近的 commit 生成变更日志
git log --oneline v1.0..HEAD | claude -p --output-format json \
  "Generate a changelog grouped by category (features, fixes, other)"

# 自动修复 lint 错误
npx eslint src/ --format json 2>&1 | claude "fix all these lint errors"

多模型工作流

根据不同任务切换模型：

# 对简单任务使用更快的模型
claude -m claude-haiku-4-20250514 "rename the variable 'x' to 'userCount' in src/stats.ts"

# 对复杂任务使用最强大的模型
claude -m claude-opus-4-20250514 "redesign the database schema to support multi-tenancy"

限制工具权限

对于敏感操作，限制 Claude Code 的行为：

# 只读模式
claude --allowedTools "Read,Glob,Grep" "explain the authentication flow"

# 禁止访问 bash
claude --allowedTools "Read,Write,Glob,Grep" "refactor the utils"

获得更好结果的技巧

技巧	示例
明确指定文件	"编辑 `src/auth/login.ts`" 而非 "修复登录"
提供已尝试过的背景	"我尝试了 X 但报错 Y"
将大任务拆分为步骤	每次对话只处理一个功能
长会话使用 `/compact`	防止上下文窗口溢出问题
包含错误信息	粘贴完整的堆栈跟踪
阐明“为什么”	"添加缓存以减少 API 调用" 而非仅仅 "添加缓存"
使用 CLAUDE.md 提供项目上下文	避免每次重复设置说明

成本管理

监控消耗

/cost

这会显示当前会话消耗的 token 和预估费用。

降低成本

定期使用 /compact 来压缩长对话。
使用打印模式 (-p) 处理不需要调用工具的简单问题。
限制工具使用，当您只需要阅读代码而非编辑时。
使用 Haiku 模型 处理更名或格式化等简单任务。
将任务拆分为针对性的短会话，而不是进行一次超长对话。

故障排除

问题	解决方案
"API key not found"	设置 `ANTHROPIC_API_KEY` 环境变量
响应缓慢	检查网络连接；尝试 `/compact`
上下文窗口错误	开启新对话
权限被拒绝 (Permission denied)	检查 `.claude/settings.json` 中的 `allowedTools`
Claude Code 陷入死循环	按 Escape 键，然后提供更清晰的指令
"Rate limit exceeded"	等待几分钟或升级您的方案
无法读取某些文件	检查 `.gitignore` 和 `ignorePatterns` 设置

总结

Claude Code 是终端中最强大的 AI 编程助手。当您提供明确的指令、通过 CLAUDE.md 维护项目上下文，并将复杂任务拆分为专注的会话时，它的表现最为出色。无论是构建新功能、调试生产环境问题，还是重构遗留代码，Claude Code 都能在您掌控全局的同时处理繁重的工作。

如果您正在开发涉及 AI 生成内容（如图像、视频或音频）的应用程序，Hypereal AI 提供了开发者友好的 API，可以与 Claude Code 等工具无缝协作。通过简单的 API 调用即可生成图像、创建视频等。

Claude Code：Anthropic AI 编程 CLI 全位指南 (2026)

本指南涵盖了从安装到高级工作流的所有内容，是 2026 年充分发挥 Claude Code 潜力的权威资源。

什么是 Claude Code？

Claude Code 是一款 CLI 工具，赋予了 Claude 直接访问您开发环境的权限。当您在项目目录中运行它时，它可以：

阅读并理解您的整个代码库
跨多个目录编辑文件
运行 shell 命令（构建、测试、git 操作）
搜索代码并导航文件结构
创建 commit 和 pull request
通过读取日志和堆栈跟踪来调试错误

安装与配置

环境要求

要求	最低版本
Node.js	18+
操作系统	macOS, Linux, 或 Windows (通过 WSL)
Anthropic API key	或 Claude Pro/Max 订阅

安装

npm install -g @anthropic-ai/claude-code

验证安装

claude --version

身份验证

首次启动时，Claude Code 会提示您进行身份验证。您有两种选择：

选项 1：Anthropic API Key

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude

选项 2：Claude Pro/Max 订阅

启动 Claude Code 并按照基于浏览器的 OAuth 流程操作：

claude
# 按照身份验证提示操作

Claude Pro 订阅者享有受限的 Claude Code 使用额度。Claude Max（100 美元/月或 200 美元/月）订阅者可获得显著更高的额度。

订阅方案对比

方案	Claude Code 访问权限	每月额度
免费版	否	不适用
Pro ($20/月)	受限	低使用上限
Max ($100/月)	是	高使用上限
Max ($200/月)	是	极高使用上限
API (按需付费)	是	基于消费额度
Team/Enterprise	是	基于方案

基础用法

交互模式

在您的项目目录中启动 Claude Code：

cd your-project
claude

您将进入一个交互式会话，在这里您可以输入自然语言指令。Claude Code 会读取您的项目结构并基于对代码库的理解做出响应。

单次命令模式（One-Shot Mode）

在不进入交互模式的情况下发送单个提示词：

claude "explain what this project does"

打印模式（Print Mode）

在不进行交互会话或工具调用的情况下获取回复：

claude -p "what does the main function in src/index.ts do?"

管道输入

通过 stdin 将内容注入 Claude Code：

cat error.log | claude "explain this error and suggest a fix"
git diff | claude "review these changes"
npm test 2>&1 | claude "fix the failing tests"

恢复对话

# 恢复最近的一次对话
claude --resume

# 继续上一次对话
claude --continue

关键 CLI 参数

参数	简写	描述
`--version`	`-v`	打印版本
`--help`	`-h`	显示帮助
`--resume`	`-r`	恢复最近的对话
`--continue`	`-c`	继续上次对话
`--print`	`-p`	打印模式（无交互会话）
`--model`	`-m`	指定模型（例如 `claude-sonnet-4-20250514`）
`--max-turns`		限制代理执行步数
`--system-prompt`		自定义系统提示词
`--allowedTools`		限制可用工具
`--output-format`		输出格式：`text`, `json`, `stream-json`
`--dangerously-skip-permissions`		自动批准所有工具使用

斜杠命令 (Slash Commands)

在交互会话中，使用斜杠命令进行快速操作：

命令	描述
`/help`	显示可用命令
`/compact`	压缩对话以节省上下文
`/clear`	清除对话历史
`/cost`	显示 token 使用情况和预估费用
`/model`	会话中途切换模型
`/permissions`	查看和管理工具权限
`/config`	查看当前配置
`/bug`	向 Anthropic 报告 bug
`/quit`	退出 Claude Code

配置

项目级配置

在项目根目录创建一个 CLAUDE.md 文件，为 Claude Code 提供持久的上下文：

# CLAUDE.md

## 项目概览
这是一个使用 App Router、TypeScript 和 Tailwind CSS 的 Next.js 15 应用程序。

## 技术栈
- Next.js 15 (App Router)
- TypeScript (严格模式)
- Tailwind CSS + shadcn/ui
- Prisma ORM 配合 PostgreSQL
- NextAuth.js 负责身份验证

## 规范
- 默认使用 server components
- API 路由放在 app/api/ 中
- 所有输入验证使用 Zod
- 使用 Vitest 编写测试

## 重要注意事项
- 未创建 migration 前严禁修改数据库 schema
- 提交前务必运行 `npm run typecheck`
- 环境变量位于 .env.local 中（请勿读取或修改此文件）

Claude Code 在每次对话开始时会自动读取此文件。

设置文件

创建 .claude/settings.json 来配置工具权限和行为：

{
  "allowedTools": [
    "Read",
    "Write",
    "Glob",
    "Grep",
    "Bash(npm run *)",
    "Bash(npx *)",
    "Bash(git *)"
  ],
  "ignorePatterns": [
    "node_modules",
    "dist",
    ".next"
  ]
}

用户级配置

对于适用于所有项目的设置，请创建 ~/.claude/settings.json 或 ~/.claude.md。

常见工作流

1. 实现新功能

为 API 添加速率限制中间件。使用 Redis 实现令牌桶算法。
限制为每个 API key 每分钟 100 次请求。
添加测试。

Claude Code 将读取您现有的中间件，理解项目结构，创建实现并编写测试。

2. 修复 Bug

# 直接通过管道传输错误
npm test 2>&1 | claude "fix these failing tests"

或者描述 Bug：

有用户反映重置密码的邮件没有发送。
调试并修复该问题。

3. 代码审查

git diff main...feature-branch | claude "review this code for bugs, security issues, and style problems"

4. 代码重构

重构 user service 以使用 repository 模式。
将数据库查询从 route handlers 移动到 UserRepository 类中。
更新所有导入和测试。

5. 生成文档

为 src/utils/ 目录下的所有导出函数添加 JSDoc 注释。

6. Git 操作

创建一个名为 feature/rate-limiting 的新分支，提交当前更改并附上详细说明，然后推送到 origin。

7. 使用日志调试

cat server.log | claude "find the root cause of the 500 errors happening after 3pm"

高级用法

自定义系统提示词

针对特定任务覆盖默认行为：

claude --system-prompt "You are a security auditor. Review all code for vulnerabilities." \
  "audit the authentication module"

脚本编写与自动化

在 CI/CD 流水线或脚本中使用 Claude Code：

# 从最近的 commit 生成变更日志
git log --oneline v1.0..HEAD | claude -p --output-format json \
  "Generate a changelog grouped by category (features, fixes, other)"

# 自动修复 lint 错误
npx eslint src/ --format json 2>&1 | claude "fix all these lint errors"

多模型工作流

根据不同任务切换模型：

# 对简单任务使用更快的模型
claude -m claude-haiku-4-20250514 "rename the variable 'x' to 'userCount' in src/stats.ts"

# 对复杂任务使用最强大的模型
claude -m claude-opus-4-20250514 "redesign the database schema to support multi-tenancy"

限制工具权限

对于敏感操作，限制 Claude Code 的行为：

# 只读模式
claude --allowedTools "Read,Glob,Grep" "explain the authentication flow"

# 禁止访问 bash
claude --allowedTools "Read,Write,Glob,Grep" "refactor the utils"

获得更好结果的技巧

技巧	示例
明确指定文件	"编辑 `src/auth/login.ts`" 而非 "修复登录"
提供已尝试过的背景	"我尝试了 X 但报错 Y"
将大任务拆分为步骤	每次对话只处理一个功能
长会话使用 `/compact`	防止上下文窗口溢出问题
包含错误信息	粘贴完整的堆栈跟踪
阐明“为什么”	"添加缓存以减少 API 调用" 而非仅仅 "添加缓存"
使用 CLAUDE.md 提供项目上下文	避免每次重复设置说明

成本管理

监控消耗

/cost

这会显示当前会话消耗的 token 和预估费用。

降低成本

定期使用 /compact 来压缩长对话。
使用打印模式 (-p) 处理不需要调用工具的简单问题。
限制工具使用，当您只需要阅读代码而非编辑时。
使用 Haiku 模型 处理更名或格式化等简单任务。
将任务拆分为针对性的短会话，而不是进行一次超长对话。

故障排除

问题	解决方案
"API key not found"	设置 `ANTHROPIC_API_KEY` 环境变量
响应缓慢	检查网络连接；尝试 `/compact`
上下文窗口错误	开启新对话
权限被拒绝 (Permission denied)	检查 `.claude/settings.json` 中的 `allowedTools`
Claude Code 陷入死循环	按 Escape 键，然后提供更清晰的指令
"Rate limit exceeded"	等待几分钟或升级您的方案
无法读取某些文件	检查 `.gitignore` 和 `ignorePatterns` 设置

开始使用 Hypereal 构建

Claude Code：Anthropic AI 编程 CLI 全位指南 (2026)

什么是 Claude Code？

安装与配置

环境要求

安装

验证安装

身份验证

订阅方案对比

基础用法

交互模式

单次命令模式（One-Shot Mode）

打印模式（Print Mode）

管道输入

恢复对话

关键 CLI 参数

斜杠命令 (Slash Commands)

配置

项目级配置

设置文件

用户级配置

常见工作流

1. 实现新功能

2. 修复 Bug

3. 代码审查

4. 代码重构

5. 生成文档

6. Git 操作

7. 使用日志调试

高级用法

自定义系统提示词

脚本编写与自动化

多模型工作流

限制工具权限

获得更好结果的技巧

成本管理

监控消耗

降低成本

故障排除

总结

相关文章

如何使用 Claude Chrome DevTools MCP Server (2026)

Claude Code 入门指南与最佳实践 (2026)

Claude Code CLI 命令：完整备忘单 (2026)

立即开始构建

开始使用 Hypereal 构建

Claude Code：Anthropic AI 编程 CLI 全位指南 (2026)

什么是 Claude Code？

安装与配置

环境要求

安装

验证安装

身份验证

订阅方案对比

基础用法

交互模式

单次命令模式（One-Shot Mode）

打印模式（Print Mode）

管道输入

恢复对话

关键 CLI 参数

斜杠命令 (Slash Commands)

配置

项目级配置

设置文件

用户级配置

常见工作流

1. 实现新功能

2. 修复 Bug

3. 代码审查

4. 代码重构

5. 生成文档

6. Git 操作

7. 使用日志调试

高级用法

自定义系统提示词

脚本编写与自动化

多模型工作流

限制工具权限

获得更好结果的技巧