什么是 Claude Code?

Claude Code 是 Anthropic 开发的 命令行 AI 编程助手,可通过自然语言指令完成代码生成、bug 修复、文档生成等开发任务。它支持直接操作终端、理解代码库结构,适合从新手到专业开发者的各类用户。

Claude Code 的核心优势

  • 自然语言交互,无需学习复杂指令
  • 支持多种编程语言和框架
  • 可直接操作文件系统和终端
  • 智能理解项目结构和上下文
  • 支持多种 AI 模型切换

准备工作

环境要求

  • 操作系统: macOS 10.15+ / Ubuntu 20.04+ / Windows(需通过 WSL)
  • 依赖工具:

安装 Node.js

# 验证安装(安装后)
node --version  # 需显示v18.0.0以上版本
npm --version    # 需显示8.0.0以上版本

灵芽API平台配置

注册与登录

  1. 访问灵芽API官网:https://api.lingyaai.cn
  2. 点击右上角注册,使用邮箱完成账号创建
  3. 登录后进入个人中心

获取API密钥

  1. 进入API令牌页面(左侧菜单)
  2. 点击创建令牌,输入名称(如"ClaudeCode")
  3. 复制生成的API Key(格式:sk-xxxxxxxxxxxxxxxx),立即保存

充值API额度

  1. 进入钱包页面
  2. 选择充值金额
  3. 充值后额度实时到账,无有效期限制

Claude Code 安装与配置

安装 Claude Code

# 全局安装(无需sudo)
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version  # 显示版本号即成功

配置灵芽API

步骤1:创建配置目录和文件

# 进入项目根目录
cd 你的项目文件夹

# 创建配置目录和文件
mkdir -p .claude && touch .claude/settings.json

步骤2:编辑配置文件

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的灵芽API密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
  },
  "permissions": {
    "allowedTools": ["Edit", "Bash(git:*)", "Test"]
  }
}

多模型调用指南

支持的模型列表

模型名称 适用场景 特点
claude-sonnet-4-20250514 代码生成、复杂推理、200K上下文 平衡速度与性能
cc-sonnet-4-20250514 代码生成、复杂推理、200K上下文 专用版,价格实惠
qwen3-coder-480b-a35b-instruct 专业编程、256K长上下文 开源最强代码模型
kimi-k2-instruct 专业编程、128K长上下文 开源模型

动态切换模型

方法一:命令行切换

# 在Claude Code会话中输入
/model qwen3-coder-480b-a35b-instruct

方法二:代码中指定模型

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的灵芽API密钥",
    base_url="https://api.lingyaai.cn/v1"
)

# 调用Qwen3-Coder
response = client.chat.completions.create(
    model="qwen3-coder-480b-a35b-instruct",
    messages=[{"role": "user", "content": "生成一个Python冒泡排序函数"}]
)
print(response.choices[0].message.content)

# 调用Claude Sonnet 4
response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "解释这段代码的时间复杂度"}]
)
print(response.choices[0].message.content)

基础使用示例

启动 Claude Code

# 进入项目目录
cd 你的项目文件夹

# 启动交互模式
claude

常用命令

命令 功能
/help 查看帮助菜单
/clear 清空对话历史
/model [模型名] 切换模型
/permissions 管理文件操作权限

代码生成示例

输入指令

帮我生成一个Python函数,实现斐波那契数列,要求包含注释和异常处理

输出结果

def fibonacci(n):
    """
    计算斐波那契数列第n项
    
    参数:
        n (int): 数列索引(从0开始)
        
    返回:
        int: 第n项斐波那契数
        
    异常:
        ValueError: 当n为负数时抛出
    """
    if not isinstance(n, int):
        raise TypeError("n必须是整数")
    if n < 0:
        raise ValueError("n不能为负数")
    
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

# 测试
try:
    print(fibonacci(10))  # 输出55
    print(fibonacci(-1))  # 触发异常
except ValueError as e:
    print(f"错误: {e}")

实用小贴士

复制粘贴技巧

终端中 Ctrl+Shift+C/V 粘贴,macOS 用 Cmd 替代 Ctrl

命令错误处理

出现 command not found 时,重新检查拼写和安装步骤

求助渠道

灵芽API客服QQ:3994851296,发送问题截图更快解决

学习资源

推荐观看B站"Claude Code零基础入门"系列视频