Claude Code 安装与使用指南
Claude Code 安装与使用指南
目录
- 简介
- 安装流程
- 启动与使用
- 常见问题解决
- 国内模型接入
- 常用功能清单
- 使用示例
- 模型管理工具
- 国内模型兼容平台
简介
Claude Code 是 Anthropic 推出的命令行工具，让开发者可以在终端中使用 Claude AI 进行编程、代码审查、自动化任务等。
安装流程
1. 环境准备
- 安装 Node.js 环境（建议使用 LTS 版本）
- 确保系统已安装 npm（Node.js 包管理器）
2. 安装 Claude Code
# 全局安装 Claude Codenpminstall@anthropic-ai/claude-code-g3. 验证安装
# 检查版本claude--version# 预期输出类似：# Claude Code v1.x.x启动与使用
基本启动方式
# 启动交互式对话（默认模式）claude# 启动并直接执行一次性任务claude"帮我修复这个构建错误"# 单次查询后立即退出（非交互模式）claude-p"解释这个函数的作用"# 继续当前目录最近的对话claude-c# 启动新会话（清除上下文）claude--new# 或 claude -n常用命令选项
| 选项 | 描述 | 示例 |
|---|---|---|
-p, --print | 非交互模式，执行后退出 | claude -p "解释这个函数" |
-c, --continue | 继续最近的对话 | claude -c |
-n, --new | 启动新会话 | claude -n |
--model | 指定模型 | claude --model sonnet |
--help | 显示帮助信息 | claude --help |
常见问题解决
连接 Anthropic 服务失败
错误信息：
Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST解决方法：
找到用户目录下的配置文件C:\Users\Administrator\.claude.json，添加以下配置：
{"hasCompletedOnboarding":true}国内模型接入
配置示例（以豆包为例）
在claude.json配置文件中添加以下配置：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API_TOKEN","ANTHROPIC_BASE_URL":"https://ark.cn-beijing.volces.com/api/compatible","ANTHROPIC_MODEL":"doubao-seed-2-0-pro-260215","CLAUDE_CODE_MAX_OUTPUT_TOKENS":"60000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1}}常用功能清单
📝 代码相关功能
- 代码生成与补全
- 代码审查与优化
- 代码解释与文档生成
- 错误调试与修复
- 代码重构建议
🔧 工具集成功能
- Git 操作助手
- 文件系统操作
- API 调用与集成
- 数据处理与分析
- 自动化脚本编写
🎯 交互模式
- 交互式对话
- 单次任务执行
- 会话管理
- 模型切换
- 输出格式控制
📚 技能（Skills）系统
code-review: 代码审查simplify: 代码简化与优化claude-api: Claude API 集成frontend-design: 前端设计- 自定义技能开发
使用示例
示例 1：代码审查
# 启动代码审查技能/code-review示例 2：代码简化
# 使用 simplify 技能优化代码/simplify示例 3：前端设计
# 使用前端设计技能/frontend-design示例 4：API 集成
# 使用 Claude API 技能/claude-api示例 5：文件操作
# 让 Claude 帮助处理文件claude"帮我读取并分析这个 JSON 文件"示例 6：Git 操作
# 让 Claude 帮助处理 Git 操作claude"帮我创建一个提交，描述是：修复登录功能"模型管理工具
CC-Switch
- GitHub: https://github.com/farion1231/cc-switch
- 功能：模型切换管理工具
Claude Code Router
- GitHub: https://github.com/musistudio/claude-code-router
- 功能：模型切换管理工具
- 备注：设置回环代理地址，保持 token 一致性
国内模型兼容平台
| 平台 | Base URL（Claude 兼容地址） | 兼容模型 | API Key 获取地址 | 备注 |
|---|---|---|---|---|
| 火山引擎方舟 | https://ark.cn-beijing.volces.com/api/coding https://ark.cn-beijing.volces.com/api/compatible | ark-code-latest、doubao-seed-code-preview-latest | https://console.volcengine.com/ark/region:ark+cn-beijing/apikey | 需开通 Coding Plan 订阅 |
| 阿里云百炼 | https://dashscope.aliyuncs.com/apps/anthropic | qwen3-coder-plus、qwen3.5-plus | https://bailian.console.aliyun.com | 通义千问系列编码模型 |
| 智谱 AI | https://open.bigmodel.cn/api/anthropic | glm-5、glm-4.7flash | https://open.bigmodel.cn/api/keys | 国内主流编码模型 |
| 月之暗面 Kimi | https://api.moonshot.ai/anthropic | kimi-k2.5、kimi-k2-thinking | https://platform.moonshot.cn/console/api-keys | 推理能力强 |
| DeepSeek | https://api.deepseek.com/anthropic | deepseek-chat、deepseek-reasoner | https://platform.deepseek.com/api_keys | 专注代码场景 |
| MiniMax | https://api.minimax.io/anthropic | MiniMax-M2.5 | https://platform.minimaxi.com/api-keys |
进阶用法
🔧 高级配置选项
1. 自定义系统提示（System Prompt）
# 启动时指定自定义系统提示claude --system-prompt"你是一个专业的Python开发专家..."# 在配置文件中设置默认系统提示# 在 claude.json 中添加：# "system-prompt": "你是一个专业的Python开发专家..."2. 权限模式控制
# 交互式权限确认模式claude --permission-mode interactive# 跳过权限确认（仅限可信环境）claude --dangerously-skip-permissions# 自动接受编辑（默认模式）claude --permission-mode acceptEdits3. 工具限制与允许
# 限制只使用特定工具claude --allowed-tools"Bash,Edit,Read"# 禁用特定工具claude --disallowed-tools"Bash(git:*)"# 禁用所有工具claude--tools""4. 输出格式控制
# JSON 格式输出claude-p"分析这段代码"--output-format json# 流式输出claude-p"生成代码"--output-format stream-json🧠 技能（Skills）高级用法
1. 技能开发与自定义
# 创建新技能/skill-creator"我想创建一个技能，用于自动化测试"# 查看已安装的技能/skills# 卸载技能/plugin uninstall skill-name2. 技能链式调用
# 组合使用多个技能claude"使用 code-review 技能审查代码，然后使用 simplify 技能优化"3. 技能参数配置
# 为技能传递参数/simplify --max-iterations5🚀 性能优化技巧
1. 模型选择策略
# 根据任务复杂度选择模型claude--modelsonnet"简单任务"claude--modelopus"复杂任务"2. 令牌管理
# 设置最大输出令牌数claude --max-tokens4000"生成详细文档"# 设置最大预算claude --max-budget-usd0.5"复杂分析任务"3. 并行任务处理
# 启动多个子代理并行处理claude"同时分析多个文件"🔗 集成与扩展
1. MCP 服务器集成
# 配置 MCP 服务器claude --mcp-config"path/to/mcp-config.json"# 查看 MCP 服务器状态/mcp list2. 插件系统
# 安装新插件/plugininstallplugin-name# 管理插件/plugin list /plugin update /plugin remove3. 自定义代理（Agents）
# 定义自定义代理claude--agents'{"reviewer": {"description": "代码审查专家", "prompt": "你是一个资深的代码审查专家..."}}'# 使用自定义代理claude--agentreviewer"审查这段代码"📊 批量处理与自动化
1. 批量文件处理
# 处理多个文件claude"分析目录下的所有 .py 文件"2. 自动化脚本
#!/bin/bash# 自动化脚本示例claude-p"生成项目文档">docs.md claude-p"运行测试"&&echo"测试通过"3. 工作流自动化
# 定义复杂工作流claude"从代码审查到部署的完整流程"🛡️ 安全与最佳实践
1. 安全配置
# 限制网络访问claude --disable-slash-commands# 沙箱模式claude--sandbox2. 日志与调试
# 启用调试模式claude--debug# 写入调试日志claude --debug-file /path/to/debug.log3. 会话管理
# 导出会话claude --export-session session.json# 导入会话claude --import-session session.json🎯 高级使用场景
1. 代码重构专家
# 使用技能进行大规模重构claude"重构这个项目，提高代码质量"2. 自动化测试生成
# 生成测试用例claude"为这个函数生成完整的测试套件"3. 文档自动化
# 自动生成文档claude"为这个项目生成 API 文档"4. 性能分析
# 分析代码性能claude"分析这段代码的性能瓶颈"💡 技巧与最佳实践
1. 提示工程技巧
- 使用具体的上下文和约束
- 提供示例和期望的输出格式
- 分步思考和验证
2. 资源管理
- 监控令牌使用情况
- 合理设置超时
- 优化输出长度
3. 错误处理
- 准备备用方案
- 设置合理的重试机制
- 监控 API 响应
这些进阶用法可以帮助你充分发挥 Claude Code 的强大功能，适用于更复杂的开发场景和专业需求。