云途AGI - AI一人公司实战指南

掌握了基础操作后，今天我们学习如何配置 Claude Code、与 Git 深度集成、在团队中高效协作，以及一些实用的高级技巧。

一、配置文件管理

Claude Code 支持通过配置文件自定义行为。

全局配置

配置文件位置

~/.claude-code/config.json

常用配置项

{
  "apiKey": "your-api-key",
  "model": "claude-3-5-sonnet-20241022",
  "maxTokens": 4096,
  "temperature": 0.7,

  "permissions": {
    "read": "auto",
    "write": "ask",
    "bash": "ask",
    "edit": "ask"
  },

  "editor": "vscode",
  "autoSave": true,
  "confirmBeforeExecute": true,

  "gitIntegration": {
    "autoCommit": false,
    "commitMessageTemplate": "feat: {description}"
  }
}

项目级配置

在项目根目录创建 `.claude-code.json` 可以覆盖全局配置。

创建项目配置

claude "创建项目配置文件 .claude-code.json：
{
  "codeStyle": {
    "indent": 2,
    "quotes": "single",
    "semi": true
  },
  "ignorePatterns": [
    "node_modules",
    "dist",
    ".next"
  ],
  "customInstructions": "使用 TypeScript，遵循 Airbnb 代码规范"
}"

💡 自定义指令

customInstructions 会在每次对话开始时自动加载，让 AI 了解项目的特殊要求。

二、权限精细化管理

根据不同场景设置不同的权限策略。

场景1：探索新项目

只读模式，不允许修改

{
  "permissions": {
    "read": "auto",
    "grep": "auto",
    "glob": "auto",
    "write": "deny",
    "edit": "deny",
    "bash": "deny"
  }
}

场景2：日常开发

读取自动，修改需确认

{
  "permissions": {
    "read": "auto",
    "grep": "auto",
    "glob": "auto",
    "write": "ask",
    "edit": "ask",
    "bash": "ask"
  }
}

场景3：快速原型

全自动模式，快速迭代

{
  "permissions": {
    "read": "auto",
    "write": "auto",
    "edit": "auto",
    "bash": "ask"  // 命令执行仍需确认
  }
}

⚠️ 安全建议

• 永远不要把 bash 设为 "auto"
• 在生产环境项目中使用 "ask" 模式
• 定期审查配置文件
• 不要在配置文件中存储敏感信息

三、与 Git 的深度集成

Claude Code 可以帮你管理 Git 工作流。

智能提交

自动生成提交信息

claude "查看当前的修改，生成合适的 commit message，然后提交"

AI 会分析 git diff，生成符合规范的提交信息（如 Conventional Commits）

批量提交

claude "把当前的修改按功能分成多个 commit：
1. 新增用户认证功能
2. 修复评论显示bug
3. 更新文档"

代码审查

claude "审查最近的 3 个 commit，检查：
1. 代码质量
2. 潜在的 bug
3. 性能问题
4. 安全隐患"

分支管理

创建功能分支

claude "创建新分支 feature/user-avatar
切换到该分支
开始开发用户头像功能"

合并冲突解决

claude "合并 main 分支到当前分支
如果有冲突，帮我解决
保留两边的修改并合理整合"

生成 PR 描述

claude "分析当前分支与 main 的差异
生成 Pull Request 描述：
1. 功能说明
2. 修改内容
3. 测试情况
4. 截图（如果有UI变化）"

四、团队协作最佳实践

在团队中使用 Claude Code 的建议。

1. 统一配置

在项目中添加 `.claude-code.json`，团队成员共享配置

{
  "codeStyle": {
    "indent": 2,
    "quotes": "single",
    "semi": true,
    "trailingComma": "es5"
  },
  "customInstructions": "遵循团队代码规范，使用 TypeScript"
}

2. 代码审查流程

用 Claude Code 辅助代码审查

# 审查者
claude "审查 PR #123 的代码变更
重点检查：
1. 是否符合团队规范
2. 是否有潜在bug
3. 是否需要添加测试"

3. 文档同步

自动更新项目文档

claude "我刚添加了新的 API 接口
更新 API.md 文档
添加接口说明、参数、返回值示例"

4. 知识传承

为新成员生成项目指南

claude "生成新人入职指南：
1. 项目架构说明
2. 开发环境搭建
3. 常用命令
4. 代码规范
5. 提交流程"

五、高级技巧

技巧1：上下文管理

当对话太长时，主动总结上下文

claude "总结一下我们目前完成的工作：
1. 已实现的功能
2. 当前的技术栈
3. 待解决的问题
保存到 PROGRESS.md"

技巧2：模板复用

创建常用的提示词模板

# 保存为 templates/new-api.txt
创建新的 API 接口：
路径：[PATH]
方法：[METHOD]
功能：[DESCRIPTION]
参数：[PARAMS]
返回：[RESPONSE]

包含：
- 参数验证
- 错误处理
- 单元测试

技巧3：批处理

一次性处理多个相似任务

claude "为以下所有组件添加 TypeScript 类型：
- UserCard
- PostCard
- CommentCard
使用统一的 Props 命名规范"

技巧4：增量开发

从简单版本开始，逐步增强

# 第1轮
claude "创建基础版搜索功能，只支持标题搜索"

# 第2轮
claude "增强搜索：添加内容搜索"

# 第3轮
claude "再增强：添加标签筛选和排序"

六、常见问题与解决方案

Q: 如何处理大型项目？

A: 分模块处理，每次只让 AI 关注一个模块

"只分析 src/features/auth/ 目录下的代码"

Q: AI 生成的代码不符合规范？

A: 在项目配置中明确代码规范

在 .claude-code.json 中添加 customInstructions

Q: 如何避免重复工作？

A: 保持对话连续性，AI 会记住之前的决策

不要频繁开启新对话，在同一个会话中完成相关任务

Q: 担心代码安全性？

A: 始终审查 AI 生成的代码，特别是涉及安全的部分

使用静态分析工具（ESLint、SonarQube）辅助检查

今日小结

你已经学会了：

✓配置 Claude Code 的全局和项目级设置
✓精细化管理权限，适应不同场景
✓与 Git 深度集成，智能管理版本控制
✓团队协作的最佳实践
✓高级技巧和常见问题解决

明天预告

在 Day 7（最后一天），我们将学习：

• 复杂场景的处理策略
• 性能优化技巧
• 故障排查方法
• 学习路径总结和进阶方向

←上一课：从零搭建项目下一课：进阶与总结→

🎓 加入云途AGI社群，获取更多学习资源

社群提供基础资源、答疑支持和陪伴式学习，帮助你更好地掌握 AI 工具

📚

基础资源

入门教程、工具指南、实战案例

💬

答疑支持

遇到问题随时提问，及时获得解答

🤝

陪伴式学习

与同行者一起成长，不再孤单学习

了解社群详情 →

高级技巧与最佳实践