From 3869999341fbc5a5f56f3316474f6751834fae6b Mon Sep 17 00:00:00 2001 From: franco <1787003204@q.comq> Date: Fri, 26 Sep 2025 10:33:55 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(integrations):=20=E6=9B=B4=E6=96=B0=20?= =?UTF-8?q?Claude=20Code=20=E5=AE=89=E8=A3=85=E4=B8=8E=E9=85=8D=E7=BD=AE?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Development-Tools/claude-code.md | 252 +++++++++++++----- 1 file changed, 180 insertions(+), 72 deletions(-) diff --git a/docs/integrations/Development-Tools/claude-code.md b/docs/integrations/Development-Tools/claude-code.md index 21cd14f..7ad0fa1 100644 --- a/docs/integrations/Development-Tools/claude-code.md +++ b/docs/integrations/Development-Tools/claude-code.md @@ -4,109 +4,217 @@ 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 注意事项** +- 建议使用 PowerShell 而不是 CMD +- 如果遇到权限问题,尝试以管理员身份运行 +- 某些杀毒软件可能会误报,需要添加白名单 -3. 配置集成文件 +### macOS 安装方法 - 在您的主目录下创建配置文件 `~/.claude-code-router/config.json`, 并在 `api_key` 处替换为您的访问令牌: +**方法一:官网下载(推荐)** - ```json showLineNumbers title="config.json" - { - "Providers": [ - { - "name": "gitee", +1. 打开浏览器访问 https://nodejs.org/ +2. 点击 "LTS" 版本进行下载 +3. 下载完成后双击 .pkg 文件 +4. 按照安装向导完成安装 - "api_base_url": "{{API_URL}}/v1/chat/completions", +**方法二:使用 Homebrew** - "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" - } - ``` +```bash +# 安装 Homebrew(如果尚未安装) +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -4. 启动集成服务 +# 使用 Homebrew 安装 Node.js +brew install node +``` - 通过我们的集成方案启动 Claude Code: +### Linux / WSL2 安装方法 - ```bash - ccr code - ``` +**使用包管理器安装** - ![](/img/serverless-api/integrated/claude-code-integrate.png) +Ubuntu/Debian: +```bash +# 更新包列表 +sudo apt update -5. 在 Claude Code 中使用模力方舟 +# 安装 Node.js 和 npm +sudo apt install nodejs npm +``` - 至此,开发者便可以在 Claude Code 中调用来自模力方舟的模型了。您还可以在开发过程中实时切换模型: +CentOS/RHEL/Fedora: +```bash +# 对于 CentOS/RHEL +sudo yum install nodejs npm - ``` - /model gitee,kimi-k2-instruct - ``` +# 对于 Fedora +sudo dnf install nodejs npm +``` - ![](/img/serverless-api/integrated/claude-code-checkout-model.png) +### 验证安装是否成功 -### 配置参数说明 +安装完成后,打开终端(Windows 使用 PowerShell),输入以下命令: -- **APIKEY** (可选): 设置密钥以验证请求 -- **PROXY_URL** (可选): 为 API 请求设置代理 -- **LOG** (可选): 启用日志记录,日志文件将位于 `$HOME/.claude-code-router.log` -- **HOST** (可选): 设置服务器的主机地址 +```bash +node --version +npm --version +``` -### 智能路由配置 +如果显示版本号,说明安装成功了! -路由配置定义了不同场景下使用的模型: +## 2. 安装 Claude Code -- **default**: 默认模型,如果没有配置其他路由,将用于所有请求 -- **background**: 后台任务使用的模型 -- **think**: 思考任务使用的模型 -- **longContext**: 长上下文任务使用的模型 +打开终端(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) -- Gitee From 79b1926c2b832ac68b2c90d1699e0cda65432ff8 Mon Sep 17 00:00:00 2001 From: franco <1787003204@q.comq> Date: Fri, 26 Sep 2025 10:54:02 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(integrations):=20=E6=9B=B4=E6=96=B0=20?= =?UTF-8?q?Claude=20Code=20=E5=AE=89=E8=A3=85=E4=B8=8E=E9=85=8D=E7=BD=AE?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/integrations/Development-Tools/claude-code.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/integrations/Development-Tools/claude-code.md b/docs/integrations/Development-Tools/claude-code.md index 7ad0fa1..39be567 100644 --- a/docs/integrations/Development-Tools/claude-code.md +++ b/docs/integrations/Development-Tools/claude-code.md @@ -32,6 +32,7 @@ scoop install nodejs ``` **Windows 注意事项** + - 建议使用 PowerShell 而不是 CMD - 如果遇到权限问题,尝试以管理员身份运行 - 某些杀毒软件可能会误报,需要添加白名单 @@ -60,6 +61,7 @@ brew install node **使用包管理器安装** Ubuntu/Debian: + ```bash # 更新包列表 sudo apt update @@ -69,6 +71,7 @@ sudo apt install nodejs npm ``` CentOS/RHEL/Fedora: + ```bash # 对于 CentOS/RHEL sudo yum install nodejs npm @@ -100,6 +103,7 @@ npm install -g @anthropic-ai/claude-code 这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。 **提示** + - Windows 用户建议使用 PowerShell 而不是 CMD,功能更强大 - 如果遇到权限问题,以管理员身份运行 PowerShell @@ -128,6 +132,7 @@ claude --version ### Windows (PowerShell) **临时设置(当前会话)** + ```powershell $env:ANTHROPIC_BASE_URL = "https://ai.gitee.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN = "你的API密钥" @@ -136,6 +141,7 @@ $env:ANTHROPIC_SMALL_FAST_MODEL = "GLM-4_5" ``` **永久设置(用户级)** + ```powershell # 设置用户级环境变量(永久生效) [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.gitee.com/anthropic", [System.EnvironmentVariableTarget]::User) @@ -147,6 +153,7 @@ $env:ANTHROPIC_SMALL_FAST_MODEL = "GLM-4_5" ### macOS / Linux / WSL2 **临时设置(当前会话)** + ```bash export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic" export ANTHROPIC_AUTH_TOKEN="你的API密钥" @@ -157,6 +164,7 @@ 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密钥" @@ -165,6 +173,7 @@ export ANTHROPIC_SMALL_FAST_MODEL="GLM-4_5" ``` 然后重新加载配置文件: + ```bash # 如果使用 bash source ~/.bashrc @@ -178,6 +187,7 @@ source ~/.zshrc ### 验证环境变量设置 **Windows (PowerShell)** + ```powershell echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN @@ -186,6 +196,7 @@ echo $env:ANTHROPIC_SMALL_FAST_MODEL ``` **macOS / Linux / WSL2** + ```bash echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN @@ -194,6 +205,7 @@ echo $ANTHROPIC_SMALL_FAST_MODEL ``` 预期输出示例: + ``` https://ai.gitee.com/anthropic 你的API密钥 @@ -215,6 +227,5 @@ claude ### 更多资源 - - [平台 API 文档](/docs/openapi/v1) - [Claude Code 官方文档](https://docs.anthropic.com/claude/docs) -- Gitee