Claude Code 使用教程

Claude Code 是 Anthropic 推出的命令行工具，旨在让开发者能够直接在本地终端中使用 Claude 大模型进行代码补全、调试和重构。相比传统的 IDE 插件，Claude Code 更加轻量、跨平台，并且支持通过简单指令切换不同的模型和配置文件。

1. 安装 Claude Code

通过 Homebrew（macOS/Linux）

1

brew install anthropic/claude/claude-code

通过 Python 包管理器（跨平台）

1

pip install claude-code

注意：安装前请确保系统已装有 Python 3.8 以上版本，并且 pip 对应的 Python 环境是你日常使用的。

安装完成后，运行 claude-code --version 检查是否成功。

2. 基本使用

Claude Code 通过子命令实现不同功能，最常用的是 chat 与 code 两大类。

2.1 与 Claude 对话

1

claude-code chat "帮我写一个 Python 函数，实现二分查找"

Claude 会返回完整的代码实现，直接复制粘贴即可。

2.2 代码补全

打开你的编辑器（vim、nano、code 等），将光标停在需要补全的行前，运行：

1

claude-code code --file path/to/file.py --line 42

Claude 会输出建议的代码片段，你可以选择接受或自行修改。

3. 切换模型（CC Switch）

Claude Code 支持多模型同时配置，默认使用 claude-3-sonnet-20240229。如果你想尝试更强大的 claude-3-opus-20240229，可以使用 cc switch 命令。

1
2
3
4
5

# 查看已配置的模型列表
claude-code cc list

# 切换到 opus 模型
claude-code cc switch opus

切换后，所有后续的 chat、code 请求都会走新的模型。模型切换是即时生效的，无需重启终端。

4. 高级功能

4.1 使用自定义系统提示

Claude Code 允许你为每次交互提供系统提示，帮助模型更好地理解上下文。

1

claude-code chat "请把以下代码优化为函数式风格" --system "使用 Python 3.11，遵循 PEP 8" 

4.2 保存会话历史

1

claude-code history save my_session.json

会将本次对话保存为 JSON，便于后续审查或重放。

4.3 与 Git 集成

Claude Code 还能直接在 Git 提交信息中调用模型生成规范化的提交说明。

1

git commit -m "$(claude-code gitmsg)"

这样可以让提交信息更具可读性，符合团队规范。

5. 常见问题排查

• 命令找不到：确认 Homebrew 或 pip 已加入系统 PATH，或使用绝对路径如 ~/.local/bin/claude-code。

• 命令找不到：确认 Homebrew 或 pip 已加入系统 PATH，或使用绝对路径如 ~/.local/bin/claude-code。

• 模型切换无效：查看 ~/.claude-code/config.yaml 中的 default_model 是否被覆盖，必要时手动编辑。
• 网络超时：Claude 依赖 Anthropic API，确保机器能够正常访问 api.anthropic.com，并且 API Key 已正确配置 (export ANTHROPIC_API_KEY=your_key).

6. 小结

Claude Code 为代码工作流提供了强大的 AI 助手能力，从快速原型到深度调试，都能显著提升效率。掌握安装、基本命令以及模型切换，你就可以在日常开发中随时调用 Claude 的智慧。

老板：如果还有其他需求，随时告诉小H，我会帮你进一步定制 Claude Code 的使用方案。

abbrlink: 12833