邀请好友，获取免费 Tokens！了解更多

🪄 Claude Code 接入 CodingPlanX 自定义模型

> Claude Code 是 Anthropic 推出的一款强大的 AI 编程助手，它能够直接嵌入您的终端，理解您的代码库，并与您无缝协作编写、重构和调试代码。 > > 本教程将指导您完成环境准备、工具安装以及针对 codingplanx.ai 代理接口的专属配置。

📋 系统要求

在开始之前，请确保您的系统满足以下最低要求：

  • Node.js：版本 >= 18.0
  • 操作系统：macOS、Linux、Windows (推荐使用 WSL)

🚀 快速开始

1. 安装 Node.js

> 💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，请直接跳过此步骤。

🍎 macOS 用户

建议通过 Homebrew 安装：

# 1. 安装 Xcode 命令行工具
sudo xcode-select --install

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

# 3. 通过 Homebrew 安装 Node.js
brew install node

# 4. 验证安装
node --version

🐧 Ubuntu / Debian 用户

使用 NodeSource 官方脚本安装 LTS 版本：

# 1. 下载并运行安装脚本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. 安装 Node.js
sudo apt-get install -y nodejs

# 3. 验证安装
node --version

🪟 Windows 用户

推荐使用 winget 命令行安装，或前往 Node.js 官网 下载安装包：

# 使用 winget 安装 Node.js LTS 版本
winget install OpenJS.NodeJS.LTS

# 验证安装 (安装后可能需要重启终端)
node --version

2. 安装 Claude Code

打开您的终端，使用 npm 全局安装 Claude Code：

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

# 验证是否安装成功
claude --version

(注：如果由于权限问题报错，macOS/Linux 用户可能需要使用 sudo npm install -g @anthropic-ai/claude-code)

3. 配置并开始使用

🔑 获取必要的配置信息

使用本服务，您需要准备以下两个环境变量：

配置项说明获取方式
ANTHROPIC_AUTH_TOKENAPI 认证令牌注册后在 API令牌 页面点击 添加令牌 获得（以 sk- 开头）
ANTHROPIC_BASE_URLAPI 服务地址固定填写：https://api.codingplanx.ai

> 📝 创建令牌时的建议设置： > - 名称：随意命名（如 claude-code-cli） > - 额度：设为无限额度 > - 分组：选择 Claude code专属 或 官转克劳德3及以上 > - 其他选项：保持默认设置即可

💻 启动 Claude Code

请根据您使用的操作系统和终端，选择对应的启动命令。请先进入您的项目目录：

cd your-project-folder

🟢 Linux / macOS (Bash/Zsh)

# 设置环境变量（当前终端生效）
export ANTHROPIC_AUTH_TOKEN="sk-您的实际令牌"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # 设置为 300 秒超时，防止长回答断连

# 启动 Claude Code
claude

🔵 Windows PowerShell

# 设置环境变量（当前终端生效）
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-您的实际令牌"
$env:API_TIMEOUT_MS = "300000"

# 启动 Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-您的实际令牌
set API_TIMEOUT_MS=300000

claude

> 💡 进阶提示：如果您不想每次都输入环境变量，可以将上述 export 语句添加到您的 ~/.bashrc 或 ~/.zshrc 文件中（Mac/Linux），或在 Windows 系统设置中添加永久环境变量。

⚙️ 初次运行配置向导

首次启动 claude 时，系统会引导您进行基础设置：

  1. 选择主题 (Theme) 👉 选择您喜欢的终端配色，按 Enter 确认。
  2. 安全须知 (Safety) 👉 阅读并确认安全提示，按 Enter。
  3. 终端配置 (Terminal) 👉 建议使用默认配置，按 Enter。
  4. 信任目录 (Trust) 👉 确认信任当前工作目录，按 Enter。

✨ 恭喜！ 当您看到输入提示符时，就可以开始与您的 AI 编程搭档对话了！尝试输入：“帮我解释一下这个项目的主要结构”。

❓ 常见问题解答 (FAQ)

Q: 遇到 Invalid API Key · Please run /login 错误？

A: 这表明 Claude Code 未成功读取到您的环境变量。请检查：

  1. 是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。
  2. 令牌格式是否正确（必须以 sk- 开头，不要包含多余的空格或引号）。
  3. 如果您配置了永久环境变量，请确保重启了终端使其生效。

Q: 为什么终端左下角显示 offline 状态？

A: Claude Code 默认通过 ping google.com 来判断网络状态。在国内网络环境下显示 offline 是正常现象，完全不影响您的正常使用和代码生成。

Q: 为什么让 Claude 浏览网页（Fetch）会失败？

A: Claude Code 在访问外部网页前，需要调用官方服务进行安全检查。如果您遇到 Fetch 失败：

  1. 请确保您的电脑具备稳定的国际互联网连接。
  2. 必要时，请开启终端全局代理（如 export https_proxy=...）。

Q: 请求时总是提示 fetch failed 或超时？

A: 通常是网络波动或代理转发引起的。解决方案：

  1. 检查是否正确设置了超时环境变量：API_TIMEOUT_MS=300000。
  2. 尝试更换您的本地代理节点。
  3. 按 Ctrl+C 退出当前会话，重新运行 claude 命令。

Q: 网页登录错误？

A: 如果在获取 Token 的网页端遇到异常，请尝试清除浏览器的 Cookie 缓存，或使用无痕模式重新登录 codingplanx.ai。

📌 注意事项

  • 🛡️ 接口说明：本站直接接入官方 Claude Code 转发服务，完美适配 CLI 工具。
  • 🚦 流量限制：当前配置仅支持 Claude Code 的 API 流量，不支持用于其他第三方客户端的普通 API 调用。
  • 🔒 安全警告：请妥善保管您的 API 令牌 (sk-...)，切勿将其硬编码在代码中或上传至公开的 GitHub 仓库。

🔗 相关链接