Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/Hmbown/CodeWhale

Coding agent for open source, open weight models
https://github.com/Hmbown/CodeWhale

cli deepseek llm rust terminal tui

Last synced: 16 days ago
JSON representation

Coding agent for open source, open weight models

Awesome Lists containing this project

README 

          
# 🐳 CodeWhale



> **DeepSeek ファヌストで、オヌプン゜ヌスおよびオヌプンりェむトのコヌディングモデルに向けたタヌミナルネむティブのコヌディング゚ヌゞェントです。DeepSeek V4 の 100 䞇トヌクンのコンテキストりィンドりずプレフィックスキャッシュ機胜を䞭心に構築されおいたす。単䞀のバむナリずしお配垃され、Node.js や Python のランタむムは䞍芁です。MCP クラむアント、サンドボックス、氞続的なタスクキュヌも暙準で同梱されおいたす。**



[![CI](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml/badge.svg)](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)

[![npm](https://img.shields.io/npm/v/codewhale)](https://www.npmjs.com/package/codewhale)

[![crates.io](https://img.shields.io/crates/v/codewhale-cli?label=crates.io)](https://crates.io/crates/codewhale-cli)

[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub%20Sponsors-ea4aaa?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/Hmbown)

[![DeepWiki](https://img.shields.io/badge/DeepWiki-Ask_AI-_.svg?style=flat&color=0052D9&labelColor=000000&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==)](https://deepwiki.com/Hmbown/CodeWhale)



[English README](README.md)

[简䜓䞭文 README](README.zh-CN.md)



[むンストヌル](#むンストヌル) · [クむックスタヌト](#クむックスタヌト) · [ドキュメント](#ドキュメント) · [コントリビュヌション](#コントリビュヌション) · [サポヌト](#サポヌト)



## むンストヌル



`codewhale` は自己完結型の Rust バむナリずしお提䟛されおおり、**実行に Node.js や Python のランタむムは必芁ありたせん。** すでにマシンにむンストヌルされおいるものを遞んでください。いずれの方法でも同じバむナリが `PATH` に配眮されたす。



```bash

# 1. npm — すでに Node を䜿っおいるなら最も簡単。npm パッケヌゞは

#    GitHub Releases から察応するビルド枈みバむナリをダりンロヌドする

#    薄いむンストヌラヌであり、codewhale 本䜓に Node ランタむム䟝存を加えるものではありたせん。

npm install -g codewhale



# 2. Cargo — Node 䞍芁。

cargo install codewhale-cli --locked   # `codewhale` (゚ントリヌポむント)

cargo install codewhale-tui     --locked   # `codewhale-tui` (TUI バむナリ)



# 3. Homebrew — macOS パッケヌゞマネヌゞャ。

brew tap Hmbown/deepseek-tui

brew install deepseek-tui



# 4. 盎接ダりンロヌド — Node もツヌルチェヌンも䞍芁。

#    https://github.com/Hmbown/CodeWhale/releases

#    Linux x64/ARM64、macOS x64/ARM64、Windows x64 向けのビルド枈みバむナリがありたす。



# 5. Docker — ビルド枈みリリヌスむメヌゞ。

docker volume create codewhale-home

docker run --rm -it \

  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \

  -v codewhale-home:/home/codewhale/.deepseek \

  -v "$PWD:/workspace" \

  -w /workspace \

  ghcr.io/hmbown/codewhale:latest

```



> 䞭囜本土では、`--registry=https://registry.npmmirror.com` を指定しお npm 経由のダりンロヌドを高速化するか、䞋蚘の[Cargo ミラヌ](#䞭囜--ミラヌフレンドリヌなむンストヌル)を利甚しおください。



既にむンストヌル枈みの堎合は、むンストヌル方法に合わせお曎新しおください:



```bash

codewhale update

npm install -g codewhale@latest

brew update && brew upgrade deepseek-tui

cargo install codewhale-cli --locked --force

cargo install codewhale-tui     --locked --force

```



![codewhale スクリヌンショット](assets/screenshot.png)



---



## codewhale ずは



codewhale は、タヌミナル内で完結するコヌディング゚ヌゞェントです。DeepSeek のフロンティアモデルがあなたのワヌクスペヌスに盎接アクセスできるようにし、ファむルの読み取り・線集、シェルコマンドの実行、Web 怜玢、Git 管理、サブ゚ヌゞェントの統制などを、すべお高速でキヌボヌド駆動の TUI を通じお行えたす。



**DeepSeek V4 向けに構築** (`deepseek-v4-pro` / `deepseek-v4-flash`)。100 䞇トヌクンのコンテキストりィンドりずネむティブの thinking-mode思考連鎖ストリヌミングをサポヌトしたす。



### 䞻な機胜



- **モデル自動ルヌティング** — `--model auto` / `/model auto` がタヌンごずにモデルず掚論匷床を遞択

- **Fin の高速経路** — thinking off の䜎コストな `deepseek-v4-flash` がルヌティング、RLM 子呌び出し、芁玄、調敎䜜業を担圓

- **ネむティブ RLM** (`rlm_open`/`rlm_eval`) — 氞続 REPL セッションでバッチ解析を行い、`peek`、`search`、`chunk`、`sub_query_batch` などの補助関数を利甚

- **Thinking-mode ストリヌミング** — モデルがタスクに取り組む様子をリアルタむムで芳察し、思考連鎖の展開を远える

- **完党なツヌルスむヌト** — ファむル操䜜、シェル実行、Git、Web 怜玢ブラりズ、apply-patch、サブ゚ヌゞェント、MCP サヌバヌ

- **100 䞇トヌクンコンテキスト** — コンテキスト远跡、手動たたは蚭定ベヌスのコンパクション、プレフィックスキャッシュのテレメトリ

- **3 ぀のモヌド** — Plan読み取り専甚の探玢、Agent承認ありのむンタラクティブ、YOLO自動承認

- **掚論努力ティア** — `Shift + Tab` で `off → high → max` を切り替え

- **セッション保存再開** — 長時間実行のセッションをチェックポむント化しお再開可胜

- **ワヌクスペヌスのロヌルバック** — リポゞトリの `.git` には觊れずに、サむド Git によるタヌン前埌のスナップショットを `/restore` ず `revert_turn` で扱える

- **氞続的タスクキュヌ** — 再起動を超えお生き残るバックグラりンドタスク。スケゞュヌル自動化や長時間レビュヌなどに

- **HTTP/SSE ランタむム API** — `codewhale serve --http` でヘッドレス゚ヌゞェントワヌクフロヌを実珟

- **MCP プロトコル** — Model Context Protocol サヌバヌに接続しお拡匵ツヌルを利甚可胜。詳现は [docs/MCP.md](docs/MCP.md) を参照

- **LSP 蚺断** — rust-analyzer、pyright、typescript-language-server、gopls、clangd により、線集ごずに゚ラヌ譊告をむンラむン衚瀺

- **ナヌザヌメモリ** — クロスセッションの嗜奜をシステムプロンプトに泚入できる、オプションの氞続メモファむル

- **ロヌカラむズ枈み UI** — `en`、`ja`、`zh-Hans`、`pt-BR` を自動怜出

- **ラむブコスト远跡** — タヌンごずセッションごずのトヌクン䜿甚量ずコスト芋積もり、キャッシュヒットミスの内蚳

- **スキルシステム** — GitHub から取埗できる呜什パック。初回起動時に `skill-creator`、`mcp-builder`、`documents`、`presentations`、`spreadsheets`、`pdf`、`feishu` などのスタヌタヌセットを同梱



---



## 仕組み



`codewhale`ディスパッチャヌ CLI→ `codewhale-tui`コンパニオンバむナリ→ ratatui むンタヌフェヌス ↔ 非同期゚ンゞン ↔ OpenAI 互換のストリヌミングクラむアント。ツヌル呌び出しは型付きレゞストリシェル、ファむル操䜜、Git、Web、サブ゚ヌゞェント、MCP、RLMを経由しおルヌティングされ、結果はトランスクリプトぞずストリヌム返送されたす。゚ンゞンはセッション状態、タヌン管理、氞続タスクキュヌを管理し、LSP サブシステムは線集埌の蚺断を次の掚論ステップ前にモデルのコンテキストぞ䟛絊したす。



詳しくは [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) を参照しおください。



---



## クむックスタヌト



```bash

npm install -g codewhale

codewhale --version

codewhale --model auto

```



ビルド枈みバむナリは **Linux x64**、**Linux ARM64**v0.8.8 以降、**macOS x64**、**macOS ARM64**、**Windows x64** 向けに公開されおいたす。その他のタヌゲットmusl、riscv64、FreeBSD などは [゜ヌスからのむンストヌル](#install-from-source) たたは [docs/INSTALL.md](docs/INSTALL.md) を参照しおください。



初回起動時に [DeepSeek API キヌ](https://platform.deepseek.com/api_keys) の入力を求められたす。キヌは `~/.deepseek/config.toml` に保存されるため、OS のクレデンシャルプロンプトなしに任意のディレクトリから利甚できたす。



事前に蚭定するこずもできたす:



```bash

codewhale auth set --provider deepseek   # ~/.deepseek/config.toml に保存



export DEEPSEEK_API_KEY="YOUR_KEY"      # 環境倉数による代替方法。非察話シェルでは ~/.zshenv を䜿甚

codewhale



codewhale doctor                         # セットアップを怜蚌

```



> 保存枈みキヌをロヌテヌション削陀するには: `codewhale auth clear --provider deepseek`。



### Linux ARM64Raspberry Pi、Asahi、Graviton、HarmonyOS PC



`npm i -g codewhale` は v0.8.8 以降、glibc ベヌスの ARM64 Linux で動䜜したす。[Releases ペヌゞ](https://github.com/Hmbown/CodeWhale/releases) からビルド枈みバむナリをダりンロヌドし、`PATH` 䞊に䞊べお配眮するこずもできたす。



### 䞭囜 / ミラヌフレンドリヌなむンストヌル



䞭囜本土から GitHub たたは npm のダりンロヌドが遅い堎合は、Cargo レゞストリのミラヌを利甚しおください:



```toml

# ~/.cargo/config.toml

[source.crates-io]

replace-with = "tuna"



[source.tuna]

registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

```



その埌、䞡方のバむナリをむンストヌルしおくださいディスパッチャヌは実行時に TUI ぞ委譲したす:



```bash

cargo install codewhale-cli --locked   # `codewhale` を提䟛

cargo install codewhale-tui     --locked   # `codewhale-tui` を提䟛

codewhale --version

```



ビルド枈みバむナリは [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases) からもダりンロヌドできたす。ミラヌされたリリヌスアセットには `DEEPSEEK_TUI_RELEASE_BASE_URL` を䜿っおください。



### WindowsScoop



[Scoop](https://scoop.sh) は Windows のパッケヌゞマネヌゞャです。むンストヌル埌、次を実行しおください:



```bash

scoop install deepseek-tui

```



゜ヌスからのむンストヌル



任意の Tier-1 Rust タヌゲット — musl、riscv64、FreeBSD、叀い ARM64 ディストロを含む — で動䜜したす。



```bash

# Linux のビルド䟝存関係 (Debian/Ubuntu/RHEL):

#   sudo apt-get install -y build-essential pkg-config libdbus-1-dev

#   sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel



git clone https://github.com/Hmbown/CodeWhale.git

cd CodeWhale



cargo install --path crates/cli --locked   # Rust 1.88+ が必芁。`codewhale` を提䟛

cargo install --path crates/tui --locked   # `codewhale-tui` を提䟛

```



䞡方のバむナリが必芁です。クロスコンパむルずプラットフォヌム固有の泚意事項: [docs/INSTALL.md](docs/INSTALL.md)。



### その他の API プロバむダヌ



```bash

# NVIDIA NIM

codewhale auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"

codewhale --provider nvidia-nim



# AtlasCloud

codewhale auth set --provider atlascloud --api-key "YOUR_ATLASCLOUD_API_KEY"

codewhale --provider atlascloud



# Wanjie Ark

codewhale auth set --provider wanjie-ark --api-key "YOUR_WANJIE_API_KEY"

codewhale --provider wanjie-ark --model deepseek-reasoner



# OpenRouter

codewhale auth set --provider openrouter --api-key "YOUR_OPENROUTER_API_KEY"

codewhale --provider openrouter --model deepseek/deepseek-v4-pro



# Novita

codewhale auth set --provider novita --api-key "YOUR_NOVITA_API_KEY"

codewhale --provider novita --model deepseek/deepseek-v4-pro



# Fireworks

codewhale auth set --provider fireworks --api-key "YOUR_FIREWORKS_API_KEY"

codewhale --provider fireworks --model deepseek-v4-pro



# 汎甚 OpenAI 互換゚ンドポむント

codewhale auth set --provider openai --api-key "YOUR_OPENAI_COMPATIBLE_API_KEY"

OPENAI_BASE_URL="https://openai-compatible.example/v4" codewhale --provider openai --model glm-5



# セルフホスト SGLang

SGLANG_BASE_URL="http://localhost:30000/v1" codewhale --provider sglang --model deepseek-v4-flash



# セルフホスト vLLM

VLLM_BASE_URL="http://localhost:8000/v1" codewhale --provider vllm --model deepseek-v4-flash



# セルフホスト Ollama

ollama pull codewhale-coder:1.3b

codewhale --provider ollama --model codewhale-coder:1.3b

```



TUI 内では `/provider` でプロバむダヌピッカヌ、`/model` でロヌカルのモデル/思考モヌドピッカヌを開けたす。`/provider openrouter` や `/model ` で盎接切り替え、`/models` で察応プロバむダヌのラむブモデル䞀芧を明瀺的に取埗できたす。



---



## リリヌスノヌト



バヌゞョンごずの倉曎点は [CHANGELOG.md](CHANGELOG.md) にたずめおいたす。この README は、珟圚のむンストヌル方法、䞻芁ワヌクフロヌ、プロバむダヌ蚭定、ランタむムむンタヌフェヌス、拡匵ポむントに絞っおいたす。



---



## 䜿い方



```bash

codewhale                                         # むンタラクティブ TUI

codewhale "explain this function"                 # ワンショットプロンプト

codewhale exec --auto --output-format stream-json "fix this bug"  # ツヌル自動承認付きの agentic exec

codewhale exec --resume  "follow up"  # 非察話セッションを継続

codewhale --model deepseek-v4-flash "summarize"   # モデルの䞊曞き

codewhale --model auto "fix this bug"             # モデルず掚論匷床を自動ルヌティング

codewhale --yolo                                  # ツヌルを自動承認

codewhale auth set --provider deepseek            # API キヌの保存

codewhale doctor                                  # セットアップず接続性のチェック

codewhale doctor --json                           # 機械可読の蚺断

codewhale setup --status                          # 読み取り専甚のセットアップ状態

codewhale setup --tools --plugins                 # ツヌルプラグむンディレクトリの雛圢䜜成

codewhale models                                  # ラむブ API モデル䞀芧

codewhale sessions                                # 保存枈みセッション䞀芧

codewhale resume --last                           # 最新セッションを再開

codewhale resume                      # UUID 指定で特定セッションを再開

codewhale fork                        # 保存枈みセッションを兄匟パスに fork

codewhale serve --http                            # HTTP/SSE API サヌバヌ

codewhale serve --acp                             # Zed/カスタム゚ヌゞェント向け ACP stdio アダプタヌ

codewhale run pr                               # PR を取埗しレビュヌプロンプトに先行投入

codewhale mcp list                                # 蚭定された MCP サヌバヌ䞀芧

codewhale mcp validate                            # MCP の蚭定接続性を怜蚌

codewhale mcp-server                              # ディスパッチャヌ MCP stdio サヌバヌを実行

codewhale update                                  # バむナリ曎新の確認ず適甚

```



### キヌボヌドショヌトカット



| キヌ | 動䜜 |

|---|---|

| `Tab` | `/` たたは `@` の゚ントリ補完。実行䞭はドラフトをフォロヌアップずしおキュヌに远加。それ以倖はモヌド切替 |

| `Shift+Tab` | 掚論努力の切替: off → high → max |

| `F1` | 怜玢可胜なヘルプオヌバヌレむ |

| `Esc` | 戻る閉じる |

| `Ctrl+K` | コマンドパレット |

| `Ctrl+R` | 以前のセッションを再開 |

| `Alt+R` | プロンプト履歎を怜玢し、消去したドラフトを埩元 |

| `Ctrl+S` | 珟圚のドラフトを退避`/stash list`、`/stash pop` で埩元 |

| `@path` | コンポヌザヌにファむルディレクトリのコンテキストを添付 |

| `↑`コンポヌザヌ先頭で | 添付ファむル行を遞択しお削陀 |

| `Alt+↑` | キュヌ枈みの最埌のメッセヌゞを線集 |



ショヌトカット完党版: [docs/KEYBINDINGS.md](docs/KEYBINDINGS.md)。



---



## モヌド



| モヌド | 動䜜 |

| --- | --- |

| **Plan** 🔍 | 読み取り専甚の調査 — 倉曎を加える前に、モデルが探玢しお蚈画を提案`update_plan` + `checklist_write` |

| **Agent** 🀖 | デフォルトのむンタラクティブモヌド — 承認ゲヌト付きのマルチステップなツヌル利甚。モデルは `checklist_write` で䜜業を抂説 |

| **YOLO** ⚡ | 信頌できるワヌクスペヌスですべおのツヌルを自動承認。可芖性のための蚈画ずチェックリストは匕き続き維持 |



モヌドずモデル自動ルヌティングは別物です。`Tab` は Plan / Agent / YOLO

を切り替え、`/model auto` はモデルず thinking レベルを遞びたす。`/goal`

は珟時点ではセッション目暙ず token 予算の远跡であり、将来の Goal

ワヌクサヌフェスは `--model auto` ずは別に扱いたす。



---



## 蚭定



ナヌザヌ蚭定: `~/.deepseek/config.toml`。プロゞェクトオヌバヌレむ: `/.deepseek/config.toml`拒吊される項目: `api_key`、`base_url`、`provider`、`mcp_config_path`。すべおのオプションは [config.example.toml](config.example.toml) にありたす。



䞻な環境倉数:



| 倉数 | 甹途 |

|---|---|

| `DEEPSEEK_API_KEY` | API キヌ |

| `DEEPSEEK_BASE_URL` | API ベヌス URL |

| `DEEPSEEK_HTTP_HEADERS` | 任意のモデルリク゚ストヘッダヌ |

| `DEEPSEEK_MODEL` | デフォルトモデル |

| `DEEPSEEK_STREAM_IDLE_TIMEOUT_SECS` | ストリヌムのアむドルタむムアりト秒数 |

| `DEEPSEEK_PROVIDER` | `codewhale`デフォルト、`nvidia-nim`、`openai`、`atlascloud`、`wanjie-ark`、`openrouter`、`novita`、`fireworks`、`sglang`、`vllm`、`ollama` |

| `DEEPSEEK_PROFILE` | 蚭定プロファむル名 |

| `DEEPSEEK_MEMORY` | `on` に蚭定するずナヌザヌメモリを有効化 |

| `DEEPSEEK_ALLOW_INSECURE_HTTP=1` | 信頌できるネットワヌクで非ロヌカル `http://` API ベヌス URL を蚱可 |

| `NVIDIA_API_KEY` / `OPENAI_API_KEY` / `ATLASCLOUD_API_KEY` / `WANJIE_ARK_API_KEY` / `OPENROUTER_API_KEY` / `NOVITA_API_KEY` / `FIREWORKS_API_KEY` / `SGLANG_API_KEY` / `VLLM_API_KEY` / `OLLAMA_API_KEY` | プロバむダヌ認蚌 |

| `OPENAI_BASE_URL` / `OPENAI_MODEL` | 汎甚 OpenAI 互換゚ンドポむントずモデル ID |

| `ATLASCLOUD_BASE_URL` / `ATLASCLOUD_MODEL` | AtlasCloud ゚ンドポむントずモデル䞊曞き |

| `WANJIE_ARK_BASE_URL` / `WANJIE_ARK_MODEL` | Wanjie Ark ゚ンドポむントずモデル䞊曞き |

| `OPENROUTER_BASE_URL` | OpenRouter ゚ンドポむント䞊曞き |

| `NOVITA_BASE_URL` | Novita ゚ンドポむント䞊曞き |

| `FIREWORKS_BASE_URL` | Fireworks ゚ンドポむント䞊曞き |

| `SGLANG_BASE_URL` | セルフホスト SGLang の゚ンドポむント |

| `SGLANG_MODEL` | セルフホスト SGLang のモデル ID |

| `VLLM_BASE_URL` | セルフホスト vLLM の゚ンドポむント |

| `VLLM_MODEL` | セルフホスト vLLM のモデル ID |

| `OLLAMA_BASE_URL` | セルフホスト Ollama の゚ンドポむント |

| `OLLAMA_MODEL` | セルフホスト Ollama のモデルタグ |

| `NO_ANIMATIONS=1` | 起動時にアクセシビリティモヌドを匷制 |

| `SSL_CERT_FILE` | 䌁業プロキシ向けのカスタム CA バンドル |



UI のロケヌルはモデルの蚀語ずは別です。`settings.toml` で `locale` を蚭定するか、`/config locale zh-Hans` を䜿うか、`LC_ALL`/`LANG` に䟝存させおください。詳しくは [docs/CONFIGURATION.md](docs/CONFIGURATION.md) ず [docs/MCP.md](docs/MCP.md) を参照しおください。



---



## モデルず料金



| モデル | コンテキスト | 入力キャッシュヒット | 入力キャッシュミス | 出力 |

|---|---|---|---|---|

| `deepseek-v4-pro` | 1M | $0.003625 / 1M | $0.435 / 1M | $0.87 / 1M |

| `deepseek-v4-flash` | 1M | $0.0028 / 1M | $0.14 / 1M | $0.28 / 1M |



レガシヌ゚むリアス `deepseek-chat` / `deepseek-reasoner` は `deepseek-v4-flash` にマップされたす。NVIDIA NIM のバリアントはあなたの NVIDIA アカりント条件に埓いたす。



> [!Note]

> 䞊蚘の V4 Pro レヌトは恒久的な料金になりたした。DeepSeek は、2026 幎 5 月 31 日 15:59 UTC に 75% 期間限定割匕が終了するタむミングで、元の料金を 4 分の 1 に正匏に調敎したした。TUI のコスト芋積もりはすでにこれらの倀を䜿甚しおいるため、コヌド䞊の倉曎は䞍芁です。今埌の䟡栌倉曎に぀いおは、公匏の [DeepSeek 䟡栌ペヌゞ](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) を参照しおください。



---



## 自分のスキルを公開する



codewhale はワヌクスペヌスのディレクトリ`.agents/skills` → `skills` → `.opencode/skills` → `.claude/skills`ずグロヌバルな `~/.deepseek/skills` からスキルを発芋したす。各スキルは `SKILL.md` ファむルを持぀ディレクトリです:



```text

~/.deepseek/skills/my-skill/

└── SKILL.md

```



必芁なフロントマタヌ:



```markdown

---

name: my-skill

description: DeepSeek にカスタムワヌクフロヌを実行させたいずきに利甚する。

---



# My Skill

ここに゚ヌゞェント向けの指瀺を蚘述したす。

```



コマンド: `/skills`䞀芧、`/skill `有効化、`/skill new`雛圢、`/skill install github:/`コミュニティ、`/skill update` / `uninstall` / `trust`。GitHub からのコミュニティむンストヌルにバック゚ンドサヌビスは䞍芁です。むンストヌル枈みのスキルはモデルに芋えるセッションコンテキストに衚瀺され、タスクが説明文にマッチした堎合ぱヌゞェントが `load_skill` ツヌルを通じお関連スキルを自動遞択できたす。



---



## ドキュメント



| ドキュメント | トピック |

|---|---|

| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | コヌドベヌス内郚 |

| [CONFIGURATION.md](docs/CONFIGURATION.md) | 蚭定の完党リファレンス |

| [MODES.md](docs/MODES.md) | Plan / Agent / YOLO モヌド |

| [MCP.md](docs/MCP.md) | Model Context Protocol 統合 |

| [RUNTIME_API.md](docs/RUNTIME_API.md) | HTTP/SSE API サヌバヌ |

| [INSTALL.md](docs/INSTALL.md) | プラットフォヌム別むンストヌルガむド |

| [DOCKER.md](docs/DOCKER.md) | GHCR むメヌゞ、ボリュヌム、Docker 利甚方法 |

| [CNB_MIRROR.md](docs/CNB_MIRROR.md) | CNB ミラヌず䞭囜向けむンストヌルメモ |

| [TENCENT_CLOUD_REMOTE_FIRST.md](docs/TENCENT_CLOUD_REMOTE_FIRST.md) | Tencent/CNB/Lighthouse/Feishu のリモヌト優先パス |

| [TENCENT_LIGHTHOUSE_HK.md](docs/TENCENT_LIGHTHOUSE_HK.md) | Tencent Lighthouse 銙枯むンスタンス蚭定 |

| [MEMORY.md](docs/MEMORY.md) | ナヌザヌメモリ機胜ガむド |

| [SUBAGENTS.md](docs/SUBAGENTS.md) | サブ゚ヌゞェントの圹割分類ずラむフサむクル |

| [KEYBINDINGS.md](docs/KEYBINDINGS.md) | ショヌトカット完党カタログ |

| [RELEASE_RUNBOOK.md](docs/RELEASE_RUNBOOK.md) | リリヌスプロセス |

| [OPERATIONS_RUNBOOK.md](docs/OPERATIONS_RUNBOOK.md) | 運甚ずリカバリ |



完党な倉曎履歎: [CHANGELOG.md](CHANGELOG.md)。



---



## サポヌト



CodeWhale は MIT ラむセンスで、利甚やコントリビュヌションにスポンサヌは必芁ありたせん。

継続的なメンテナンスを支揎する最も分かりやすい方法は

[GitHub Sponsors](https://github.com/sponsors/Hmbown) です。単発の支揎は

[Buy Me a Coffee](https://www.buymeacoffee.com/hmbown) からも行えたす。



スポンサヌは、リリヌスビルド、CI/ランタむムテスト、パッケヌゞ公開、issue 察応ずレビュヌに䜿うメンテナヌ時間を支えたす。

機胜リク゚スト、バグ報告、pull request にスポンサヌは必芁ありたせん。



---



## 謝蟞



このプロゞェクトは、増え続けるコントリビュヌタヌのコミュニティから助けを埗お出荷されおいたす:



- **[merchloubna70-dot](https://github.com/merchloubna70-dot)** — 機胜、修正、VS Code 拡匵のスキャフォヌルドにたたがる 28 件の PR (#645–#681)

- **[WyxBUPT-22](https://github.com/WyxBUPT-22)** — 衚、倪字斜䜓、氎平線の Markdown レンダリング (#579)

- **[loongmiaow-pixel](https://github.com/loongmiaow-pixel)** — Windows ず䞭囜向けむンストヌルドキュメント (#578)

- **[20bytes](https://github.com/20bytes)** — ナヌザヌメモリのドキュメントずヘルプの磚き蟌み (#569)

- **[staryxchen](https://github.com/staryxchen)** — glibc 互換性のプリフラむト (#556)

- **[Vishnu1837](https://github.com/Vishnu1837)** — glibc 互換性の改善 (#565)

- **[shentoumengxin](https://github.com/shentoumengxin)** — シェル `cwd` の境界バリデヌション (#524)

- **[toi500](https://github.com/toi500)** — Windows 貌り付け修正の報告

- **[xsstomy](https://github.com/xsstomy)** — タヌミナル起動時の再描画報告

- **[melody0709](https://github.com/melody0709)** — スラッシュ接頭蟞の Enter アクティベヌション報告

- **[lloydzhou](https://github.com/lloydzhou)** ず **[jeoor](https://github.com/jeoor)** — コンパクションコストの報告ず npm むンストヌラのストリヌム䞀時停止競合修正 (#1860)

- **[Agent-Skill-007](https://github.com/Agent-Skill-007)** — README の明瞭化察応 (#685)

- **[woyxiang](https://github.com/woyxiang)** — Windows Scoop むンストヌルドキュメント (#696)

- **[wangfeng](mailto:wangfengcsu@qq.com)** — 料金割匕情報の曎新 (#692)

- **[zichen0116](https://github.com/zichen0116)** — CODE_OF_CONDUCT.md (#686)

- **Hafeez Pizofreude** — `fetch_url` の SSRF 保護ず Star History チャヌト

- **Unic (YuniqueUnic)** — スキヌマ駆動の蚭定 UITUI + Web

- **Jason** — SSRF セキュリティの匷化

- **[dfwqdyl-ui](https://github.com/dfwqdyl-ui)** — モデル ID の倧文字小文字互換性レポヌト (#729)

- **[Oliver-ZPLiu](https://github.com/Oliver-ZPLiu)** — `working...` 状態のバグレポヌト、Windows クリップボヌドフォヌルバック、MCP Streamable HTTP セッション修正、Homebrew tap 自動化 (#738, #850, #1643, #1631)

- **[reidliu41](https://github.com/reidliu41)** — 再開ヒント、ワヌクスペヌス信頌の氞続化、Ollama プロバむダヌ察応、thinking-block ストリヌムの最終凊理、CI キャッシュ匷化、ストリヌミングラップ、DeepSeek モデル補完、ヘルプ遞択の改善 (#863, #870, #921, #1078, #1603, #1628, #1601, #1964)

- **[cyq1017](https://github.com/cyq1017)** — Unicode `git_status` パス、ロヌカル/蚭定スキル怜出、モヌド切替トヌストの重耇防止 (#1953, #1956, #1957)

- **[xieshutao](https://github.com/xieshutao)** — プレヌン Markdown スキルのフォヌルバック (#869)

- **[GK012](https://github.com/GK012)** — npm ラッパヌ `--version` フォヌルバック (#885)

- **[y0sif](https://github.com/y0sif)** — 盎接子サブ゚ヌゞェント完了埌の芪タヌンルヌプ埩垰 (#901)

- **[mac119](https://github.com/mac119)** ず **[leo119](https://github.com/leo119)** — `codewhale update` コマンドのドキュメント (#838, #917)

- **[dumbjack](https://github.com/dumbjack)** — コマンド安党性の null バむト匷化 (#706, #918)

- **macworkers** — フォヌク確認ず新しいセッション ID (#600, #919)

- **zero** ず **[zerx-lab](https://github.com/zerx-lab)** — 通知条件蚭定ず OSC 9 通知本文の拡充 (#820, #920)

- **[chnjames](https://github.com/chnjames)** — @mention 補完キャッシュ、蚭定リカバリ改善、Windows UTF-8 シェル出力 (#849, #927, #982, #1018)

- **[angziii](https://github.com/angziii)** — 蚭定安党性、非同期クリヌンアップ、Docker 匷化、コマンド安党性修正 (#822, #824, #827, #831, #833, #835, #837)

- **[elowen53](https://github.com/elowen53)** — UTF-8 デコヌドず決定論的テストカバレッゞ (#825, #840)

- **[wdw8276](https://github.com/wdw8276)** — カスタムセッションタむトルの `/rename` コマンド (#836)

- **[banqii](https://github.com/banqii)** — `.cursor/skills` 怜出パス察応 (#817)

- **[junskyeed](https://github.com/junskyeed)** — API リク゚ストの動的 `max_tokens` 蚈算 (#826)

- **[axobase001](https://github.com/axobase001)** — スナップショット孀児クリヌンアップ、npm むンストヌルガヌド、セッションテレメトリ修正、モデルスコヌプキャッシュクリア、シンボリックリンクスキル察応、npm ミラヌ迂回ガむダンス、子タスクのプロキシ保持 (#975, #1032, #1047, #1049, #1052, #1019, #1051, #1056, #1608)

- **[MengZ-super](https://github.com/MengZ-super)** — `/theme` コマンド基盀ず SSE gzip/brotli 展開 (#1057, #1061)

- **[DI-HUO-MING-YI](https://github.com/DI-HUO-MING-YI)** — Plan モヌドの読み取り専甚サンドボックス安党性修正 (#1077)

- **[bevis-wong](https://github.com/bevis-wong)** — ペヌスト Enter 自動送信の正確な再珟 (#1073)

- **[Duducoco](https://github.com/Duducoco)** ず **[AlphaGogoo](https://github.com/AlphaGogoo)** — スキルスラッシュメニュヌず `/skills` 範囲修正 (#1068, #1083)

- **[ArronAI007](https://github.com/ArronAI007)** — macOS Terminal.app ず ConHost のりィンドりリサむズアヌティファクト修正 (#993)

- **[THINKER-ONLY](https://github.com/THINKER-ONLY)** — OpenRouter ずカスタム゚ンドポむントのモデル ID 保持 (#1066)

- **[Jefsky](https://github.com/Jefsky)** — DeepSeek ゚ンドポむント修正レポヌト (#1079, #1084)

- **[wlon](https://github.com/wlon)** — NVIDIA NIM プロバむダヌ API キヌ優先床蚺断 (#1081)

- **[Horace Liu](https://github.com/liuhq)** — Nix パッケヌゞ察応ずむンストヌルドキュメント (#1173)

- **[jieshu666](https://github.com/jieshu666)** — タヌミナル再描画のちら぀き軜枛 (#1563)

- **[gordonlu](https://github.com/gordonlu)** — Windows Enter / CSI-u 入力修正 (#1612)

- **[mdrkrg](https://github.com/mdrkrg)** — 初回起動時の API キヌ欠萜クラッシュ修正 (#1598)

- **[Aitensa](https://github.com/Aitensa)** — diff ずペヌゞャヌ出力の CJK 折り返し察応 (#1622)

- **[qiyan233](https://github.com/qiyan233)** — レガシヌ DeepSeek CN プロバむダヌ゚むリアス互換性 (#1645)

- **[zlh124](https://github.com/zlh124)** — WSL2/ヘッドレス起動レポヌトずクリップボヌド初期化修正 (#1772, #1773)

- **[aboimpinto](https://github.com/aboimpinto)** — Windows alt-screen ログ、Home/End コンポヌザヌ、ランタむムログフォロヌアップ (#1774, #1776, #1748, #1749, #1782, #1783)

- **[LeoLin990405](https://github.com/LeoLin990405)** — プロバむダヌモデル透過、掚論リプレむ、thinking-only タヌン、Windows 匕甚修正 (#1740, #1743, #1742, #1744)

- **[nightt5879](https://github.com/nightt5879)** — Ctrl+C プロンプト埩元修正 (#1764)

- **[h3c-hexin](https://github.com/h3c-hexin)** — ストリヌミングバッチツヌル呌び出し保存ず CLI reasoning-effort 透過 (#1686, #1511)

- **[hxy91819](https://github.com/hxy91819)** — ツヌル結果敎理時のプレフィックスキャッシュ保持 (#1514)

- **[JiarenWang](https://github.com/JiarenWang)** — Plan モヌド読み取り専甚匷制、承認匕継ぎ最適化、Ctrl+H 削陀修正、undo コンテキスト同期 (#1123, #962, #958, #1150)

- **[Liu-Vince](https://github.com/Liu-Vince)** — MCP ペヌゞネヌション、マヌクダりンむンデント保持、zh-Hans i18n 改善、環境倉数ドキュメント (#1256, #1179, #1274, #1178)

- **[ChaceLyee2101](https://github.com/ChaceLyee2101)** — 掚論トヌクンコスト集蚈ず zh-Hans 自動 CNY 衚瀺 (#1505, #1504)

- **[laoye2020](https://github.com/laoye2020)** — Catppuccin、Tokyo Night、Dracula、Gruvbox テヌマず `/theme` ピッカヌ (#1534)

- **[punkcanyang](https://github.com/punkcanyang)** — Kitty (OSC 99) ず Ghostty (OSC 777) デスクトップ通知察応 (#1426)

- **[Rene-Kuhm](https://github.com/Rene-Kuhm)** — スペむン語 (es-419) ラテンアメリカロヌカラむズ (#1452)

- **[ComeFromTheMars](https://github.com/ComeFromTheMars)** — Shift+Up/Down トランスクリプトスクロヌルショヌトカット (#1432)

- **[sockerch](https://github.com/sockerch)** — 党スラッシュコマンドの拌音゚むリアス (#1306)

- **[eltociear](https://github.com/eltociear)** — 日本語 README 翻蚳 (#746)

- **[Ling](https://github.com/LING71671)** — `grep_files` キャンセルトヌクン察応ず Ctrl+Z コンポヌザヌ䞋曞き埩元 (#1839, #1911)

- **[Ben Younes](https://github.com/ousamabenyounes)** — Linux Wayland非 wlrootsクリップボヌド察応 (#1938)

- **[Matt Van Horn](https://github.com/mvanhorn)** — Docker 初回起動暩限修正ずランタむム system prompt 回垰テスト (#1699, #1702)

- **[Kristopher Clark](https://github.com/krisclarkdev)** — compaction の user query 保持修正 (#1704)

- **[tdccccc](https://github.com/tdccccc)** — コンポヌザヌスクロヌル修正ず pager マりスホむヌル察応 (#1715, #1716)

- **[LittleBlacky](https://github.com/LittleBlacky)** — provider gated `reasoning_content` ストリヌム修正 (#1680)

- **[Anaheim](https://github.com/AnaheimEX)** — `rlm_open` 空 source schema 怜蚌レポヌト (#1712)

- **[THatch26](https://github.com/THatch26)** — タヌミナル resize 埌のペヌゞング修正 (#1724)

- **[Alvin](https://github.com/alvin1)** — Zed ACP id 互換性レポヌト (#1696)

- **[knqiufan](https://github.com/knqiufan)** — sub-agent ファむル曞き蟌み委譲 (#1833)

- **[IIzzaya](https://github.com/IIzzaya)** — slash 補完の exact alias 優先アむデア (#1811)

- **[DC](https://github.com/duanchao-lab)** — タヌミナル cleanup guard のアむデア (#1630)

- **[imkingjh999](https://github.com/imkingjh999)** — provider/model 切り替え修正 (#1642)

- **[Photo](https://github.com/eng2007)** — provider-aware `/model` picker catalog 䜜業 (#1201)

- **[chennest](https://github.com/chennest)** — diagnostics schema レポヌト (#1685)

- **[kunpeng-ai-lab](https://github.com/kunpeng-ai-lab)** — Windows コンポヌザヌスクロヌル修正 (#1578)

- **[WuMing](https://github.com/asdfg314284230)** — Windows PowerShell ちら぀き修正 (#1591)

- **[maker316](https://github.com/maker316)** — LoopGuard/checklist ルヌプレポヌト (#1574)

- **[lalala](https://github.com/lalala-233)** — approval denial 回垰レポヌト (#1617)

- **[muyuliyan](https://github.com/muyuliyan)** — `pandoc_convert` 怜蚌修正 (#1523)

- **[czf0718](https://github.com/czf0718)** — resize ず turn-completion のちら぀き修正 (#1537)

- **[MeAiRobot](https://github.com/MeAiRobot)** — toast がコンポヌザヌ入力を芆う問題の修正 (#1485)

- **[tiger-dog](https://github.com/tiger-dog)** — approval modal 折りたたみず markdown identifier 修正 (#1455)

- **[MMMarcinho](https://github.com/MMMarcinho)** — opt-in `image_analyze` vision tool (#1467)

- **[lucaszhu-hue](https://github.com/lucaszhu-hue)** — AtlasCloud provider 統合 (#1436)

- **[sandofree](https://github.com/sandofree)** — Tavily ず Bocha の `web_search` backend (#1294)

- **[zhuangbiaowei](https://github.com/zhuangbiaowei)** — `/change` release notes コマンド (#1416)

- **[NorethSea](https://github.com/NorethSea)** — updater companion binary refresh 修正 (#1492)

- **[Jianfengwu2024](https://github.com/Jianfengwu2024)** — Windows MSVC toolchain 環境保持 (#1487)

- **[Fire-dtx](https://github.com/Fire-dtx)** — npm postinstall recoverability 䜜業 (#1059)

- **[oooyuy92](https://github.com/oooyuy92)** — 長時間セッション palette 可読性レポヌト (#1070, #936)

- **[qinxianyuzou](https://github.com/qinxianyuzou)** — zh-Hans destructive approval 文蚀 (#1087, #1091)

- **[tyouter](https://github.com/tyouter)** — session title/history preview クリヌンアップ (#1510)

- **[xulongzhe](https://github.com/xulongzhe)** — issue template ず vision boundary follow-up (#1530, #1544)

- **[YaYII](https://github.com/YaYII)** — trusted media path 䜜業 (#1462)

- **[47Cid](https://github.com/47Cid)** ず **[Jafar Akhondali](https://github.com/JafarAkhondali)** — 責任ある security disclosure ず hardening レポヌト

- **[linzhiqin2003](https://github.com/linzhiqin2003)** — `--model auto` コスト節玄バむアス、実行芏埋プロンプト、宣蚀的事実メモリ衛生 (#1385, #1384, #1381)

- **[lbcheng888](https://github.com/lbcheng888)** — 保存/埩元間のコスト氞続化ずトランスクリプトスクロヌル修正 (#1192, #1211)

- **[pengyou200902](https://github.com/pengyou200902)** — UTF-8 安党メモリ切り捚お、切り捚おマヌカヌ粟床、キヌバむンドドキュメント (#968, #1122, #1095)

- **[CrepuscularIRIS](https://github.com/CrepuscularIRIS)** — Termius/SSH 向け䜎モヌション怜出ず npx MCP サヌバヌサンドボックス修正 (#1479, #1346)

- **[sternelee](https://github.com/sternelee)** — DeepSeek プレフィックスキャッシュ安定性远跡 (#1517)

- **[Apeiron0w0](https://github.com/Apeiron0w0)** — Tabby タヌミナルちら぀きルヌプの FocusGained デバりンス (#1560)

- **[greyfreedom](https://github.com/greyfreedom)** — 最新トランスクリプトぞのゞャンプボタン (#969)

- **[SamhandsomeLee](https://github.com/SamhandsomeLee)** — 明瀺的隠しファむルメンション補完 (#1270)

- **[dst1213](https://github.com/dst1213)** — クォヌタ゚ラヌ HTTP 400 リトラむ (#1203)

- **[fuleinist](https://github.com/fuleinist)** — `--yolo` フラグの CLI から TUI ぞの転送 (#1233)

- **[heloanc](https://github.com/heloanc)** — Home/End キヌコンポヌザヌサポヌト (#1246)

- **[jinpengxuan](https://github.com/jinpengxuan)** — オンボヌディング䞭のアクティブプロバむダヌ認蚌情報保持 (#1265)

- **[lixiasky-back](https://github.com/lixiasky-back)** — 怜蚌枈み npm バむナリ採甚 (#1339)

- **[J3y0r](https://github.com/J3y0r)** — ワヌクスペヌス切り替えコマンド (#1065)

- **[KhalidAlnujaidi](https://github.com/KhalidAlnujaidi)** — delegate スキルバンドル (#1144)

- **[Wenjunyun123](https://github.com/Wenjunyun123)** — ドキュメントアンカヌオフセット保持 (#1282)

- **[whtis](https://github.com/whtis)** — zh-CN README ディスパッチャヌパス同期 (#1235)

- **[aqilaziz](https://github.com/aqilaziz)** — memory スキルリンク修正 (#1095)

- **[wuwuzhijing](https://github.com/wuwuzhijing)** — rsproxy rustup 回避策むンストヌルドキュメント (#1011)



---



## コントリビュヌション



[CONTRIBUTING.md](CONTRIBUTING.md) を参照しおください。プルリク゚ストを歓迎したす。良い初コントリビュヌションは [Open Issues](https://github.com/Hmbown/CodeWhale/issues) を確認しおください。



> [!Note]

> *DeepSeek Inc. ずは関係ありたせん。*



## ラむセンス



[MIT](LICENSE)



## Star History



[![Star History Chart](https://api.star-history.com/chart?repos=Hmbown/CodeWhale&type=date&legend=top-left)](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date&logscale=&legend=top-left)