Claude Code 使用教程
Claude Code 使用教程
什么是 Claude Code
Claude Code 是 Anthropic 推出的基于 Claude 模型的命令行 AI 编程助手。它可以理解自然语言指令，自动生成、修改和解释代码，支持多种编程语言和项目结构。
安装 Claude Code
- 前提条件
- 已安装 Node.js（建议 >=18）
-
拥有 Anthropic API 密钥（需在 Anthropic Console 申请）
-
通过 npm 安装
bash
npm install -g @anthropic-ai/claude-code -
配置 API 密钥
bash
claude-code config set api_key <你的_API_密钥>
也可以通过环境变量ANTHROPIC_API_KEY设置。
基本使用
启动交互模式
claude-code
进入后会看到提示符 >, 可以直接输入自然语言指令。
常用命令
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息 |
/exit |
退出交互模式 |
/clear |
清屏 |
/model <model-name> |
切换使用的 Claude 模型（如 claude-3-opus-20240229） |
/set <key> <value> |
设置配置项（如 api_key, max_tokens） |
生成代码
直接描述需求：
> 创建一个 Python Flask 应用，实现 RESTful API，包含用户注册和登录接口。
Claude Code 会生成对应的项目结构和代码文件。
修改现有代码
打开文件后进行编辑指令：
> 将 app.py 中的密码加密方式从 md5 改为 bcrypt。
Claude Code 会定位到相应位置并给出修改建议或直接应用更改。
解释代码
选中代码块后使用：
> 解释这段代码的作用。
或者直接在终端输入：
> explain 文件路径:行号
单元测试生成
> 为 src/utils.py 生成单元测试文件。
Claude Code 会基于函数签号生成对应的测试用例（使用 pytest 或 unittest 等框架）。
高级技巧
使用工作区（Workspace）
在项目根目录运行 claude-code 时，它会自动加载当前目录作为工作区，便于跨文件操作。
指令链（Chaining）
可以将多个指令用分号分隔：
> 创建一个 React 组件；为其添加 props 类型检查；生成对应的故事书（Storybook）文件。
自定义 Prompt 模板
在 ~/.claude-code/prompts/ 目录下添加自定义 .md 文件，可在指令中使用 /prompt <name> 引用。
与版本控制结合
- 在生成代码后，可直接使用
/git add .、/git commit -m "AI 生成初始代码"等 Git 命令（需确保已安装 Git 并在项目中初始化）。 - 也可让 Claude Code 自行写提交信息：
“`生成提交信息：描述本次更改的主要功能。
“`
常见问题及解决办法
| 问题 | 解决方案 |
|---|---|
API 错误 401 Unauthorized |
检查 api_key 是否正确设置，确保环境变量或配置文件中未有空格。 |
| 生成代码缺失依赖 | 后续手动运行 npm install 或 pip install -r requirements.txt 安装所需包。 |
| 想要更长的输出但被截断 | 调整 max_tokens 配置：/set max_tokens 4096（视模型而定）。 |
| 中文输出乱码 | 确保终端使用 UTF-8 编码（在 Linux/macOS 上一般默认如此），Windows 可使用 chcp 65001。 |
| 想让 Claude Code 只读取特定文件 | 使用 /ignore <glob-pattern> 忽略不需要的文件，或在工作区外指定绝对路径。 |
最佳实践
- 先描述目标，再细化：先给出高层次需求，再根据返回结果逐步细节。
- 增量修改：不要一次性要求大规模重构，先小改，检查后再继续。
- 利用解释功能：生成代码后立即让 Claude 解释，确保理解正确。
- 保存会话：交互过程可通过
/save-session <filename>导出为 markdown，便于后复现或分享。 - 结合代码审查：生成后使用工具（如 ESLint, pylint）进行静态检查，必要时让 Claude 帮忙修复。
资源链接
- 官方文档：https://docs.anthropic.com/claude-code
- GitHub 示例项目：https://github.com/anthropics/claude-code-examples
- Discord 社区：https://discord.gg/anthropic
- API 密钥获取：https://console.anthropic.com/
祝使用愉快！如果还有其他具体需求，随时告诉我。
