> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yelu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 示例

> 通过 Yelu 使用 Claude Code 完成仓库分析、功能实现、代码审查、自动化和项目级指令配置。

以下示例假设已经按照 [Claude Code 配置指南](/zh/guides/claude-code) 接入 Yelu。请从仓库根目录运行命令，确保 Claude Code 获取正确的项目上下文。

## 确认当前网关

```bash macOS / Windows / WSL theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude --version
claude doctor
claude --model claude-sonnet-4-6
```

进入 Session 后执行 `/status`。在共享仓库内容前，确认 Base URL 为 `https://api.yelu.ai`。

## 只分析，不修改

Plan Mode 允许 Claude 检查仓库并制定方案，不会立即修改文件：

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude --model claude-sonnet-4-6 --permission-mode plan \
  "分析当前仓库，说明运行入口、数据流、测试策略和三个最高风险点。每个结论都要引用具体文件路径，不要修改文件。"
```

接手陌生代码库或评估迁移范围时，建议先使用此模式。

## 实现一个聚焦改动

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude --model claude-sonnet-4-6 \
  "为出站 API Client 增加请求超时。保持公开接口不变，为超时和取消行为添加测试，运行相关测试套件，并总结每个修改文件。"
```

命令超出当前 Permission Policy 时，Claude Code 会请求授权。批准前检查命令、影响范围和 Diff。

## 审查未提交改动

把 Diff 传给非交互审查。只要 `git` 和 `claude` 位于 `PATH`，命令可用于 macOS、PowerShell、Git Bash 和 WSL：

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
git diff --no-ext-diff | claude -p \
  "审查此 Diff 的正确性、安全性、回归风险和测试缺口。按严重程度输出问题，包含文件与行号；不要改写代码。"
```

## 输出机器可读结果

脚本和 CI 可使用 Print Mode：

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude -p --model claude-sonnet-4-6 --output-format json \
  "检查当前仓库，以简洁 JSON 返回发布就绪评估，包含 blockers、warnings 和 passed_checks。"
```

即使返回 JSON，也要把模型输出视为不可信输入。在交给其他工具前校验字段、类型和允许值。

## 继续之前的 Session

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude --continue
```

需要选择更早的会话时执行：

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude --resume
```

## 添加项目指令

团队需要一致行为时，可在仓库根目录提交经过 Review 的 `CLAUDE.md`：

```markdown CLAUDE.md theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Project instructions

## Commands
- Install dependencies: `npm ci`
- Run unit tests: `npm test`
- Run lint: `npm run lint`
- Run type checks: `npm run typecheck`

## Change policy
- Keep public APIs backward compatible unless the task explicitly changes the contract.
- Add or update tests for every behavior change.
- Never edit generated files or commit secrets.
- Ask before adding a production dependency or changing database schema.
- Run the smallest relevant checks first, then the full suite before completion.
```

项目指令本身也是代码：保持具体、接受 Review，并在命令或架构变化时同步更新。

## Windows 注意事项

* Windows 原生环境必须从已设置 `ANTHROPIC_AUTH_TOKEN` 的 PowerShell 启动 Claude。
* WSL 2 中应在 WSL 内运行 Claude 和 Git，并把仓库放在 Linux 文件系统。
* 如果不同系统的 Shell 命令不一致，应明确告诉 Claude 项目支持的 Shell 与 Runtime。

<Warning>
  不要仅因为模型请求就批准破坏性命令、凭证访问、部署或生产数据修改。执行前必须核对范围、目标和回滚方式。
</Warning>