Claude Code

Claude Code 是 Anthropic 推出的 AI 编码助手，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。它支持在终端、IDE、桌面应用和浏览器中使用。

安装

macOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Homebrew (macOS)

brew install --cask claude-code

提示

原生安装方式支持自动更新，Homebrew 安装需要手动运行 brew upgrade claude-code 更新。

配置文件

`~/.claude` 文件夹

这是 Claude Code 的全局配置目录，存放各种配置、工具、plugins、skills 等。

常用配置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-token-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-5-haiku",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4"
  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "enabledPlugins": {},
  "skipDangerousModePermissionPrompt": true
}

`~/.claude.json`

这是全局状态文件，存储运行时状态数据，由 CLI 自动维护。

全局 MCP 服务器配置示例：

{
  "mcpServers": {
    "figma-desktop": {
      "type": "http",
      "url": "http://127.0.0.1:3845/mcp"
    }
  }
}

添加 MCP 服务器

# 基本语法
claude mcp add --transport http <name> <url>

# 添加用户服务器
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

常用命令

基础命令

命令	描述	示例
`claude`	启动交互式会话	`claude`
`claude "task"`	使用初始提示启动会话	`claude "explain this project"`
`claude -p "query"`	执行查询后退出	`claude -p "explain this function"`
`claude -c`	继续最近的对话	`claude -c`
`claude -r`	恢复之前的对话	`claude -r "auth-refactor"`

认证命令

命令	描述
`claude auth login`	登录账户
`claude auth logout`	登出账户
`claude auth status`	查看认证状态

其他命令

命令	描述
`claude update`	更新到最新版本
`claude mcp`	配置 MCP 服务器
`claude agents`	列出所有已配置的 subagents
`claude remote-control`	启动远程控制会话

CLI 标志

常用标志

标志	描述	示例
`--model`	指定使用的模型	`claude --model claude-sonnet-4`
`--continue`, `-c`	加载最近的对话	`claude -c`
`--print`, `-p`	打印响应后退出	`claude -p "query"`
`--resume`, `-r`	恢复特定会话	`claude -r session-id`
`--output-format`	输出格式 (text/json/stream-json)	`claude -p --output-format json "query"`
`--verbose`	启用详细日志	`claude --verbose`
`--version`, `-v`	查看版本号	`claude -v`

权限相关

标志	描述
`--dangerously-skip-permissions`	跳过所有权限提示（谨慎使用）
`--permission-mode`	指定权限模式（如 plan）
`--allowedTools`	无需权限提示的工具

上下文相关

标志	描述	示例
`--add-dir`	添加额外的工作目录	`claude --add-dir ../apps ../lib`
`--mcp-config`	从文件加载 MCP 配置	`claude --mcp-config ./mcp.json`
`--settings`	加载额外设置	`claude --settings ./settings.json`

系统提示

标志	描述
`--system-prompt`	替换整个系统提示
`--system-prompt-file`	从文件加载系统提示
`--append-system-prompt`	附加到默认系统提示
`--append-system-prompt-file`	从文件加载附加提示

交互模式快捷键

快捷键	功能
`/help`	显示可用命令
`/clear`	清除对话历史
`/resume`	恢复之前的对话
`/login`	登录账户
`↑`	查看命令历史
`Tab`	命令补全
`?`	查看所有快捷键

使用技巧

1. 提问要具体

不要说："修复错误"

尝试说："修复登录错误，用户输入错误凭证后看到空白屏幕"

2. 使用分步说明

将复杂任务分解为步骤：

1. 为用户配置文件创建新的数据库表
2. 创建 API 端点以获取和更新用户配置文件
3. 构建允许用户查看和编辑其信息的网页

3. 让 Claude 先探索

在进行更改之前，让 Claude 了解你的代码：

分析数据库架构

构建一个仪表板，显示英国客户最常退回的产品

4. 使用管道处理

Claude Code 可以接收管道输入：

# 监控日志并获取警报
tail -f app.log | claude -p "如果有异常，通知我"

# 批量操作
git diff main --name-only | claude -p "检查这些文件的安全问题"

5. Git 集成

Claude Code 可以直接与 Git 配合工作：

我更改了哪些文件？

用描述性消息提交我的更改

帮我解决合并冲突

CLAUDE.md 文件

在项目根目录创建 CLAUDE.md 文件，可以为 Claude Code 提供项目特定的上下文：

# 项目说明

## 技术栈
- Vue 3 + TypeScript
- Vite
- Pinia

## 编码规范
- 使用 Composition API
- 使用 `<script setup>` 语法
- 组件命名使用 PascalCase

## 常用命令
- `pnpm dev`: 启动开发服务器
- `pnpm build`: 构建生产版本

最佳实践

1. 项目初始化

首次在项目中使用 Claude Code 时，让它先了解项目：

这个项目做什么？

主入口点在哪里？

2. 代码审查

让 Claude 审查你的更改：

审查我的更改并建议改进

3. 测试驱动

让 Claude 编写和运行测试：

为计算器函数编写单元测试，运行它们，并修复任何失败

4. 重构

重构身份验证模块以使用 async/await 而不是回调

5. 文档更新

使用安装说明更新 README

多平台支持

Claude Code 可以在多种环境中使用：

环境	用途
Terminal	完整的 CLI 体验
VS Code	内联差异、@-提及、计划审查
JetBrains	IntelliJ IDEA、PyCharm、WebStorm 等
Desktop App	独立桌面应用
Web	浏览器中运行，无需本地设置
Slack	从聊天中路由任务到 PR

第三方提供商支持

Claude Code 支持通过第三方云提供商访问：

Amazon Bedrock
Google Vertex AI
Microsoft Foundry