Claude Code 安装与使用指南

目录

• 简介
• 安装流程
• 启动与使用
• 常见问题解决
• 国内模型接入
• 常用功能清单
• 使用示例
• 模型管理工具
• 国内模型兼容平台

简介

Claude Code 是 Anthropic 推出的命令行工具，让开发者可以在终端中使用 Claude AI 进行编程、代码审查、自动化任务等。

安装流程

1. 环境准备

• 安装 Node.js 环境（建议使用 LTS 版本）
• 确保系统已安装 npm（Node.js 包管理器）

2. 安装 Claude Code

# 全局安装 Claude Code
npm install @anthropic-ai/claude-code -g

3. 验证安装

# 检查版本
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 acceptEdits

3. 工具限制与允许

# 限制只使用特定工具
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-name

2. 技能链式调用

# 组合使用多个技能
claude "使用 code-review 技能审查代码，然后使用 simplify 技能优化"

3. 技能参数配置

# 为技能传递参数
/simplify --max-iterations 5

🚀 性能优化技巧

1. 模型选择策略

# 根据任务复杂度选择模型
claude --model sonnet "简单任务"
claude --model opus "复杂任务"

2. 令牌管理

# 设置最大输出令牌数
claude --max-tokens 4000 "生成详细文档"

# 设置最大预算
claude --max-budget-usd 0.5 "复杂分析任务"

3. 并行任务处理

# 启动多个子代理并行处理
claude "同时分析多个文件"

🔗 集成与扩展

1. MCP 服务器集成

# 配置 MCP 服务器
claude --mcp-config "path/to/mcp-config.json"

# 查看 MCP 服务器状态
/mcp list

2. 插件系统

# 安装新插件
/plugin install plugin-name

# 管理插件
/plugin list
/plugin update
/plugin remove

3. 自定义代理（Agents）

# 定义自定义代理
claude --agents '{"reviewer": {"description": "代码审查专家", "prompt": "你是一个资深的代码审查专家..."}}'

# 使用自定义代理
claude --agent reviewer "审查这段代码"

📊 批量处理与自动化

1. 批量文件处理

# 处理多个文件
claude "分析目录下的所有 .py 文件"

2. 自动化脚本

#!/bin/bash
# 自动化脚本示例
claude -p "生成项目文档" > docs.md
claude -p "运行测试" && echo "测试通过"

3. 工作流自动化

# 定义复杂工作流
claude "从代码审查到部署的完整流程"

🛡️ 安全与最佳实践

1. 安全配置

# 限制网络访问
claude --disable-slash-commands

# 沙箱模式
claude --sandbox

2. 日志与调试

# 启用调试模式
claude --debug

# 写入调试日志
claude --debug-file /path/to/debug.log

3. 会话管理

# 导出会话
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 的强大功能，适用于更复杂的开发场景和专业需求。