Setup Guide - 15code.com

⚡ Codex Setup Guide

OpenAI's official coding agent, supports GPT-5.3-Codex model

Install Node.js (skip if already installed)

MacOS / Linux

brew install node
# or
sudo apt install nodejs npm -y
node --version

Windows

winget install OpenJS.NodeJS.LTS
# or download from https://nodejs.org/

Install Codex

npm install -g @openai/codex
codex --version

💡 China users: npm install -g @openai/codex --registry=https://registry.npmmirror.com

Configure API (Key Step)

Get your API Key from 15code.com Dashboard

MacOS / Linux

export OPENAI_API_KEY=sk-your-api-key-here
export OPENAI_BASE_URL=https://cli.15code.com/v1
echo 'export OPENAI_API_KEY=sk-your-api-key' >> ~/.bashrc
echo 'export OPENAI_BASE_URL=https://cli.15code.com/v1' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

$env:OPENAI_API_KEY="sk-your-api-key-here"
$env:OPENAI_BASE_URL="https://cli.15code.com/v1"
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-key", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://cli.15code.com/v1", "User")

Test Connection

codex
codex "Create a hello.py file"

✅ If Codex starts working, configuration is successful!

⚠️ Keep your API Key private - never upload to GitHub or share with others

🤖 Claude Code Setup Guide

Anthropic's official CLI tool, supports Claude Sonnet 4.6

Install Node.js 18+ (and Git Bash on Windows)

macOS

brew install node

Linux

sudo apt install nodejs npm -y

Windows — install both Node.js + Git for Windows

Claude Code needs a bash shell at runtime (it invokes bash for file edits, command execution). On Windows that's provided by Git Bash. npm install works in PowerShell/CMD, but running claude requires Git Bash.

Option A · Direct download (most reliable)

Node.js LTS → nodejs.org/en/download
Git for Windows (includes Git Bash) → git-scm.com/download/win
Accept defaults for both installers

Option B · winget

winget install OpenJS.NodeJS.LTS
winget install Git.Git

After install: Start menu → search Git Bash. Run all following commands in Git Bash.

Verify in Git Bash:

node --version
npm --version
git --version
bash --version

⚠️ Common pitfall: running claude from PowerShell/CMD fails with "bash: command not found" or tool execution errors. Use Git Bash.

Install Claude Code

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

🇨🇳 China users (mirror)

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

Configure environment variables

💡 Setting ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN tells Claude Code to use 15code directly — no OAuth login required, no --bare or similar flags.

Get your API key from 15code Dashboard.

macOS / Linux / Windows Git Bash

Replace sk-u-your-key with your real key, paste the whole block:

cat >> ~/.bashrc << 'EOF'
export ANTHROPIC_BASE_URL="https://claude.15code.com"
export ANTHROPIC_AUTH_TOKEN="sk-u-your-key"
export ANTHROPIC_API_KEY="sk-u-your-key"
EOF
source ~/.bashrc
claude

macOS: default shell is zsh — replace ~/.bashrc with ~/.zshrc (check with echo $SHELL)
Windows Git Bash: reads ~/.bashrc, use as-is
Linux: ~/.bashrc

⚠️ Windows users: make sure your terminal title is "MINGW64" or prompt is $ (not >). If not, close and open Git Bash instead.

⚠️ Why two token variables? Different Claude Code versions read different env names. Setting both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY covers all cases.

Start Claude Code

# Interactive mode (most common)
claude

# Pick a specific model
claude --model claude-opus-4-7     # top-tier flagship
claude --model claude-sonnet-4-6   # balanced

# One-shot / scriptable
claude -p "review this code" < main.py

# Help
claude --help

✅ If you see the > prompt and Claude responds — you're set.

⚠️ Troubleshooting

❌ "Not logged in" / OAuth errors

Check env vars (each line should print a value):

echo "$ANTHROPIC_BASE_URL $ANTHROPIC_AUTH_TOKEN $ANTHROPIC_API_KEY"

If you've run claude /login before, clear cached OAuth:

rm -rf ~/.claude/auth.json ~/.claude/credentials

Windows CMD: del "%USERPROFILE%\.claude\auth.json"

❌ 401 Unauthorized

New keys take 1-2s to propagate. If it persists after 10s, verify the key at Dashboard — not disabled, fully copied (starts with sk-u).

❌ Connection timeout

Test reachability:

curl -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" https://claude.15code.com/v1/models

⚡ Setup Guide

⚡ Codex Setup Guide

🤖 Claude Code Setup Guide

🎯 Cursor Setup Guide

📝 OpenCode Setup Guide