/ Documentation

使用文档

选好系统，复制命令即可完成配置。支持 Claude Code、Gemini CLI、Codex、Droid CLI 等常见工具。

查询用量 CLI文档

一个 API Key 通用

按系统自动切换命令

复制粘贴直接开干

Tab 选择系统

本页所有命令会随系统切换自动更新。

选择系统

快速开始（Claude Code）

准备 API Key

在控制台的 API Keys 页面创建并复制你的 Key。请勿把 Key 公开到截图、仓库或日志中。注意：已有 key 则跳过此步骤。

安装 Node.js

Claude Code 需要 Node.js（推荐 LTS）。按当前系统使用下方命令/链接：

方法一：官网下载（推荐）

打开浏览器访问 https://nodejs.org/
点击 “LTS” 版本下载（推荐长期支持版本）
双击 .msi 安装包按向导完成安装（保持默认即可）

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

                            # 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs
                          

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

                            node --version

                            npm --version

如果显示版本号，说明安装成功。

方法一：使用 Homebrew（推荐）

                          # 如果还没安装 Homebrew，先安装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 使用 Homebrew 安装 Node.js
brew install node
                        

方法二：官网下载

打开浏览器访问 https://nodejs.org/
点击 “LTS” 版本下载
双击 .pkg 安装包完成安装

验证安装

打开终端，输入以下命令：

                            node --version

                            npm --version

Ubuntu/Debian

                          # 使用 NodeSource 仓库安装 LTS

                          curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

                          sudo apt-get install -y nodejs

Fedora/RHEL/CentOS

                          # 使用 NodeSource 仓库

                          curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

                          sudo dnf install -y nodejs

Arch Linux

sudo pacman -S nodejs npm

验证安装

                            node --version

                            npm --version

安装 Claude Code

在终端/PowerShell 执行：

                      # 全局安装 Claude Code

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

验证安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，说明 Claude Code 安装成功。

设置环境变量并启动

需要设置两个环境变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN。把 你的API密钥 替换为实际 Key，然后按当前系统执行下方命令：

方法一：PowerShell 临时设置（当前会话）

在 PowerShell 中运行：

$env:ANTHROPIC_AUTH_TOKEN = '你的API密钥'

提示：记得将 “你的API密钥” 替换为在控制台创建的实际密钥。

方法二：PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令设置用户级环境变量：

                          # 设置用户级环境变量（永久生效）

	                          [System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', '你的API密钥', [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

查看已设置的环境变量：

                        # 查看用户级环境变量

	                        [System.Environment]::GetEnvironmentVariable('ANTHROPIC_BASE_URL', [System.EnvironmentVariableTarget]::User)

	                        [System.Environment]::GetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', [System.EnvironmentVariableTarget]::User)

VSCode Claude 插件配置

配置文件位置：C:\\Users\\你的用户名\\.claude\\config.json

如果该文件不存在，请手动创建。

{ "primaryApiKey": "你的API密钥" }

验证环境变量

                            # PowerShell

                            echo $env:ANTHROPIC_BASE_URL

                            echo $env:ANTHROPIC_AUTH_TOKEN

                            # CMD

                            echo %ANTHROPIC_BASE_URL%

                            echo %ANTHROPIC_AUTH_TOKEN%

开始使用

claude

在特定项目中使用：

                          # 进入你的项目目录

                          cd C:\\path\\to\\your\\project

                          # 启动 Claude Code

                          claude

方法一：临时设置（当前终端会话）

export ANTHROPIC_AUTH_TOKEN='你的API密钥'

方法二：永久设置

编辑 shell 配置文件（按你使用的 shell）：

                          # 对于 zsh（macOS 默认）

                          nano ~/.zshrc

                          # 对于 bash

                          nano ~/.bash_profile

在文件末尾添加：

export ANTHROPIC_AUTH_TOKEN='你的API密钥'

保存后重新加载配置：

                          # 对于 zsh

                          source ~/.zshrc

                          # 对于 bash

                          source ~/.bash_profile

验证环境变量

                            echo $ANTHROPIC_BASE_URL

                            echo $ANTHROPIC_AUTH_TOKEN

开始使用

claude

方法一：临时设置

export ANTHROPIC_AUTH_TOKEN='你的API密钥'

方法二：永久设置

编辑 ~/.bashrc 或 ~/.zshrc：

nano ~/.bashrc

在文件末尾添加：

export ANTHROPIC_AUTH_TOKEN='你的API密钥'

重新加载配置：

source ~/.bashrc

验证环境变量

                            echo $ANTHROPIC_BASE_URL

                            echo $ANTHROPIC_AUTH_TOKEN

开始使用

claude

验证是否就绪

如果版本号能正常输出，说明环境 OK。

默认中转地址：

进阶设置

建议使用 PowerShell 的用户级环境变量，或者在系统环境变量里添加： ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN。

把 export 写到 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc / source ~/.bashrc 使其生效。

配置文件路径：

{ "primaryApiKey": "你的API密钥" }

其他工具（可选）

如果你除了 Claude Code 还想配置其他工具，按系统切换后直接复制对应环境变量即可。

Gemini CLI

Google Gemini 命令行工具

PowerShell 临时设置：

                  
                  $env:GEMINI_API_KEY = '你的API密钥'

                  $env:GEMINI_MODEL = 'gemini-2.0-flash-exp'

PowerShell 永久设置：

                  
	                  [System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', '你的API密钥', [System.EnvironmentVariableTarget]::User)

	                  [System.Environment]::SetEnvironmentVariable('GEMINI_MODEL', 'gemini-2.0-flash-exp', [System.EnvironmentVariableTarget]::User)

                  
                  export GEMINI_API_KEY='你的API密钥'

                  export GEMINI_MODEL='gemini-2.0-flash-exp'

Codex

OpenAI Codex / OpenAI 兼容工具

$env:OPENAI_API_KEY = '你的API密钥'

export OPENAI_API_KEY='你的API密钥'

Droid CLI

Factory.ai Droid 命令行工具

$env:DROID_API_KEY = '你的API密钥'

export DROID_API_KEY='你的API密钥'

常见问题

默认是 https://www.jojocode.org。如果你是私有定制部署的用户，部署了自己的域名/地址，把它替换成你的即可。

通常是 Key 写错、空格/引号问题，或环境变量未生效。先用上面的“验证是否就绪”检查版本与变量，再确认 Key 在控制台处于启用状态。