Claude Code 是由 Anthropic 开发的智能编程工具，旨在通过自然语言交互帮助开发者高效完成代码编写、调试、重构等任务。它能够理解项目上下文，直接执行文件操作、运行命令和 Git 工作流，显著提升开发效率。以下是详细使用指南：

一、安装与配置

1. 系统要求

   • 操作系统：macOS 10.15+、Linux（Ubuntu 20.04+/Debian 10+）、Windows（需 WSL 2）。
   • 硬件：至少 4GB RAM。
   • 软件：Node.js 18.0+，Git 2.23+。

2. 安装步骤

   • 全局安装：在终端运行命令 npm install -g @anthropic-ai/claude-code。
   • 验证安装：执行 claude --version 查看版本号。

3. 账号认证

   • 订阅计划：需 Anthropic Pro（$20/月）或 Max（$100/月起）账号，支持 Claude Code 功能。
   • 认证流程：
     1. 进入项目目录，运行 claude。
     2. 浏览器打开认证页面，登录订阅账号并授权。
   • 国内用户替代方案：
     • 使用第三方中转站（如 api.cxyquan.com）获取 API Key 和 URL。
     • 通过环境变量配置：

       export ANTHROPIC_AUTH_TOKEN=sk-你的API密钥
       export ANTHROPIC_BASE_URL=https://中转站地址
       

4. 初始化项目

   • 在项目根目录运行 /init，生成 .claude/CLAUDE.md 文件。
   • CLAUDE.md 作用：定义项目背景、技术栈、编码规范等，作为系统提示词增强 AI 理解。

二、基础使用

1. 启动会话

   • 交互式会话：在项目目录运行 claude，进入命令行交互模式。
   • 一次性查询：claude -p "问题"，执行后退出。
   • 续接会话：claude --continue，恢复上次对话。

2. 常用命令

   • 代码生成：描述需求（如“用 React 创建登录页面”），AI 自动生成代码。
   • 调试辅助：粘贴错误信息，AI 分析问题并提供修复建议。
   • 代码审查：输入 /review，AI 检查代码风格并给出优化建议。
   • 文件操作：
     • 创建文件：/init 或直接描述需求（如“在 src/utils 下创建 dateHelper.js”）。
     • 编辑文件：AI 生成内容后，需确认是否写入文件。
   • Git 集成：
     • 提交代码：描述变更后，AI 生成提交信息并执行 git commit。
     • 解决冲突：AI 自动分析合并冲突并提供解决方案。

3. 会话管理

   • 查看会话列表：claude --resume。
   • 清除历史：/clear 删除当前会话记录。
   • 压缩会话：/compact 保留重点内容，减少上下文占用。

三、高级功能

1. 深度思考模式

   • 输入复杂问题（如“分析身份验证流程的边缘情况”），AI 进行多步骤推理并生成详细解答。

2. 记忆管理

   • 项目记忆：编辑 .claude/CLAUDE.md，添加长期记忆内容（如架构设计、常用命令）。
   • 会话记忆：AI 自动记录对话上下文，支持跨会话引用。

3. MCP 集成

   • 数据库连接：添加 MySQL 集成，AI 直接查询或修改数据：

     claude mcp add mcp_server_mysql \
       -e MYSQL_HOST=主机地址 \
       -e MYSQL_USER=用户名 \
       -e MYSQL_PASS=密码
     

   • 网页自动化：集成 Playwright，AI 操作浏览器完成测试或数据抓取。

4. 权限控制

   • 精细权限：在 .claude/settings.json 中定义允许的操作（如 "allow": ["Edit(src/**)", "Bash(npm run test)"]）。
   • 临时提权：会话中通过提示词（如“允许本次修改配置文件”）临时放宽限制。

四、最佳实践

1. 优化提示词

   • 分步描述：将任务拆解为多个步骤（如“1. 创建 API；2. 写测试；3. 更新文档”）。
   • 提供示例：粘贴代码片段并说明需求（如“如何改写为 async/await？”）。
   • 明确需求：描述输入/输出格式（如“生成 JSON 格式的配置模板”）。

2. 成本控制

   • 监控 Token 使用：输入 /cost 查看消耗，避免长时间会话或复杂任务。
   • 压缩上下文：定期使用 /compact 清理无关内容。

3. 团队协作

   • 共享配置：团队克隆项目后，使用相同的 .claude.json 和 CLAUDE.md 确保一致性。
   • 标准化工具：通过配置文件统一模型选择（如 claude config set -g model claude-sonnet-4）。

五、故障排查

1. 认证失败

   • 检查网络连接，确保能访问 Anthropic API 或第三方中转站。
   • 确认账号订阅状态，避免使用免费账号。

2. 命令无效

   • 更新到最新版本：claude update。
   • 查看帮助文档：claude --help。

3. 权限错误

   • 检查 .claude/settings.json 中的权限配置。
   • 避免使用 sudo 运行 Claude Code，防止权限冲突。

六、替代方案（国内用户）

若无法访问 Anthropic 官方服务，可通过以下方式使用：

1. 开源路由工具

   • 使用 ClaudeCodeRouter 接入其他大模型 API（如 Qwen、Kimi）：

     npm install -g @musistudio/claude-code-router
     ccr code  # 启动路由服务
     

   • 配置 ~/.claude-code-router/config.json，指定模型提供商和 API Key。

2. 本地化部署

   • 部署开源模型（如 Ollama 运行的 CodeLLama），通过 LocalAI 或 FastChat 接入 Claude Code。

OpenSpec原理解析与使用详解

tensorflow使用详解