2026 年ターミナル AI プログラミング実践：Claude Code + DeepSeek V4 完全チュートリアル + 設定ガイド

# macOS（Homebrew を使用）
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# インストール確認
node --version   # v18 以上が表示されるはず
npm --version

# グローバルインストール
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version

# DeepSeek 互換インターフェースのアドレス
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

# API Key（実際の Key に書き換えてください）
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-api-key

# メインモデル：DeepSeek V4 Pro（1M コンテキスト）
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]

# 軽量モデル：V4 Flash（サブタスクや高速推論向け）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

# 最大推論努力レベル
export CLAUDE_CODE_EFFORT_LEVEL=max

echo 'export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-api-key' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL=deepseek-v4-pro[1m]' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]' >> ~/.zshrc
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash' >> ~/.zshrc
echo 'export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash' >> ~/.zshrc
echo 'export CLAUDE_CODE_EFFORT_LEVEL=max' >> ~/.zshrc
source ~/.zshrc

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-deepseek-api-key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

cd /path/to/your-project
claude

# main.py
from fastapi import FastAPI, HTTPException, Depends
from pydantic import BaseModel, EmailStr
from typing import Optional
import sqlite3

app = FastAPI(title="User API")

# --- Models ---
class UserCreate(BaseModel):
    name: str
    email: EmailStr
    age: Optional[int] = None

class UserResponse(BaseModel):
    id: int
    name: str
    email: str
    age: Optional[int]

# --- Database Helper ---
def get_db():
    conn = sqlite3.connect("users.db")
    conn.row_factory = sqlite3.Row
    try:
        yield conn
    finally:
        conn.close()

# --- Routes ---
@app.get("/users", response_model=list[UserResponse])
def list_users(db: sqlite3.Connection = Depends(get_db)):
    rows = db.execute("SELECT * FROM users").fetchall()
    return [dict(row) for row in rows]

@app.post("/users", response_model=UserResponse, status_code=201)
def create_user(user: UserCreate, db: sqlite3.Connection = Depends(get_db)):
    cursor = db.execute(
        "INSERT INTO users (name, email, age) VALUES (?, ?, ?)",
        (user.name, user.email, user.age),
    )
    db.commit()
    return {"id": cursor.lastrowid, **user.model_dump()}

@app.get("/users/{user_id}", response_model=UserResponse)
def get_user(user_id: int, db: sqlite3.Connection = Depends(get_db)):
    row = db.execute("SELECT * FROM users WHERE id = ?", (user_id,)).fetchone()
    if not row:
        raise HTTPException(status_code=404, detail="User not found")
    return dict(row)

# テストを自動実行
pytest tests/ -v

# 失敗原因を分析、関連ソースコードを確認
cat src/utils.py
cat tests/test_utils.py

# バグ修正（ファイルを直接編集）
# ... 編集プロセス ...

# テストを再実行して検証
pytest tests/ -v

# CLAUDE.md

## プロジェクト規約
- Python 3.12+ を使用
- PEP 8 コードスタイルに準拠
- pytest でユニットテストを実施
- すべての関数に型アノテーション必須

## よく使うコマンド
- テスト実行：`pytest tests/ -v`
- コードフォーマット：`ruff format .`
- コードチェック：`ruff check .`

## アーキテクチャ
- src/ ディレクトリがメインのソースコード
- tests/ ディレクトリがテストコード
- データベースは SQLite を使用

export ANTHROPIC_BASE_URL=https://api.siliconflow.cn/v1
export ANTHROPIC_AUTH_TOKEN=sk-siliconflow-key
export ANTHROPIC_MODEL=deepseek-ai/DeepSeek-V4