Claude Code 安装与配置全指南 | 灵芽 API 接入 Windows/macOS/Linux 教程

什么是 Claude Code？

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

                        ✨ Claude Code 的核心优势
                        自然语言交互：无需学习复杂的命令，用日常语言即可操作
多语言支持：支持 Python、JavaScript、Java、Go、Rust 等主流编程语言
文件系统操作：可直接读写文件、执行终端命令
智能上下文理解：自动理解项目结构和代码关联
多模型切换：支持 Claude Sonnet 4、Qwen3-Coder、Kimi-K2 等多种模型
国内高速访问：通过灵芽 API 提供稳定的国内中转服务

                    

适用场景

快速生成代码框架和函数
代码审查和优化建议
Bug 调试和错误修复
编写技术文档和注释
重构和代码重写
学习新的编程语言和框架

系统要求

为了确保 Claude Code 能够稳定运行，请确保您的开发环境满足以下基本要求：

✅ 通用核心要求（所有平台）

Node.js: 18.0+ 版本（推荐使用 LTS 长期支持版本）
npm: 8.0+ 版本（Node.js 自带）
网络连接: 稳定的互联网连接以访问灵芽 API 服务
灵芽 API 账户: 需要在 api.lingyaai.cn 注册账户并获取 API 密钥

📋 各平台具体要求

平台	最低版本	推荐配置
🪟 Windows	Windows 10	Windows 11 + PowerShell 7+
🍎 macOS	macOS 10.15 (Catalina)	macOS 12+ (Monterey)
🐧 Linux	Ubuntu 18.04 / Debian 9	Ubuntu 22.04 / Debian 11

提示

建议使用最新版本的 Node.js LTS 以获得最佳性能和兼容性。您可以从 Node.js 官网下载安装包。

Claude Code 安装与配置

🪟 Windows 平台安装教程

安装 Node.js
方法一：官方安装包（推荐）
- 访问 Node.js 官网
- 下载 LTS（长期支持） 版本的 Windows 安装程序（.msi 文件）
- 双击安装包，按照向导完成安装（保持默认选项即可）
方法二：使用 Winget 包管理器
```
# 在 PowerShell 或 CMD 中运行
winget install OpenJS.NodeJS.LTS
```
验证安装

安装完成后，打开新的命令提示符（CMD）或 PowerShell 窗口，运行以下命令：
```
node --version
npm --version
```
如果显示版本号（如 v18.x.x 和 8.x.x），说明安装成功。
安装 Claude Code CLI
以管理员身份运行命令提示符或 PowerShell，执行以下命令：
```
npm install -g @anthropic-ai/claude-code
```
安装完成后验证：
```
claude --version
```
权限问题

如果遇到权限错误，请确保以管理员身份运行命令行。右键点击"命令提示符"或"PowerShell"，选择"以管理员身份运行"。
获取灵芽 API 密钥
- 访问灵芽 API 控制台 - 令牌管理
- 登录您的账户（如无账户请先注册）
- 点击 创建新令牌
- 在选择分组下拉菜单中选择 Claude Code 专用分组
- 填写令牌名称（例如："Windows Claude Code"）
- 点击创建按钮
- 复制生成的 API 密钥（格式：sk-xxxxxxxxxx）
安全提示

API 密钥仅显示一次，请立即保存到安全位置。不要将密钥分享给他人或上传到公开的代码仓库。
配置 Claude Code
创建配置文件路径：%USERPROFILE%\.claude\settings.json

使用记事本创建配置文件：
```
# 在 PowerShell 中运行
mkdir $env:USERPROFILE\.claude -Force
notepad $env:USERPROFILE\.claude\settings.json
```
在打开的记事本中，粘贴以下配置：
```
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴您的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn"
  }
}
```
保存文件后关闭记事本。
重要说明
- 将 ANTHROPIC_AUTH_TOKEN 的值替换为您实际的 API 密钥
- 确保 JSON 格式正确，注意引号和逗号
- 创建令牌时必须选择 Claude Code 专用分组
启动与使用
打开命令提示符或 PowerShell，进入您的项目目录：
```
cd C:\path\to\your\project
claude
```
首次运行时，Claude Code 会进行初始化配置。按照提示操作即可。

成功标志

如果看到 Claude Code 的欢迎界面和命令提示符，说明配置成功！您现在可以开始使用 AI 编程助手了。

🍎 macOS 平台安装教程

安装 Node.js

方法一：使用 Homebrew（推荐）

# 如果未安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

方法二：官方安装包

访问 Node.js 官网
下载 macOS 安装包（.pkg 文件）
双击安装包，按照向导完成安装

验证安装

node --version
npm --version

安装 Claude Code CLI
打开终端（Terminal），执行：
```
npm install -g @anthropic-ai/claude-code
```
验证安装：
```
claude --version
```
获取灵芽 API 密钥
- 访问灵芽 API 控制台
- 选择 Claude Code 专用分组
- 创建令牌并复制 API 密钥

配置 Claude Code

创建配置文件：~/.claude/settings.json

# 创建目录和文件
mkdir -p ~/.claude
nano ~/.claude/settings.json

在编辑器中输入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴您的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn"
  }
}

按 Ctrl + X，然后按 Y 保存，按 Enter 退出。

启动与使用
```
cd ~/your-project
claude
```

🐧 Linux 平台安装教程

安装 Node.js

Ubuntu / Debian:

# 使用 NodeSource 获取最新版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

CentOS / RHEL:

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

Fedora:

sudo dnf install nodejs

安装 Claude Code CLI

sudo npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

获取灵芽 API 密钥
- 访问灵芽 API 控制台
- 选择 Claude Code 专用分组
- 创建令牌并复制密钥

配置 Claude Code

mkdir -p ~/.claude
nano ~/.claude/settings.json

输入配置内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴您的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn"
  }
}

保存并退出编辑器。

启动与使用
```
cd ~/your-project
claude
```

支持的模型列表

灵芽 API 为 Claude Code 提供专用的令牌分组，支持以下最新 AI 模型：

模型名称	模型类型	上下文长度	适用场景
`claude-sonnet-4-20250514`	Claude Sonnet 4	200K tokens	代码生成、复杂推理、长文本处理
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	200K tokens	最新版本，性能更强
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	200K tokens	快速响应、轻量级任务

模型切换方法

方法一：在配置文件中指定默认模型

编辑 ~/.claude/settings.json（Windows: %USERPROFILE%\.claude\settings.json）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "您的 API 密钥",
    "ANTHROPIC_BASE_URL": "https://api.lingyaai.cn",
    "ANTHROPIC_MODEL": "claude-haiku-4-5-20251001"
  }
}

方法二：启动时指定模型

claude --model claude-haiku-4-5-20251001

方法三：在对话中动态切换

/model claude-haiku-4-5-20251001

                        🎯 模型选择建议
                        日常代码生成：推荐 claude-haiku-4-5-20251001 （性价比高）
复杂架构设计：推荐 claude-sonnet-4-20250514	（综合最优）
快速问答：推荐 claude-haiku-4-5-20251001（响应快）
大型项目重构：推荐 claude-sonnet-4-5-20250929（能力最强）

                    

VSCode 插件配置教程

如果您希望在 Visual Studio Code 中使用 Claude Code 插件，可以参考以下详细配置步骤。

第一步：在 VS Code 中配置环境变量

1

安装并启用 Claude Code 插件

打开 VSCode 的 扩展商店（侧边栏图标或按 Ctrl+Shift+X）
在搜索框中输入 Claude Code
找到官方插件后，点击安装按钮
安装完成后，插件会自动启用

2

打开 VSCode 设置 JSON 文件

按快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）
在命令面板中输入 Preferences: Open Settings (JSON)
选择该选项打开 settings.json 文件

VS Code 设置 JSON 文件打开方式

3

添加 API 环境变量配置

在 settings.json 文件中添加以下配置（请替换为您的实际密钥）：

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "你的APIkey"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.lingyaai.cn"
    }
  ]
}

环境变量配置示例图

🔑 配置参数说明

ANTHROPIC_AUTH_TOKEN：您从灵芽 API 控制台获取的 API 访问令牌（SK 密钥）
ANTHROPIC_BASE_URL：灵芽 API 的请求地址，固定为 https://api.lingyaai.cn

注意：创建 API 令牌时，请确保选择了 Claude Code 专用分组，以保证最佳兼容性。

第三步：重启 VSCode 并开始使用

完全关闭 VSCode，然后重新打开
打开任意项目文件夹
点击侧边栏的 Claude Code 图标，或使用快捷键激活
开始与 AI 助手对话，进行代码生成、审查等操作

常见配置问题

插件无法连接：检查 API 密钥是否正确，确认没有多余空格
配置不生效：确保已重启 VSCode，配置文件路径正确
API 地址错误：ANTHROPIC_BASE_URL 不要添加 /v1 后缀
权限问题：Windows 用户确保 .claude 目录有读写权限

配置成功标志

如果配置正确，您将在 VSCode 中看到 Claude Code 插件的欢迎界面，并能正常发送消息接收 AI 响应。您可以尝试简单的指令如"生成一个 Python Hello World 程序"来测试功能。

基础使用示例

常用命令

命令	功能	示例
`/help`	查看帮助菜单和所有可用命令	`/help`
`/clear`	清空当前对话历史	`/clear`
`/model`	切换 AI 模型	`/model claude-haiku-4-5-20251001`
`/permissions`	管理文件操作权限	`/permissions`
`/exit`	退出 Claude Code	`/exit`

代码生成示例

示例 1：生成带注释的函数

输入指令：

帮我生成一个 Python 函数，实现快速排序算法，要求包含详细注释和类型提示

AI 输出示例：

def quick_sort(arr: list[int]) -> list[int]:
    """
    快速排序算法实现
    
    参数:
        arr: 待排序的整数列表
    
    返回:
        排序后的列表
    
    时间复杂度: O(n log n) 平均情况
    空间复杂度: O(log n) 递归栈空间
    """
    if len(arr) <= 1:
        return arr
    
    # 选择基准值（这里选择中间元素）
    pivot = arr[len(arr) // 2]
    
    # 分区：小于、等于、大于基准值的元素
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    
    # 递归排序并合并
    return quick_sort(left) + middle + quick_sort(right)

# 测试
if __name__ == "__main__":
    test_arr = [64, 34, 25, 12, 22, 11, 90]
    sorted_arr = quick_sort(test_arr)
    print(f"原数组: {test_arr}")
    print(f"排序后: {sorted_arr}")

示例 2：代码重构

输入指令：

重构以下代码，使其更符合 PEP 8 规范并提高可读性：

def calc(a,b,op):
    if op=='+':
        return a+b
    elif op=='-':
        return a-b
    elif op=='*':
        return a*b
    elif op=='/':
        return a/b

AI 输出示例：

from typing import Union

def calculate(
    operand_a: Union[int, float], 
    operand_b: Union[int, float], 
    operator: str
) -> Union[int, float]:
    """
    执行基本算术运算
    
    参数:
        operand_a: 第一个操作数
        operand_b: 第二个操作数
        operator: 运算符 ('+', '-', '*', '/')
    
    返回:
        运算结果
    
    异常:
        ValueError: 当运算符无效时
        ZeroDivisionError: 当除数为 0 时
    """
    operations = {
        '+': lambda a, b: a + b,
        '-': lambda a, b: a - b,
        '*': lambda a, b: a * b,
        '/': lambda a, b: a / b,
    }
    
    if operator not in operations:
        raise ValueError(f"不支持的运算符: {operator}")
    
    if operator == '/' and operand_b == 0:
        raise ZeroDivisionError("除数不能为零")
    
    return operations[operator](operand_a, operand_b)

# 使用示例
try:
    result = calculate(10, 5, '+')
    print(f"结果: {result}")
except (ValueError, ZeroDivisionError) as e:
    print(f"错误: {e}")

示例 3：生成单元测试

输入指令：

为上面的 calculate 函数生成完整的 pytest 单元测试

AI 输出示例：

import pytest
from your_module import calculate

class TestCalculate:
    """calculate 函数的单元测试"""
    
    def test_addition(self):
        """测试加法运算"""
        assert calculate(10, 5, '+') == 15
        assert calculate(-3, 7, '+') == 4
        assert calculate(0, 0, '+') == 0
    
    def test_subtraction(self):
        """测试减法运算"""
        assert calculate(10, 5, '-') == 5
        assert calculate(5, 10, '-') == -5
        assert calculate(0, 5, '-') == -5
    
    def test_multiplication(self):
        """测试乘法运算"""
        assert calculate(10, 5, '*') == 50
        assert calculate(-3, 4, '*') == -12
        assert calculate(0, 100, '*') == 0
    
    def test_division(self):
        """测试除法运算"""
        assert calculate(10, 5, '/') == 2.0
        assert calculate(7, 2, '/') == 3.5
        assert calculate(0, 5, '/') == 0.0
    
    def test_division_by_zero(self):
        """测试除以零的异常处理"""
        with pytest.raises(ZeroDivisionError, match="除数不能为零"):
            calculate(10, 0, '/')
    
    def test_invalid_operator(self):
        """测试无效运算符的异常处理"""
        with pytest.raises(ValueError, match="不支持的运算符"):
            calculate(10, 5, '%')
        
        with pytest.raises(ValueError, match="不支持的运算符"):
            calculate(10, 5, 'invalid')
    
    def test_float_operations(self):
        """测试浮点数运算"""
        assert calculate(10.5, 2.5, '+') == 13.0
        assert calculate(10.5, 2.5, '*') == 26.25

常见问题 FAQ

Q1: 为什么需要选择 Claude Code 专用分组？

A: 不同的工具（Claude Code、CodeX、Gemini CLI）对 API 的调用方式和参数要求不同。灵芽 API 为每个工具提供了专门优化的分组，确保最佳的兼容性和性能。使用错误的分组可能导致：

API 调用失败或返回错误
模型响应格式不兼容
功能受限或异常行为
计费异常

因此，创建 API 令牌时，务必选择对应工具的专用分组。

Q2: 安装时提示 "command not found" 怎么办？

A: 这通常是因为 Node.js 或 npm 未正确安装，或环境变量未配置。请按以下步骤排查：

验证 Node.js 安装：
```
node --version
npm --version
```
如果显示版本号，说明已安装。
重新安装 Node.js：如果未安装或版本过低，请访问 nodejs.org 下载最新 LTS 版本。
检查环境变量（Windows）：
- 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
- 确认 PATH 中包含 Node.js 安装路径（如 C:\Program Files\nodejs\）
重启终端：环境变量修改后需重新打开命令行窗口。

Q3: 配置后无法连接 API，提示认证失败？

A: 请检查以下几点：

API 密钥正确性：
- 确认密钥以 sk- 开头
- 检查是否完整复制（无遗漏、无多余空格）
- 尝试重新生成一个新密钥
分组选择：创建令牌时必须选择 Claude Code 专用分组
配置文件格式：
- JSON 格式必须正确（引号、逗号、括号）
- 文件编码为 UTF-8
- 文件路径正确（~/.claude/settings.json）
网络连接：确保可以访问 api.lingyaai.cn

Q4: Windows 下提示权限不足怎么办？

A: 全局安装 npm 包需要管理员权限。解决方法：

方法一：右键"命令提示符"或"PowerShell"，选择"以管理员身份运行"

方法二：配置 npm 使用用户目录（无需管理员权限）：

# 配置 npm 全局安装路径
npm config set prefix "%USERPROFILE%\npm-global"

# 添加到环境变量 PATH
# 将 %USERPROFILE%\npm-global 添加到系统 PATH

Q5: 如何查看 API 使用情况和余额？

A: 登录灵芽 API 控制台，在仪表板中可以查看：

当前账户余额
API 调用统计（次数、tokens 消耗）
费用明细和账单
各模型使用分布

Q6: 支持哪些编程语言？

A: Claude Code 支持几乎所有主流编程语言，包括但不限于：

Python
JavaScript / TypeScript
Java
C / C++

Go
Rust
PHP
Ruby

Swift
Kotlin
C#
Shell Script

Q7: Claude Code 会修改我的文件吗？需要授权吗？

A: 是的，Claude Code 有文件操作权限，但需要您的明确授权：

首次操作：会询问是否允许读取/写入文件
权限管理：可以通过 /permissions 命令查看和管理权限
安全建议：
- 在重要项目中使用前，先在测试项目中熟悉
- 使用版本控制（Git）保护代码，便于回滚
- 对敏感操作保持警惕，仔细审查 AI 建议的修改

Q8: 可以在公司项目中使用吗？会泄露代码吗？

A: 关于数据安全和隐私：

                        🔒 隐私保护说明
                        灵芽 API：作为中转服务，不会存储或记录您的代码内容
Anthropic 官方政策：API 调用的数据不用于模型训练
最佳实践：
                                避免在代码中硬编码敏感信息（密钥、密码等）
不要分享包含商业机密的完整代码库
咨询公司 IT 部门确认使用 AI 工具的政策
考虑使用企业版方案（如需更高安全级别）

                            

                    

Q9: 遇到错误提示 "rate limit exceeded" 怎么办？

A: 这表示达到了 API 调用频率限制。解决方法：

等待片刻：通常 1-2 分钟后自动恢复
检查余额：确认账户有足够的额度
优化使用：
- 减少不必要的连续请求
- 使用 /clear 清除长对话历史
- 选择更经济的模型（如 Haiku 代替 Sonnet）
升级方案：联系客服了解更高频率限制的方案

Q10: 如何卸载 Claude Code？

A: 完整卸载步骤：

# 1. 卸载全局包
npm uninstall -g @anthropic-ai/claude-code

# 2. 删除配置文件
# Windows:
rmdir /s /q %USERPROFILE%\.claude

# macOS/Linux:
rm -rf ~/.claude

# 3. 验证卸载
claude --version  # 应提示 command not found

VSCode 插件卸载

如果安装了 VSCode 插件，在扩展面板中找到 Claude Code，点击卸载按钮即可。

实用技巧与最佳实践

提高效率的技巧

明确的指令：越具体的要求，AI 输出质量越高

❌ 不好: "写个排序函数"
✅ 好: "用 Python 写一个归并排序函数，包含类型提示和文档字符串"

分步骤操作：复杂任务拆分成多个小步骤

1. 先让 AI 设计整体架构
2. 再逐个实现各模块
3. 最后生成测试代码

利用上下文：Claude Code 会记住对话历史，可以引用之前的内容
```
"基于刚才的函数，再写一个性能优化版本"
```

代码质量提升

要求最佳实践：

"用 Python 写一个 REST API 客户端，遵循 PEP 8 规范，包含错误处理和重试机制"

代码审查：

"审查以下代码，指出潜在的 bug、性能问题和改进建议：
[粘贴您的代码]"

添加测试：

"为上面的类生成完整的 pytest 单元测试，覆盖率达到 90% 以上"

安全注意事项

敏感信息处理：
- 不要在代码中硬编码 API 密钥、数据库密码
- 使用环境变量或配置文件管理敏感信息
- 审查 AI 生成的代码，确保没有安全漏洞
版本控制：
- 始终使用 Git 等版本控制系统
- 在让 AI 修改代码前先提交当前版本
- 便于出错时快速回滚

                        💡 高级使用技巧
                        模型选择策略：
                                快速问答：使用 claude-haiku-4-5-20251001
复杂架构设计：使用 claude-sonnet-4-5-20250929
大量代码生成：使用 claude-sonnet-4-20250514

                            
批量操作：
                                "遍历 src/ 目录下所有 .py 文件，为每个函数添加 docstring"
                            
学习新技术：
                                "我想学习 FastAPI，帮我从零开始构建一个 TODO API，逐步讲解每个概念"
                            

                    

快捷操作

操作	快捷方式
复制代码块	终端中选中 → `Ctrl+Shift+C` (Windows/Linux) / `Cmd+C` (macOS)
粘贴到终端	`Ctrl+Shift+V` (Windows/Linux) / `Cmd+V` (macOS)
中断 AI 响应	`Ctrl+C`
清屏	`clear` (macOS/Linux) / `cls` (Windows)

获取支持

如果您在使用 Claude Code 的过程中遇到任何问题，可以通过以下方式获取帮助：

客服支持

扫描下方二维码添加微信客服，工作日 9:00-22:00 在线响应

客服微信 1 号

备用客服

如客服 1 号繁忙，可添加备用客服微信获取支持

客服微信 2 号

📚 更多资源

官方网站: https://api.lingyaai.cn
API 文档: https://api.lingyaai.cn/doc/
价格列表: https://api.lingyaai.cn/modellist/
控制台: https://api.lingyaai.cn/console
完整配置教程: AI 编程工具配置指南

提交问题时请提供

您的操作系统和版本（Windows 10/11, macOS 版本, Linux 发行版）
Node.js 和 npm 版本（node --version 和 npm --version）
Claude Code 版本（claude --version）
完整的错误信息截图或文本
您执行的命令和配置文件内容（注意隐藏 API 密钥）

提供详细信息能帮助我们更快速地定位和解决问题！

Claude Code 完整配置教程

什么是 Claude Code？

✨ Claude Code 的核心优势

适用场景

系统要求

✅ 通用核心要求（所有平台）

📋 各平台具体要求

提示

Claude Code 安装与配置

🪟 Windows 平台安装教程

权限问题

安全提示

重要说明

成功标志

🍎 macOS 平台安装教程

🐧 Linux 平台安装教程

支持的模型列表

模型切换方法

🎯 模型选择建议

VSCode 插件配置教程

第一步：在 VS Code 中配置环境变量

安装并启用 Claude Code 插件

打开 VSCode 设置 JSON 文件

添加 API 环境变量配置

🔑 配置参数说明

第三步：重启 VSCode 并开始使用

常见配置问题

配置成功标志

基础使用示例

常用命令

代码生成示例

常见问题 FAQ

Q1: 为什么需要选择 Claude Code 专用分组？

Q2: 安装时提示 "command not found" 怎么办？

Q3: 配置后无法连接 API，提示认证失败？

Q4: Windows 下提示权限不足怎么办？

Q5: 如何查看 API 使用情况和余额？

Q6: 支持哪些编程语言？

Q7: Claude Code 会修改我的文件吗？需要授权吗？

Q8: 可以在公司项目中使用吗？会泄露代码吗？

🔒 隐私保护说明

Q9: 遇到错误提示 "rate limit exceeded" 怎么办？

Q10: 如何卸载 Claude Code？

VSCode 插件卸载

实用技巧与最佳实践

提高效率的技巧

代码质量提升

安全注意事项

💡 高级使用技巧

快捷操作

获取支持

客服支持

备用客服

📚 更多资源

提交问题时请提供