Claude Code CLI 2026完整技术参考#

# 下载安装脚本并执行
curl -fsSL https://install.claude.ai | bash

# 验证安装
claude doctor

# 使用PowerShell安装
irm https://install.claude.ai | iex

# 验证安装
claude doctor

# 使用Homebrew安装
brew install --cask claude-code

# 验证安装
claude doctor

claude doctor
# 检查：Node.js版本、认证、Git配置、网络连接

# 检查更新
claude check-update

# 执行更新
claude update

# 或在Claude会话中使用
/update

brew upgrade --cask claude-code

claude --version

{
  "model": "claude-opus-4.6",
  "temperature": 0.7,
  "autoCommit": false,
  "plugins": {
    "enabled": true,
    "autoUpdate": true
  },
  "skills": {
    "path": "~/.claude/skills"
  },
  "mcp": {
    "servers": {
      "github": {
        "type": "stdio",
        "command": "npx @modelcontextprotocol/server-github"
      }
    }
  }
}

# 直接API密钥
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"

# 自定义认证头
export ANTHROPIC_AUTH_TOKEN="your-token"

# 自定义请求头
export ANTHROPIC_CUSTOM_HEADERS="X-Key: value"

# 默认模型
export ANTHROPIC_MODEL="claude-opus-4.6"

# 子代理模型
export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4"

# 输出限制
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="4000"

# 启用扩展思考
export MAX_THINKING_TOKENS="10000"

# 启用代理团队（v2.1.32+）
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"

# 启用详细日志
export CLAUDE_CODE_VERBOSE="1"

my-plugin/
├── plugin.json          # 插件元数据（必需）
├── commands/            # 自定义slash命令
│   └── my-command.md
├── agents/              # 专用代理
│   └── my-agent.md
├── skills/              # 任务特定技能
│   └── my-skill.md
├── hooks/               # 事件钩子
│   └── hooks.json
├── .mcp.json            # MCP服务器配置
└── .lsp.json            # LSP服务器配置

{
  "name": "my-claude-plugin",
  "version": "1.0.0",
  "description": "我的自定义Claude插件",
  "author": "Your Name",
  "commands": [
    {
      "name": "my-command",
      "description": "自定义命令说明",
      "file": "commands/my-command.md"
    }
  ],
  "agents": [
    {
      "name": "my-agent",
      "description": "专用代理说明",
      "file": "agents/my-agent.md"
    }
  ],
  "skills": [
    {
      "name": "my-skill",
      "description": "技能说明",
      "file": "skills/my-skill.md"
    }
  ]
}

# 安装官方插件
claude plugin install claude-code-guide

# 安装社区插件
claude plugin install username/plugin-name

# 使用本地插件
claude --plugin-dir ./my-plugin

# 测试插件
claude -p "/my-command 参数"

{
  "servers": {
    "github": {
      "type": "stdio",
      "command": "npx @modelcontextprotocol/server-github"
    },
    "notion": {
      "type": "http",
      "url": "https://api.notion.com"
    },
    "postgresql": {
      "type": "stdio",
      "command": "npx @modelcontextprotocol/server-postgresql",
      "args": ["postgresql://localhost:5432/mydb"]
    }
  }
}

{
  "servers": {
    "database": {
      "type": "stdio",
      "command": "python ./mcp-servers/database.py"
    }
  }
}

# 添加GitHub MCP服务器
claude mcp add --transport stdio github npx @modelcontextprotocol/server-github

# 添加PostgreSQL MCP服务器
claude mcp add --transport stdio postgresql npx @modelcontextprotocol/server-postgresql postgresql://localhost:5432/mydb

# 添加带环境变量的MCP服务器
claude mcp add --transport stdio --env API_KEY=value myserver python server.py

使用GitHub MCP服务器：
- 查看PR: "查看最新的pull request"
- 创建Issue: "创建一个新的bug report issue"
- 查看仓库: "查看当前仓库的star数"

使用PostgreSQL MCP服务器：
- 查询数据: "查询users表中最近注册的用户"
- 分析数据: "分析订单数据的月度趋势"
- 修改数据: "更新用户的邮箱地址"

---
name: unit-test
description: 自动生成单元测试
arguments: [$file, $framework]
---

为文件 {{ $file }} 生成单元测试
使用 {{ $framework }} 测试框架
遵循项目中的测试模式
覆盖边界条件和错误情况

---
name: deploy
description: 部署应用到生产环境
arguments: [$environment, $version]
disable-model-invocation: true
---

# 部署流程

## 1. 前置检查
- 检查测试是否通过
- 验证配置文件
- 确认版本号 {{ $version }}

## 2. 部署到 {{ $environment }}
- 构建Docker镜像
- 推送到容器仓库
- 更新Kubernetes部署

## 3. 验证部署
- 运行健康检查
- 检查日志
- 验证功能

## 4. 清理
- 删除旧版本
- 清理临时文件

# 在Claude会话中
/unit-test src/utils/helper.js jest

# 带多个参数
/deploy production v1.2.3

# 创建技能目录
mkdir -p ~/.claude/skills

# 创建技能文件
cat > ~/.claude/skills/my-skill.md << 'EOF'
---
name: my-skill
description: 我的自定义技能
arguments: [$param1, $param2]
---

执行任务：{{ $param1 }} 和 {{ $param2 }}
遵循最佳实践
生成详细报告
EOF

# ~/.claude/agents/security-auditor.md

---
name: security-auditor
description: 安全审计专家
model: claude-opus-4.6
temperature: 0.3
tools:
  - file_system
  - git
  - mcp_servers
---

你是一位专业的安全审计专家，负责：

1. 代码安全审查
2. 漏洞识别
3. 安全建议提供
4. 风险评估报告

重点关注：
- SQL注入
- XSS攻击
- 权限问题
- 数据泄露风险

# .claude/agents/performance-optimizer.md

---
name: performance-optimizer
description: 性能优化专家
model: claude-sonnet-4
temperature: 0.5
tools:
  - file_system
  - bash
  - mcp_database
---

你是一位性能优化专家，专注于：

1. 代码性能分析
2. 数据库查询优化
3. 内存使用优化
4. 缓存策略设计

提供具体的优化建议和基准测试。

# 设置环境变量
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"

# 或使用命令行参数
claude --experimental-agent-teams

"分析这个项目的技术债务" →
  ├─ Explore代理：分析项目结构
  ├─ Code Reviewer代理：检查代码质量
  ├─ Bug Analyzer代理：识别潜在问题
  └─ Performance Optimizer代理：分析性能瓶颈

/explore 分析项目结构
- 查看主要模块
- 识别依赖关系
- 发现潜在问题

/plan 实现用户认证系统
- 分解为子任务
- 确定依赖关系
- 生成实施计划

❌ "让应用更好"
❌ "优化性能"
❌ "修复bug"

✅ "为email字段添加正则表达式验证"
✅ "优化用户列表页面的加载速度"
✅ "修复登录时密码不匹配的问题"

"添加新的API端点，参考src/api/users.ts的模式"
"使用认证模块的错误处理方式"
"遵循项目的代码风格规范"

/deploy production v1.2.3
/unit-test src/components/Button.js
/security-audit src/api/

# 添加GitHub集成
claude mcp add github

# 添加数据库访问
claude mcp add postgresql

# 添加Slack通知
claude mcp add slack

每完成一个重要任务后：
1. 总结完成的工作
2. 运行/compact命令
3. 继续下一个任务

# 1. 启动Claude Code
cd my-web-app
claude

# 2. 分析项目结构
/explore 分析项目结构

# 3. 查看计划任务
/tasks list

# 4. 实现特性
"添加用户登录功能"

# 5. 运行测试
/unit-test src/auth/login.js jest

# 6. 提交代码
git add .
git commit -m "Add login feature"

# 7. 压缩上下文
/compact

# 1. 启动审查会话
cd project
claude --permission-mode plan

# 2. 审查代码变更
/review

# 3. 使用Code Reviewer代理
使用Code Reviewer代理进行深度分析

# 4. 生成报告
"生成代码审查报告，包含改进建议"

# 简单任务使用Haiku
claude --model claude-haiku

# 复杂任务使用Opus
claude --model claude-opus-4.6

# 平衡任务使用Sonnet
claude --model claude-sonnet-4

# 限制输出token
claude --max-tokens 2000

# 使用print模式
claude -p "简短回答"

每完成一个任务后：
/compact

# 检查认证状态
claude doctor

# 重新登录
claude login

# 检查API密钥
echo $ANTHROPIC_API_KEY

# 列出MCP服务器
claude mcp list

# 重启MCP服务器
claude mcp restart github

# 检查MCP日志
claude --debug

# 检查插件状态
claude plugin list

# 更新插件
claude plugin update

# 重新加载插件
claude --plugin-dir ./plugins

"全面分析这个项目的技术债务" →
  ├─ Explore: 代码结构分析
  ├─ Code Reviewer: 代码质量审查
  ├─ Bug Analyzer: 潜在问题识别
  ├─ Security Auditor: 安全检查
  └─ Performance Optimizer: 性能分析

# 使用自定义系统提示
claude --append-system-prompt "你是Python专家，专注于代码优化"

# 使用CLAUDE.md文件
echo "你是前端专家，专注于React和性能优化" > CLAUDE.md

# 使用print模式批处理
claude -p "分析这个文件" -f src/main.py > analysis.md

# 多文件处理
for file in src/*.js; do
  claude -p "检查代码质量" -f $file > ${file}.check.md
done