diff --git a/docs/integrations/Development-Tools/claude-code.md b/docs/integrations/Development-Tools/claude-code.md index 21cd14f341eabfaa815a1ae826e471577e3c6287..39be56719e113a8032e70133edab5727adfeec09 100644 --- a/docs/integrations/Development-Tools/claude-code.md +++ b/docs/integrations/Development-Tools/claude-code.md @@ -4,109 +4,228 @@ sidebar_position: 7 # Claude Code -Claude Code 是 Anthropic 推出的 AI 编程助手,我们的平台为开发者提供了完整的 Claude Code 集成解决方案,让您能够无缝地将 Claude Code 与各种模型提供商连接,实现灵活的 AI 编程助手体验。通过我们的集成方案,您可以享受 Anthropic 的最新更新,同时保持对模型交互方式的完全控制。 +Claude Code 是 Anthropic 推出的 AI 编程助手工具。跟着这个教程,你可以轻松在自己的电脑上安装并使用 Claude Code。 -### 配置指南 +## 1. 安装 Node.js 环境 -Serverless API 支持在 Claude Code 中调用,使用步骤如下: +Claude Code 需要 Node.js 环境才能运行。 -1. 安装 Claude Code 和集成工具 +### Windows 安装方法 - 首先,确保您的开发环境已安装 Claude Code: +**方法一:官网下载(推荐)** - ```bash - npm install -g @anthropic-ai/claude-code - ``` +1. 打开浏览器访问 https://nodejs.org/ +2. 点击 "LTS" 版本进行下载(推荐长期支持版本) +3. 下载完成后双击 .msi 文件 +4. 按照安装向导完成安装,保持默认设置即可 - 然后安装 Claude Code Router 作为集成工具: +**方法二:使用包管理器** - ```bash - npm install -g @musistudio/claude-code-router - ``` +如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装: -2. 获取模力方舟访问令牌 +```bash +# 使用 Chocolatey +choco install nodejs - 开发者首先需要访问 [**工作台->设置->访问令牌**]({{SITE_URL}}/dashboard/settings/tokens) 中获取访问令牌,没有购买 Serverless API 的开发者,可以使用免费体验访问令牌(仅供体验,每日调用次数有限),复制想要使用的令牌即可。 +# 或使用 Scoop +scoop install nodejs +``` - ![](/img/serverless-api/integrated/integrate14.png) +**Windows 注意事项** -3. 配置集成文件 +- 建议使用 PowerShell 而不是 CMD +- 如果遇到权限问题,尝试以管理员身份运行 +- 某些杀毒软件可能会误报,需要添加白名单 - 在您的主目录下创建配置文件 `~/.claude-code-router/config.json`, 并在 `api_key` 处替换为您的访问令牌: +### macOS 安装方法 - ```json showLineNumbers title="config.json" - { - "Providers": [ - { - "name": "gitee", +**方法一:官网下载(推荐)** - "api_base_url": "{{API_URL}}/v1/chat/completions", +1. 打开浏览器访问 https://nodejs.org/ +2. 点击 "LTS" 版本进行下载 +3. 下载完成后双击 .pkg 文件 +4. 按照安装向导完成安装 - "api_key": "your-api-key", - "models": ["kimi-k2-instruct"], - "transformer": { - "use": [ - [ - "maxtoken", - { - "max_tokens": 131072 - } - ] - ] - } - } - ], - "Router": { - "default": "gitee,kimi-k2-instruct", - "background": "gitee,kimi-k2-instruct", - "think": "gitee,kimi-k2-instruct", - "longContext": "gitee,kimi-k2-instruct" - }, - "APIKEY": "your-secret-key", - "LOG": true, - "HOST": "0.0.0.0" - } - ``` +**方法二:使用 Homebrew** -4. 启动集成服务 +```bash +# 安装 Homebrew(如果尚未安装) +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 通过我们的集成方案启动 Claude Code: +# 使用 Homebrew 安装 Node.js +brew install node +``` - ```bash - ccr code - ``` +### Linux / WSL2 安装方法 - ![](/img/serverless-api/integrated/claude-code-integrate.png) +**使用包管理器安装** -5. 在 Claude Code 中使用模力方舟 +Ubuntu/Debian: - 至此,开发者便可以在 Claude Code 中调用来自模力方舟的模型了。您还可以在开发过程中实时切换模型: +```bash +# 更新包列表 +sudo apt update - ``` - /model gitee,kimi-k2-instruct - ``` +# 安装 Node.js 和 npm +sudo apt install nodejs npm +``` - ![](/img/serverless-api/integrated/claude-code-checkout-model.png) +CentOS/RHEL/Fedora: -### 配置参数说明 +```bash +# 对于 CentOS/RHEL +sudo yum install nodejs npm -- **APIKEY** (可选): 设置密钥以验证请求 -- **PROXY_URL** (可选): 为 API 请求设置代理 -- **LOG** (可选): 启用日志记录,日志文件将位于 `$HOME/.claude-code-router.log` -- **HOST** (可选): 设置服务器的主机地址 +# 对于 Fedora +sudo dnf install nodejs npm +``` -### 智能路由配置 +### 验证安装是否成功 -路由配置定义了不同场景下使用的模型: +安装完成后,打开终端(Windows 使用 PowerShell),输入以下命令: -- **default**: 默认模型,如果没有配置其他路由,将用于所有请求 -- **background**: 后台任务使用的模型 -- **think**: 思考任务使用的模型 -- **longContext**: 长上下文任务使用的模型 +```bash +node --version +npm --version +``` -### 更多资源 +如果显示版本号,说明安装成功了! + +## 2. 安装 Claude Code + +打开终端(Windows 使用 PowerShell),运行以下命令: + +```bash +# 全局安装 Claude Code +npm install -g @anthropic-ai/claude-code +``` + +这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。 + +**提示** + +- Windows 用户建议使用 PowerShell 而不是 CMD,功能更强大 +- 如果遇到权限问题,以管理员身份运行 PowerShell + +### 验证 Claude Code 安装 + +安装完成后,输入以下命令检查是否安装成功: + +```bash +claude --version +``` + +如果显示版本号,恭喜你!Claude Code 已经成功安装了。 + +## 3. 获取访问令牌 + +开发者首先需要访问 [**工作台->设置->访问令牌**]({{SITE_URL}}/dashboard/settings/tokens) 中获取访问令牌,没有购买 Serverless API 的开发者,可以使用免费体验访问令牌(仅供体验,每日调用次数有限),复制想要使用的令牌即可。 + +![](/img/serverless-api/integrated/integrate14.png) + +## 4. 配置环境变量 + +为了让 Claude Code 连接到我们的服务,需要设置相关环境变量。 + +**推荐模型**:目前 `kimi-k2-instruct` 和 `GLM-4_5` 两个模型效果最佳,建议优先使用。 + +### Windows (PowerShell) + +**临时设置(当前会话)** + +```powershell +$env:ANTHROPIC_BASE_URL = "https://ai.gitee.com/anthropic" +$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥" +$env:ANTHROPIC_MODEL = "GLM-4_5" +$env:ANTHROPIC_SMALL_FAST_MODEL = "GLM-4_5" +``` + +**永久设置(用户级)** + +```powershell +# 设置用户级环境变量(永久生效) +[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.gitee.com/anthropic", [System.EnvironmentVariableTarget]::User) +[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User) +[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "GLM-4_5", [System.EnvironmentVariableTarget]::User) +[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "GLM-4_5", [System.EnvironmentVariableTarget]::User) +``` + +### macOS / Linux / WSL2 +**临时设置(当前会话)** + +```bash +export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic" +export ANTHROPIC_AUTH_TOKEN="你的API密钥" +export ANTHROPIC_MODEL="GLM-4_5" +export ANTHROPIC_SMALL_FAST_MODEL="GLM-4_5" +``` + +**永久设置** + +将以下内容添加到 `~/.bashrc` 或 `~/.zshrc` 文件中: + +```bash +export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic" +export ANTHROPIC_AUTH_TOKEN="你的API密钥" +export ANTHROPIC_MODEL="GLM-4_5" +export ANTHROPIC_SMALL_FAST_MODEL="GLM-4_5" +``` + +然后重新加载配置文件: + +```bash +# 如果使用 bash +source ~/.bashrc + +# 如果使用 zsh +source ~/.zshrc +``` + +**重要提示**:记得将 "你的API密钥" 替换为在上方 "获取访问令牌" 步骤中获取的实际密钥。 + +### 验证环境变量设置 + +**Windows (PowerShell)** + +```powershell +echo $env:ANTHROPIC_BASE_URL +echo $env:ANTHROPIC_AUTH_TOKEN +echo $env:ANTHROPIC_MODEL +echo $env:ANTHROPIC_SMALL_FAST_MODEL +``` + +**macOS / Linux / WSL2** + +```bash +echo $ANTHROPIC_BASE_URL +echo $ANTHROPIC_AUTH_TOKEN +echo $ANTHROPIC_MODEL +echo $ANTHROPIC_SMALL_FAST_MODEL +``` + +预期输出示例: + +``` +https://ai.gitee.com/anthropic +你的API密钥 +GLM-4_5 +GLM-4_5 +``` + +💡 如果输出为空或显示变量名本身,说明环境变量设置失败,请重新设置。设置后需要重新打开终端窗口才能生效。 + +## 5. 开始使用 Claude Code + +配置完成后,你就可以开始使用 Claude Code 了!在任何目录下运行: + +```bash +claude +``` + +这将启动 Claude Code 交互界面,你可以开始与 AI 编程助手进行对话了。 + +### 更多资源 - [平台 API 文档](/docs/openapi/v1) - [Claude Code 官方文档](https://docs.anthropic.com/claude/docs) -- [集成工具 GitHub 仓库](https://github.com/musistudio/claude-code-router)